SDK iOS 統合
このリファレンス記事では、Unity プラットフォームのiOS SDKインテグレーションについて説明します。Braze を Unity アプリケーションで実行するには、以下の手順に従ってください。
手動統合から移行する場合は、自動統合の手順をお読みください。
ステップ1:Braze Unity パッケージの選択
Braze .unitypackage
は、Android プラットフォームと iOS プラットフォーム向けのネイティブバインディングを C# インターフェイスとともにバンドルします。
Braze Unity パッケージは、次の2種類の統合オプションを使用して、Braze Unity リリースページでダウンロードできます。
Appboy.unitypackage
のみ- このパッケージは、Braze Android と iOS SDK を追加の依存関係なしでバンドルします。この統合方法では、Braze アプリ内メッセージングと、iOS 上のコンテンツカード機能が適切に機能しません。カスタムコードなしで完全なBraze機能を使用する場合は、代わりに以下のオプションを使用してください。
- この統合オプションを使用する場合は、[Braze 構成] の下にある Unity UI で
Import SDWebImage dependency
の横にあるボックスにチェックマークが入れられていないことを確認してください。
SDWebImage
を含むAppboy.unitypackage
- この統合オプションは、Braze Android および iOS SDK と、iOS SDK の SDWebImage 依存関係をバンドルします。これは、Braze アプリ内メッセージングと、iOS 上のコンテンツカード機能を適切に機能させるために必要です。
SDWebImage
フレームワークは、GIF を含む画像のダウンロードと表示に使用されます。完全なBraze機能を使用する場合は、このパッケージを読み込むしてインポートします。 SDWebImage
を自動的にインポートするには、[Braze 構成] の下にある Unity UIでImport SDWebImage dependency
の横にあるボックスにチェックマークが入れられていることを確認してください。
- この統合オプションは、Braze Android および iOS SDK と、iOS SDK の SDWebImage 依存関係をバンドルします。これは、Braze アプリ内メッセージングと、iOS 上のコンテンツカード機能を適切に機能させるために必要です。
iOS:iOS プロジェクトのSDWebImage 依存関係が必要かどうかを確認するには、[iOS in-app message documentation] を参照してください。/docs/ja/developer_guide/platform_integration_guides/swift/in-app_messaging/overview/).
Android:Unity 2.6.0 以降、バンドルされた Braze Android SDK アーティファクトには AndroidX 依存関係が必要です。以前にjetified unitypackage
を使用していた場合は、対応するunitypackage
に安全に移行できます。
ステップ2:パッケージをインポートする
Unity エディターで Unity プロジェクトにパッケージをインポートするには、[アセット] > [パッケージをインポート] > [カスタムパッケージ] の順に移動します。次に、Importをクリックします。
または、カスタム Unity パッケージのインポートに関して詳しくは、Unity アセットパッケージのインポートの説明を参照してください。
iOS またはAndroid プラグインのみをインポートする場合は、Braze.unitypackage
をインポートするときにPlugins/Android
またはPlugins/iOS
サブディレクトリの選択を解除します。
ステップ3:API キーの設定
Braze は、Unity iOS 統合を自動化するためのネイティブ Unity ソリューションを提供しています。このソリューションは、Unity の PostProcessBuildAttribute
を使用してビルドされた Xcode プロジェクトを変更し、IMPL_APP_CONTROLLER_SUBCLASS
マクロを使用して UnityAppController
をサブクラス化します。
- Unity エディターで [Braze] > [Braze 構成] の順に移動して、[Braze 構成設定] を開きます。
- [Unity iOS 統合の自動化] ボックスにチェックマークを入れます。
- Braze API キー フィールドで、設定の管理 にあるアプリアプリケーションのAPI キーを入力します。
アプリですでに別の UnityAppController
サブクラスが使用されている場合、サブクラスの実装を AppboyAppDelegate.mm
とマージする必要があります。
基本的な SDK 統合の完了
これで、Braze はアプリケーションからデータを収集しており、基本的な統合は完了しているはずです。プッシュ統合の詳細については、次の記事を参照してください。AndroidとiOS、アプリ内メッセージs、コンテンツカード。
高度なSDKインテグレーションオプションについては、高度なインプリメンテーションを参照してください。