SDKによるデータ収集
Braze SDKをお客様のアプリやサイトと連携すると、Brazeは特定タイプのデータを自動的に収集します。このデータには、当社のプロセスに必須のものと、お客様が必要に応じてオン/オフを切り替えられるものがあります。セグメンテーションやメッセージングをさらに強化するために、Brazeを設定して追加タイプのデータを収集することもできます。
Brazeは、柔軟にデータ収集ができるように設計されています。このため、Braze SDKを次のように連携できます。
- 最小限の連携: Brazeは、Brazeサービスと通信するために必要なデータを自動的に収集します。
- デフォルトで収集されるオプションのデータ: Brazeは、お客様のほとんどのユースケースで広く役立つデータを自動的に取得します。Brazeサービスとの通信に必要でない場合は、このデータの自動収集を無効にできます。
- デフォルトで収集されないオプションデータ: Brazeは、特定のユースケースにとって有用なデータを取得しますが、広範なコンプライアンス上の理由から、収集が自動的に有効になることはありません。ユースケースに適している場合にはこのデータを収集することを選択できます。
- パーソナライズされた連携: Brazeでは、デフォルトのオプションデータに加えて、データを柔軟に収集できます。
最小限のインテグレーション
以下は、SDKを初期化する際にBrazeが生成および受信する、厳密に必要なデータの一覧です。このデータは設定変更不可であり、コアプラットフォーム機能に不可欠です。セッション開始とセッション終了を除き、その他の自動的にトラッキングされるデータはデータポイント使用量にカウントされません。
| 属性 | 説明 | 収集される理由 |
|---|---|---|
| App-Version-Name / App-Version-Code |
最新のアプリバージョン | この属性は、アプリバージョンの互換性に関連するメッセージを適切なデバイスに送信するために使用されます。サービスの中断やバグをユーザーに通知するために使用できます。 |
| 国 | IPアドレスのジオロケーションで特定された国。IPアドレスのジオロケーションが利用できない場合は、デバイスロケールで特定されます。この値は、SDKがsetCountryで直接設定したものに代わる場合もありますが、SDKまたはAPIを通じて属性値を渡すとデータポイントが記録されることに注意してください。国がSDKメソッド、REST API、またはCSVアップロードを通じて手動で設定された後は、SDKはこの値を自動的に更新しなくなります。 |
この属性は、位置情報に基づいてメッセージをターゲティングするために使用されます。 |
| デバイスID | デバイス識別子、ランダムに生成された文字列 | この属性は、ユーザーのデバイスを区別し、適切なデバイスにメッセージを送信するために使用されます。 |
| OSおよびOSバージョン | 現在報告されているデバイスまたはブラウザーとデバイスまたはブラウザーのバージョン | この属性は、互換性のあるデバイスにのみメッセージを送信するために使用されます。また、セグメンテーション内でアプリバージョンのアップグレードをユーザーにターゲティングするためにも使用できます。 |
| セッション開始とセッション終了 | ユーザーがインテグレーションされたアプリまたはサイトの使用を開始した時点 | Braze SDKは、Brazeダッシュボードがユーザーエンゲージメントやユーザーの理解に不可欠なその他の分析を計算するために使用するセッションデータを報告します。アプリまたはサイトによるセッション開始とセッション終了の呼び出しタイミングは、開発者が設定可能です（Android、iOS、Web）。 |
| SDKメッセージインタラクションデータ | プッシュの直接開封、アプリ内メッセージのインタラクション、Content Cardsのインタラクション | この属性は、メッセージが受信されたことの確認や送信の重複がないことの確認など、品質管理の目的で使用されます。 |
| SDKバージョン | 現在のSDKバージョン | この属性は、互換性のあるデバイスにのみメッセージを送信し、サービスの中断を回避するために使用されます。 |
| セッションIDとセッションタイムスタンプ | セッション識別子、ランダムに生成された文字列とセッションタイムスタンプ | ユーザーが新しいセッションを開始しているか既存のセッションを継続しているかを判断し、このユーザーに対するメッセージの再適格性を判断するために使用されます。 アプリ内メッセージやContent Cardsなどの特定のメッセージングチャネルは、セッション開始時にデバイスに同期されます。その後、バックエンドは最後にBrazeサーバーに接続した時点に関連するデータ（デバイスが保存して送り返すもの）を使用して、ユーザーが新しいメッセージの対象かどうかを判断します。 |
計算指標
Brazeは、SDKトラッキングデータ（例：セッション開始とセッション終了）、非SDKチャネルのメッセージインタラクションデータ、およびBraze派生レポートフィールドの3つの入力から計算指標を生成します。これらの値はBrazeサービスによって生成されるため、ユーザープロファイルにはSDKトラッキングデータとBraze生成データの両方が含まれる場合があります。
計算指標には、チャネルベースの指標（レポート指標用語集に記載）と以下の属性が含まれます。
| 属性 | 説明 |
|---|---|
| 最初にアプリを使用した日時 | 時間 |
| 最後にアプリを使用した日時 | 時間 |
| 合計セッション数 | 数値 |
| クリックされたカード | 数値 |
| 最後にメッセージを受信した日時 | 時間 |
| 最後にメールキャンペーンを受信した日時 | 時間 |
| 最後にプッシュキャンペーンを受信した日時 | 時間 |
| フィードバック項目数 | 数値 |
| 過去Y日間のセッション数 | 数値と時間 |
| キャンペーンからメッセージを受信した | ブール値。このフィルターは、以前のキャンペーンを受信したかどうかに基づいてユーザーをターゲティングします。 |
| タグ付きキャンペーンからメッセージを受信した | ブール値。このフィルターは、現在タグが付いているキャンペーンを受信したかどうかに基づいてユーザーをターゲティングします。 |
| リターゲティングキャンペーン | ブール値。このフィルターは、過去に特定のメール、プッシュ、またはアプリ内メッセージを開封またはクリックしたかどうかに基づいてユーザーをターゲティングします。 |
| アンインストール済み | ブール値と時間 |
最小限のインテグレーションとは、最小限のインテグレーションに記載されている必要なデータのみを収集し、オプションのSDKデータ収集をブロックすることでデフォルトで収集されるオプションデータをオプトアウトすることを意味します。
最小限のインテグレーションを希望し、mParticle、セグメント、Tealium、またはGTMを使用している場合は、以下の点に注意してください。
- モバイルプラットフォーム: これらの設定のコードを手動で更新する必要があります。mParticleとセグメントは、それぞれのプラットフォームを通じてこれを行う方法を提供していません。
- Web: 最小限のインテグレーション設定を可能にするために、Brazeインテグレーションはネイティブで行う必要があります。タグマネージャーは、それぞれのプラットフォームを通じてこれを行う方法を提供していません。
デフォルトで収集されるオプションデータ
最小限のインテグレーションデータに加えて、SDKインテグレーションを初期化すると、以下の属性がBrazeによって自動的にキャプチャされます。これらの属性の収集をオプトアウトして、最小限のインテグレーションにすることができます。
| 属性 | プラットフォーム | 説明 | 収集される理由 |
|---|---|---|---|
| ブラウザ名 | Web | ブラウザの名前 | この属性は、互換性のあるブラウザにのみメッセージを送信するために使用されます。ブラウザベースのセグメンテーションにも使用できます。 |
| デバイスロケール | Android、iOS、Web | デバイスのデフォルトロケール | この属性は、ユーザーの優先言語にメッセージを翻訳するために使用されます。 |
| 最新のデバイスロケール | Android、iOS、Web | デバイスの最新のデフォルトロケール | この属性はユーザーのデバイス設定から取得され、ユーザーの優先言語にメッセージを翻訳するために使用されます。Most Recent Location 属性とは独立しています。 |
| デバイスモデル | Android、iOS | デバイスの特定のハードウェア | この属性は、互換性のあるデバイスにのみメッセージを送信するために使用されます。セグメンテーション内でも使用できます。 |
| デバイスブランド | Android | デバイスのブランド（例：Samsung） | この属性は、互換性のあるデバイスにのみメッセージを送信するために使用されます。 |
| デバイスワイヤレスキャリア | Android、iOS | モバイルキャリア | この属性は、オプションでメッセージターゲティングに使用されます。 注: このフィールドはiOS 16で非推奨となり、将来のiOSバージョンではデフォルトで -- になります。 |
| 言語 | Android、iOS、Web | デバイスロケールから取得されたデバイスまたはブラウザの言語 | この属性は、ユーザーの優先言語にメッセージを翻訳するために使用されます。デバイスロケールに基づいています。 |
| 通知設定 | Android、iOS、Web | このアプリでプッシュ通知が有効かどうか | この属性は、プッシュ通知を有効にするために使用されます。 |
| 解像度 | Android、iOS、Web | デバイスまたはブラウザの解像度 | オプションでデバイスベースのメッセージターゲティングに使用されます。この値の形式は「<width>x<height>」です。 |
| タイムゾーン | Android、iOS、Web | デバイスまたはブラウザのタイムゾーン | この属性は、各ユーザーのローカルタイムゾーンに応じて適切な時間にメッセージを送信するために使用されます。 |
| ユーザーエージェント | Web | ユーザーエージェント | この属性は、互換性のあるデバイスにのみメッセージを送信するために使用されます。セグメンテーション内でも使用できます。 |
デバイスレベルのプロパティ（デバイスワイヤレスキャリア、タイムゾーン、解像度など）のトラッキングについて詳しくは、プラットフォーム固有のドキュメントを参照してください：Android、iOS、Web。
デフォルトで収集されないデータ
デフォルトでは、以下の属性は収集されません。各属性は手動で統合する必要があります。
| 属性 | プラットフォーム | 説明 | 収集されない理由 |
|---|---|---|---|
| デバイス広告トラッキング有効 | Android、iOS | iOSの場合:set(adTrackingEnabled:)Androidの場合: Braze.setGoogleAdvertisingId() |
このプロパティにはアプリレベルの追加権限が必要であり、インテグレーターによって付与される必要があります。 |
| デバイスIDFA | iOS | 広告主向けデバイス識別子 | これにはAd Tracking Transparencyフレームワークが必要であり、App Storeからの追加のプライバシー審査が発生します。詳細については、set(identifierForAdvertiser:)を参照してください。 |
| Google広告ID | Android | Google Playアプリ内の広告用識別子 | これにはアプリがGAIDを取得してBrazeに渡す必要があります。詳細については、オプションのGoogle広告IDを参照してください。 |
| 最新の位置情報 | Android、iOS | ユーザーのデバイスの最後に確認されたGPS位置情報です。セッション開始時に更新され、ユーザーのプロファイルに保存されます。 | ユーザーがアプリに位置情報の権限を付与する必要があります。 |
Braze SDKはIPアドレスをローカルに保存しません。
パーソナライズされたインテグレーション
Brazeを最大限に活用するために、SDK インテグレーターは多くの場合、自動的に収集されるデータに加えて、Braze SDKを実装し、ビジネスに関連するカスタム属性、カスタムイベント、および購入イベントを記録します。
パーソナライズされたインテグレーションにより、ユーザーの体験に関連するカスタマイズされたコミュニケーションが可能になります。
Brazeは、セッション数が5,000,000を超えるユーザー（「ダミーユーザー」）をバンまたはブロックし、そのSDKイベントの取り込みを停止します。詳細については、スパムブロック を参照してください。