SDKによるデータ収集
Braze SDKをお客様のアプリやサイトと連携すると、Brazeは特定タイプのデータを自動的に収集します。このデータには、当社のプロセスに必須のものと、お客様が必要に応じてオン/オフを切り替えられるものがあります。セグメンテーションやメッセージングをさらに強化するために、Brazeを設定して追加タイプのデータを収集することもできます。
Brazeは、柔軟にデータ収集ができるように設計されています。このため、Braze SDKを次のように連携できます。
- 最小限の連携: Brazeは、Brazeのサービスと通信するために必要なデータを自動的に収集します。
- デフォルトで収集されるオプションのデータ: Brazeは、お客様のほとんどのユースケースで広く役立つデータを自動的に取得します。Brazeサービスとの通信に必要でない場合は、このデータの自動収集を無効にすることができます。
- デフォルトで収集されないオプションデータ: Brazeは、特定のユースケースにとって有用なデータを取得しますが、広範なコンプライアンス上の理由から、収集が自動的に有効になることはありません。ユースケースに適している場合にはこのデータを収集することを選択できます。
- パーソナライズされた連携: Brazeでは、デフォルトのオプションデータに加えて、データを柔軟に収集できます。
最小限の連携
以下に、SDKを初期化する際に、Brazeが生成して受信する厳密な必須データの一覧を示します。このデータは設定不可能であり、プラットフォームのコア機能に不可欠です。セッション開始とセッション終了を除き、その他の自動トラッキングデータはデータポイント使用量にカウントされません。
| 属性 | 説明 | 収集される理由 |
|---|---|---|
| アプリのバージョン名 / アプリのバージョンコード |
アプリの最新バージョン | この属性は、アプリのバージョン互換性に関連するメッセージを適切なデバイスに送信するために使用されます。サービスの中断やバグをユーザーに通知するために使用できます。 |
| 国 | IPアドレスのジオロケーションによって識別される国。IPアドレスの地理位置情報が使用できない場合は、デバイスロケールで識別されます。値は代わりに、SDKが setCountry で直接設定する値でも構いませんが、SDKやAPIを介して属性値を渡すと、データポイントがログに記録されることに注意してください。国が手動で設定された場合（SDKメソッド、REST API、またはCSVアップロードを通じて）、SDKはこの値を自動的に更新しなくなります。 |
この属性は、ロケーションに基づいてメッセージをターゲティングするために使用されます。 |
| デバイスID | デバイス識別子、ランダムに生成される文字列 | この属性は、ユーザーのデバイスを区別し、正しいデバイスにメッセージを送信するために使用されます。 |
| OSとOSバージョン | 現在レポートされているデバイスまたはブラウザと、デバイスまたはブラウザのバージョン | この属性は、互換性のあるデバイスにのみメッセージを送信するために使用されます。また、アプリのバージョンをアップグレードするユーザーをターゲットとするセグメンテーションにも使用できます。 |
| セッション開始とセッション終了 | ユーザーが連携されたアプリやサイトを使い始めるとき | Braze SDKでは、ユーザーエンゲージメントやユーザーの理解に不可欠なその他の分析を計算するため、Brazeダッシュボードで使用されるセッションデータがレポートされます。アプリやサイトからセッション開始とセッション終了が呼び出される正確なタイミングは、開発者が設定できます（Android、iOS、Web）。 |
| SDKメッセージインタラクションデータ | プッシュ直接開封数、アプリ内メッセージインタラクション数、コンテンツカードインタラクション数 | この属性は、メッセージが受信され、送信が重複していないことの確認など、品質管理の目的で使用されます。 |
| SDKバージョン | 現在のSDKバージョン | この属性は、互換性のあるデバイスにのみメッセージを送信し、サービスの中断を避けるために使用されます。 |
| セッションIDとセッションタイムスタンプ | セッション識別子、ランダムに生成された文字列とセッションのタイムスタンプ | ユーザーが新しいセッションを開始しているか、既存のセッションを継続しているかを判断し、このユーザー宛てのメッセージの再適格性を判断するために使用されます。 アプリ内メッセージやContent Cardsなどの特定のメッセージングチャネルは、セッションの開始時にデバイスに同期されます。そして、バックエンドは、最後にBrazeサーバーにコンタクトした時刻に関連するデータ（デバイスが保存して送り返す）を使って、ユーザーが新しいメッセージを受け取る資格があるかどうかを判断します。 |
計算された指標
Brazeは、SDKデータ、非SDKメッセージに関連するメッセージインタラクションデータ、および派生情報を計算して指標を生成します。わかりやすく言うと、この計算されたデータはSDKが追跡するものではなく、Brazeサービスによって生成されるデータであり、ユーザープロファイルには追跡されたデータと生成されたデータの両方が表示されます。
計算された指標には、チャネルベースの指標（レポート指標用語集に記載）と以下の属性が含まれます。
| 属性 | 説明 |
|---|---|
| 最初に使用したアプリ | 時刻 |
| 最後に使用したアプリ | 時刻 |
| 総セッション数 | 数値 |
| クリックされたカード | 数値 |
| 最後に受信したメッセージ | 時刻 |
| 最終受信メールキャンペーン | 時刻 |
| 最後に受信したプッシュキャンペーン | 時刻 |
| フィードバック項目の数 | 数値 |
| 直近Y日間のセッション数 | 数値と時刻 |
| Campaignからメッセージを受信 | ブール値。このフィルターは、過去のCampaignを受信したかどうかに基づいてユーザーをターゲットにします。 |
| タグの付いたCampaignからメッセージを受信 | ブール値。このフィルターは、現在タグが付いているCampaignを受信したかどうかに基づいてユーザーをターゲットにします。 |
| リターゲットCampaign | ブール値。このフィルターは、過去に特定のメール、プッシュ、アプリ内メッセージを開封またはクリックしたかどうかに基づいてユーザーをターゲットにします。 |
| アンインストール | ブール値と時刻 |
最小限の連携のみに関心があり、mParticle、Segment、Tealium、またはGTMと連携する場合は、次の点に注意してください。
- モバイルプラットフォーム： これらを構成するコードを手動で更新する必要があります。mParticleとSegmentは、そのプラットフォームを通じてこれを行う方法を提供していません。
- Web： 最小限の連携構成を可能にするために、Brazeの連携をネイティブに行う必要があります。タグマネージャーはプラットフォームを通じてこれを行う方法を提供していません。
デフォルトで収集されるオプションのデータ
SDK連携を初期化すると、Brazeによって、最小限の連携データに加えて次の属性が自動的に取得されます。これらの属性の収集をオプトアウトして、最小限の連携を実現できます。
| 属性 | プラットフォーム | 説明 | 収集される理由 |
|---|---|---|---|
| ブラウザ名 | Web | ブラウザ名 | この属性は、互換性のあるブラウザにのみメッセージを送信するために使用されます。また、ブラウザベースのセグメンテーションにも使用できます。 |
| デバイスロケール | Android、iOS | デバイスのデフォルトロケール | この属性は、メッセージをユーザーの好みの言語に翻訳するために使用されます。 |
| 最新のデバイスロケール | Android、iOS | デバイスの最新のデフォルトロケール | この属性はユーザーのデバイス設定から取得され、メッセージをユーザーの優先言語に翻訳するために使用されます。これは、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イベントを取り込まなくなります。詳細については、スパムのブロックを参照してください。