開発者向けSDKの概要
Braze SDKの統合を開始する前に、正確に何を構築および統合するのかを疑問に思うかもしれません。また、ニーズに応じてSDKをより詳細にカスタマイズする方法に興味があるかもしれません。この記事は、SDKに関するすべての疑問を解決するのに役立ちます。
SDKの基本的な概要を探しているマーケターは、代わりにマーケター向けの概要をご覧ください。
Braze SDKを簡単に説明すると、次のとおりです。
- ユーザーデータを収集し、統合ユーザープロファイルに同期します
- セッションデータ、デバイス情報、プッシュトークンを自動的に収集します
- マーケティングエンゲージメントデータとビジネスに固有のカスタムデータを取得します
- プッシュ通知、アプリ内メッセージ、コンテンツカードメッセージングチャネルを強化します
以下の動画で、Braze SDKの統合の基本とコア機能について簡単に紹介しています。
アプリのパフォーマンス
Brazeがアプリのパフォーマンスに悪影響を及ぼすことはありません。
Braze SDKは非常に軽量に設計されています。ネットワークの品質に応じてユーザーデータのフラッシュレートを自動的に変更するほか、手動によるネットワーク制御も可能です。SDKからのAPIリクエストを自動的にバッチ処理することで、最大限のネットワーク効率を維持しながら迅速にデータを記録します。さらに、各API呼び出しでクライアントからBrazeに送信されるデータ量は非常に小さくなっています。
SDKの互換性
Braze SDKは、非常に行儀よく動作し、アプリ内の他のSDKに干渉しないように設計されています。他のSDKとの非互換性が原因と思われる問題が発生した場合は、Brazeサポートにお問い合わせください。
デフォルトの分析とセッション処理
特定のユーザーデータはSDKによって自動的に収集されます。例えば、アプリの初回使用日、アプリの最終使用日、合計セッション数、デバイスOSなどです。統合ガイドに従ってSDKを実装すると、このデフォルトのデータ収集を活用できます。このリストを確認することで、ユーザーに関する同じ情報を重複して保存することを避けられます。セッション開始とセッション終了を除き、自動的にトラッキングされるその他すべてのデータはデータポイント使用量にカウントされません。
データのアップロードとダウンロード
Braze SDKはデータ（セッション、カスタムイベントなど）をキャッシュし、定期的にアップロードします。データがアップロードされて初めて、ダッシュボード上の値が更新されます。アップロード間隔はデバイスの状態を考慮し、ネットワーク接続の品質によって制御されます。
| ネットワーク接続品質 | データフラッシュ間隔 |
|---|---|
| 良好 | 10秒 |
| 普通 | 30秒 |
| 不良 | 60秒 |
ネットワーク接続がない場合、データはネットワーク接続が再確立されるまでデバイス上にローカルにキャッシュされます。接続が再確立されると、データはBrazeにアップロードされます。
Brazeは、セッションの開始時に、そのセッション時点でユーザーが該当するセグメントに基づいてSDKにデータを送信します。新しいアプリ内メッセージはセッション中に更新されません。ただし、セッション中のユーザーデータは、クライアントから送信されるたびに継続的に処理されます。たとえば、休眠ユーザー（7日以上アプリを使用していないユーザー）は、アプリに戻った最初のセッションで休眠ユーザー向けのコンテンツを受け取ります。
データ収集のブロック
SDK統合から特定のデータの自動収集をブロックしたり、収集を行うプロセスを許可リストに登録したりすることは可能ですが、推奨されません。
データ収集のブロックは推奨されません。分析データを除去すると、プラットフォームのパーソナライゼーションやターゲティングの能力が低下するためです。例:
- いずれかのSDKでロケーションを完全に統合しない場合、言語やロケーションに基づいたメッセージングのパーソナライゼーションができなくなります。
- タイムゾーンを統合しない場合、ユーザーのタイムゾーンに合わせたメッセージ送信ができなくなる可能性があります。
- 特定のデバイスのビジュアル情報を統合しない場合、メッセージコンテンツがそのデバイスに最適化されない可能性があります。
製品の機能を最大限に活用するために、SDKを完全に統合することを強くお勧めします。
SDKの特定の部分を統合しないか、ユーザーに対してdisableSDKを使用できます。このメソッドはdisableSDK()が呼び出される前にログに記録されたデータを同期し、このページおよび将来のページ読み込みに対するBraze Web SDKへの後続のすべての呼び出しを無視します。後からデータ収集を再開する場合は、enableSDK()メソッドを使用してデータ収集を再開できます。詳細については、Webトラッキングの無効化の記事をご覧ください。
setDeviceObjectAllowlistを使用して、設定した許可リストに従ってデバイスオブジェクトのキーまたは値のサブセットのみを送信するようにSDKを構成できます。これはsetDeviceObjectAllowlistEnabledで有効にする必要があります。
空の許可リストを設定すると、デバイスデータはBrazeに一切送信されなくなります。
Braze.Configurationのconfiguration.devicePropertyAllowListに対象フィールドのセットを割り当てることで、SDKが収集するデバイスフィールドの許可リストを指定できます。フィールドの完全なリストはBraze.Configuration.DevicePropertyで定義されています。すべてのデバイスフィールドの収集を無効にするには、このプロパティの値を空のセット（[]）に設定します。
デフォルトでは、すべてのフィールドがBraze Swift SDKによって収集されます。一部のデバイスプロパティを削除すると、SDK機能が無効になる場合があります。
使用方法の詳細については、Swift SDKドキュメントのSpeicherを参照してください。
使用しているSDKのバージョンは？
ダッシュボードで特定のアプリのSDKバージョンを確認するには、設定 > アプリ設定にアクセスします。ライブSDKバージョンには、ユーザーの少なくとも5%が使用している最新のライブアプリケーションで使用されている最も高いBraze SDKバージョンが表示されます。
iOSアプリをお持ちの場合、ライブSDKバージョンが5.0.0以上であれば、レガシーのObjective-C iOS SDKではなくSwift SDKを使用していることを確認できます。5.0.0はSwift SDKの最初のリリースバージョンです。