Skip to content

Brazeラーニングコース開発者向けSDKの概要

Braze SDKの統合を開始する前に、正確に何を構築および統合するのかを疑問に思うかもしれません。また、ニーズに応じてSDKをより詳細にカスタマイズする方法に興味があるかもしれません。この記事は、SDKに関するすべての疑問を解決するのに役立ちます。

SDKの基本的な概要を探しているマーケターは、代わりにマーケター向けの概要をご覧ください。

Braze SDKを簡単に説明すると、次のとおりです。

  • ユーザーデータを収集し、統合ユーザープロファイルに同期します
  • セッションデータ、デバイス情報、プッシュトークンを自動的に収集します
  • マーケティングエンゲージメントデータとビジネスに固有のカスタムデータを取得します
  • プッシュ通知、アプリ内メッセージ、コンテンツカードメッセージングチャネルを強化します

以下の動画で、Braze SDKの統合の基本とコア機能について簡単に紹介しています。

アプリのパフォーマンス

Brazeがアプリのパフォーマンスに悪影響を及ぼすことはありません。

Braze SDKのフットプリントは非常に小さいです。手動のネットワーク制御が許可されるのに加え、ネットワークの品質に応じ、ユーザーデータをフラッシュするレートの自動変更が実行されます。SDKからのAPIリクエストを自動的にバッチ処理して、ネットワーク効率を常に最大化しながらデータが迅速にロギングされるようにします。最後に、各API呼び出し内でクライアントからBrazeに送信されるデータは非常に少量です。

SDKの互換性

Braze SDKは非常に円滑に動作し、アプリ内に存在する他のSDKに干渉しないよう設計されています。他のSDKとの互換性不足が原因と思われる問題が発生している場合は、Brazeサポートにお問い合わせください。

デフォルトの分析とセッション処理

最初に使用したアプリ、最後に使用したアプリ、合計セッション数、デバイスOSなど、特定のユーザーデータはSDKで自動的に収集されます。統合ガイドに従ってSDKを実装すると、このデフォルトデータ収集を利用できるようになります。このリストを確認することで、ユーザーに関する同じ情報を複数回保存しなくて済みます。セッション開始とセッション終了を除き、その他の自動的にトラッキングされるデータは、データポイント使用量にはカウントされません。

データのアップロードとダウンロード

Braze SDKでは、データ（セッション、カスタムイベントなど）がキャッシュされ、定期的にアップロードされます。データがアップロードされた後でのみ、ダッシュボード上で値が更新されます。アップロード間隔は、デバイスの状態を考慮し、ネットワーク接続の品質に基づいて決定されます。

ネットワーク接続がない場合、ネットワーク接続が再確立されるまで、データはデバイスのローカルにキャッシュされます。接続が再確立されると、データがBrazeにアップロードされます。

セッションの時点でユーザーが属するSegmentsに基づいて、セッションの開始時にBrazeからSDKにデータが送信されます。新しいアプリ内メッセージはセッション中に更新されません。ただし、セッション中のユーザーデータは、クライアントから送信されると継続的に処理されます。たとえば、離脱ユーザー（アプリを最後に使用してから7日以上経過）には、アプリに戻ってから最初のセッションで、離脱ユーザーをターゲットにしたコンテンツが提供されます。

データ収集のブロック

SDK統合からの特定のデータの自動収集をブロックしたり、そのプロセスを許可リストに登録したりすることは（推奨はされませんが）可能です。

分析データを削除すると、プラットフォームのパーソナライゼーションとターゲット設定の能力が低下するため、データ収集をブロックすることは推奨されません。以下はその例です。

  • いずれかのSDKで位置情報を完全に統合しないことを選択した場合、言語や位置情報に基づいてメッセージングをパーソナライズできません。
  • タイムゾーンを統合しないことを選択した場合、ユーザーのタイムゾーン内でメッセージを送信できない可能性があります。
  • 特定のデバイスビジュアル情報を統合しないことを選択した場合、メッセージのコンテンツがそのデバイス向けに最適化されない可能性があります。

製品の機能を最大限に活用するには、SDKを完全に統合することを強くお勧めします。

SDKの特定の部分を統合しないことも、ユーザーに対してdisableSDKを使用することもできます。このメソッドにより、disableSDK()の呼び出し前にロギングされたデータが同期され、このページと将来のページの読み込みに対するその後のBraze Web SDKの呼び出しはすべて無視されます。後の時点でデータ収集を再開するには、enableSDK()メソッドを使用できます。この詳細については、Webトラッキングの無効化に関する記事をご覧ください。

setDeviceObjectAllowlistを使用し、設定された許可リストに従ってデバイスオブジェクトのキーまたは値のサブセットのみを送信するようSDKを構成できます。これはsetDeviceObjectAllowlistEnabledを介して有効にする必要があります。

Braze.Configurationで対象となるフィールドのセットをconfiguration.devicePropertyAllowListに割り当て、SDKで収集されるデバイスフィールドの許可リストを指定することができます。フィールドの完全なリストはBraze.Configuration.DevicePropertyで定義されます。すべてのデバイスフィールドの収集をオフにするには、このプロパティの値を空のセット ([]) に設定します。

使用の詳細については、Swift SDKドキュメントの「ストレージ」を参照してください。

使用しているSDKバージョンの確認

ダッシュボードを使用して、[設定] > [アプリ設定] から特定のアプリのSDKバージョンを確認できます。[ライブSDKバージョン] には、ユーザーの5%以上を対象とする最新のライブアプリケーションで使用されている最上位のBraze SDKバージョンが表示されます。

ワークスペースのSwiftyという名前のアプリ。ライブSDKバージョンは6.6.0です。
New Stuff!