高度な実装
このリファレンス記事では、Unityプラットフォームの高度なSDK実装について説明します。
Unityパッケージのカスタマイズ
提供されているスクリプトを使用して、Braze Unityパッケージをカスタマイズおよびエクスポートすることができます。
-
Braze Unity SDK GitHub プロジェクト をクローンします。
1
git clone git@github.com:braze-inc/braze-unity-sdk.git
braze-unity-sdk/scripts
ディレクトリから、./generate_package.sh
を実行してUnityパッケージをエクスポートします。generate_package.sh
の実行中はUnity を開いておく必要があります。- パッケージは
braze-unity-sdk/unity-package/
にエクスポートされます。 - Unityエディタで、Assets> Import Package> Custom Packageに移動して、希望するパッケージをUnityプロジェクトにインポートします。
- (オプション)インポートしないファイルの選択を解除します。
generate_package.sh
とAssets/Editor/Build.cs
にあるエクスポートスクリプトの両方を編集することで、エクスポートされたUnityパッケージをカスタマイズできます。
Prime 31の互換性
Prime31プラグインでBraze Unityプラグインを使用するには、プロジェクトのAndroidManifest.xml
を編集してPrime31互換アクティビティクラスを使用します。すべての参照を変更する
com.braze.unity.BrazeUnityPlayerActivity
からcom.braze.unity.prime31compatible.BrazeUnityPlayerActivity
Amazon ADM プッシュ
Brazeは、Amazon ADMプッシュをUnityアプリに統合することをサポートしています。Amazon ADM プッシュを統合する場合は、ADM API キーを含むapi_key.txt
というファイルを作成し、Plugins/Android/assets/
フォルダに配置します。 Amazon ADM とBraze の統合の詳細については、ADM プッシュ統合命令 を参照してください。
Android SDK の高度な実装オプション
Unityエディタでの詳細なロギングの有効化
Unityエディタで詳細ログを有効にするには、次の手順を実行します。
- Braze> Braze Configuration に移動して、Braze Configuration Settings を開きます。
- Show Braze Android Settingsドロップダウンをクリックします。
- SDK Log Levelフィールドに、値”0”を入力します。
Braze Unityプレーヤーの拡張(Android)
AndroidManifest.xml
ファイルの例では、BrazeUnityPlayerActivity
という1 つのActivity クラスが登録されています。このクラスは、Braze SDK と統合され、セッション処理、アプリ内メッセージ登録、プッシュ通知分析ロギングなどでUnityPlayerActivity
を拡張します。UnityPlayerActivity
クラスの拡張の詳細については、Unity を参照してください。
ライブラリまたはプラグインプロジェクトで独自のカスタムUnityPlayerActivity
を作成する場合は、BrazeUnityPlayerActivity
を拡張してカスタム機能をBraze に統合する必要があります。BrazeUnityPlayerActivity
の拡張作業を開始する前に、Braze をUnity プロジェクトに統合する手順に従ってください。
- Braze Android SDK を依存関係としてライブラリまたはプラグインプロジェクトに追加します(Braze Android SDK 統合手順 を参照)。
- Unity固有の機能を含むUnity
.aar
を、Unity用に構築しているAndroidライブラリプロジェクトに統合します。appboy-unity.aar
は、public repo から入手できます。Unityライブラリが正常に統合されたら、UnityPlayerActivity
を変更してBrazeUnityPlayerActivity
を拡張します。 - ライブラリまたはプラグインプロジェクトをエクスポートし、通常どおり
/<your-project>/Assets/Plugins/Android
にドロップします。Braze ソースコードは/<your-project>/Assets/Plugins/Android
にすでに存在するため、ライブラリまたはプラグインには含めないでください。 4./<your-project>/Assets/Plugins/Android/AndroidManifest.xml
を編集して、BrazeUnityPlayerActivity
サブクラスをメインアクティビティとして指定します。
これで、Brazeと完全に統合され、カスタムUnityPlayerActivity
機能を含むUnity IDEから.apk
をパッケージ化できるようになります。
iOS SDK の高度な実装オプション
Unityエディタでの詳細なロギングの有効化
Unityエディタで詳細ログを有効にするには、次の手順を実行します。
- Braze> Braze Configuration に移動して、Braze Configuration Settings を開きます。
- Show Braze iOS Settingsドロップダウンをクリックします。
- SDK Log Levelフィールドに、値”0”を入力します。
SDK (iOS) の拡張
SDK の動作を拡張するには、Braze Unity SDK GitHub プロジェクト をフォークして必要な変更を加えます。
変更したコードをUnityパッケージとしてパブリッシュするには、高度なユースケースを参照してください。
手動から自動統合(iOS)への移行
Braze Unity SDK で提供されている自動iOS 統合を活用するには、手動から自動統合に移行するときに次の手順を実行します。
- Xcode プロジェクトの
UnityAppController
サブクラスからすべての Braze 関連コードを削除します。 - UnityまたはXcodeプロジェクトから Braze iOSライブラリ(
Appboy_iOS_SDK.framework
やSDWebImage.framework
など)を削除し、 Braze UnityパッケージをUnityプロジェクトにインポートします。 - Unity を使用してAPI キーを設定するには、[ の統合手順に従ってください。