SDK アンドロイド統合
このリファレンス記事では、Unity プラットフォームの Android SDK インテグレーションについて説明しています。以下の手順に従って、お使いの Unity アプリケーションで Braze を実行してください。
ステップ 1:Braze ユニティパッケージをお選びください
Brazeには、.unitypackage
AndroidおよびiOSプラットフォーム用のネイティブバインディングとC#インターフェイスがバンドルされています。
Braze Unity のリリースページでは、いくつかの Braze Unity パッケージをダウンロードできます。
Appboy.unitypackage
- このパッケージには、Braze Android SDK と iOS SDK と iOS SDK のほか、Braze アプリ内メッセージングの適切な機能と iOS でのコンテンツカード機能の適切な機能に必要な iOS SDK の SDWebImage 依存関係がバンドルされています。SDWebImageフレームワークは、GIFを含む画像のダウンロードと表示に使用されます。Braze の全機能を利用したい場合は、このパッケージをダウンロードしてインポートしてください。
Appboy-nodeps.unitypackage
- このパッケージは、SDWebImage
Appboy.unitypackage
フレームワークが存在しない点を除いてと似ています。このパッケージは、SDWebImage フレームワークを iOS アプリに表示したくない場合に便利です。
- このパッケージは、SDWebImage
iOS:iOS プロジェクトに SDWebImage 依存関係が必要かどうかを確認するには、iOS アプリ内メッセージドキュメント を参照してください。
Android:Unity 2.6.0 以降、バンドルされている Braze Android SDK アーティファクトには AndroidX の依存関係が必要です。以前にを使用していた場合はjetified unitypackage
、対応するバージョンに安全に移行できますunitypackage
。
ステップ 2: パッケージをインポートする
Unity エディターで、「アセット」>「パッケージのインポート」>「カスタムパッケージ」に移動して、パッケージを Unity プロジェクトにインポートします。次に、[インポート] をクリックします。
または、Unity アセットパッケージのインポート手順に従って、カスタム Unity パッケージのインポートに関する詳細なガイドを参照してください。
iOS または Android プラグインのみをインポートする場合は、Braze Plugins/Android
Plugins/iOS
をインポートするときにまたはサブディレクトリの選択を解除してください。.unitypackage
ステップ 3: AndroidManifest.xml を更新中
Android Unity プロジェクトでは、アプリケーションを実行するにはが必要です。AndroidManifest.xml
さらに、Brazeが機能するにはいくつかの追加機能が必要です。AndroidManifest.xml
AndroidManifest.xml を設定する
アプリにがない場合はAndroidManifest.xml
、以下をテンプレートとして使用できます。それ以外の場合は、すでにセクションがある場合はAndroidManifest.xml
、次の欠落しているセクションのいずれかが既存のセクションに追加されていることを確認してくださいAndroidManifest.xml
。
```xml <?xml version=”1.0” encoding=”utf-8”?>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
> `AndroidManifest.xml``Assets/Plugins/Android/AndroidManifest.xml`お前は下に存在するはずだ詳細については、[Unity Androidマニフェストのドキュメントを参照してください](https://docs.unity3d.com/Manual/android-manifest.html)。
> `AndroidManifest.xml`ファイルに登録されているすべてのアクティビティクラスは、Braze Android SDKと完全に統合されている必要があります。独自の Activity クラスを追加する場合は、[Unity Activity の統合手順に従ってアナリティクスが収集されていることを確認する必要があります](#extending-braze-unity-player)。
<div class='alert alert-note' role='alert'><div class='alert-msg'> <b>note: </b><br />
<p>決勝戦には、<code class="language-plaintext highlighter-rouge">AndroidManifest.xml</code><code class="language-plaintext highlighter-rouge">"android.intent.category.LAUNCHER"</code>プレゼント付きのアクティビティが1つだけ含まれている必要があります。</p>
</div></div>
### AndroidManifest.xml をパッケージ名で更新してください
パッケージ名を確認するには、[**ファイル] > [ビルド設定] > [プレーヤー設定] > [Android] タブをクリックします**。
![\](/docs/ja/assets/img_archive/UnityPackageName.png?f672b49d7a69b2d915c7fef6571dac94)
で`AndroidManifest.xml`、`REPLACE_WITH_YOUR_PACKAGE_NAME``Package Name`のすべてのインスタンスを前のステップで作成したインスタンスに置き換える必要があります。
## ステップ 4: グラドル依存関係の追加 {#unity-android-gradle-configuration}
以下の依存関係が必要です。
\`\`\`groovy
実装「org.jetbrains.kotlin: kotlin-stdlib: 1.5.21"
実装「org.jetbrains.kotlinx: kotlinx-coroutines-android: 1.5.2"
//Android でデフォルトのコンテンツカードアクティビティを使用する場合は両方が必要です
実装「layout:androidx.スワイプリフレッシュスワイプリフレッシュ+」layout:
実装「アンドロイドxリサイクルビュー:リサイクルビュー:+」
\`\`\`
Unity を使用してこれらの依存関係を追加する方法の例を以下に示します。 tools:
##### [カスタム Gradle テンプレート](https://docs.unity3d.com/Manual/android-gradle-overview.html)
```groovy
dependencies {
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.5.21"
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2"
}
Unity の外部依存関係マネージャー
1
2
3
4
5
6
<dependencies>
<androidPackages>
<androidPackage spec="org.jetbrains.kotlin:kotlin-stdlib:1.5.21" />
<androidPackage spec="org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2" />
</androidPackages>
</dependencies>
ステップ 5: SDK を設定する
Braze は Unity Android との統合を自動化するためのネイティブ Unity ソリューションを提供しています。
- Unity エディターで、Braze > Braze 設定に移動して Braze 設定を開きます。
- 「Unity Android インテグレーションの自動化」ボックスをチェックしてください。
- Braze API キーフィールドに、Braze ダッシュボードの [設定の管理] にあるアプリケーションの API キーを入力します。
この自動統合は、プロジェクトの構築中に設定値が競合する可能性があるため、braze.xml
手動で作成したファイルでは使用しないでください。マニュアルが必要な場合はbraze.xml
、自動統合を無効にしてください。
## 基本的な SDK 統合の完了
これで、Braze はアプリケーションからデータを収集しており、基本的な統合は完了しているはずです。統合プッシュについて詳しくは、以下の記事をご覧ください。Android と iOS、アプリ内メッセージ、コンテンツカード
高度な SDK 統合オプションについては、「高度な実装」をご覧ください。