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 とセッションタイムスタンプ | セッション識別子、ランダムに生成された文字列とセッションのタイムスタンプ | ユーザーが新しいセッションを開始しているか、既存のセッションを継続しているかを判断し、このユーザー宛てのメッセージの再適格性を判断するために使用されます。 アプリ内メッセージやコンテンツカードなどの特定のメッセージングチャネルは、セッションの開始時にデバイスに同期されます。そして、バックエンドは、最後に Braze サーバーにコンタクトした時刻に関連するデータ（デバイスが保存して送り返す）を使って、ユーザーが新しいメッセージを受け取る資格があるかどうかを判断します。 |
計算された指標
Braze は、SDK データ、非 SDK メッセージに関連するメッセージインタラクションデータ、および派生情報を計算して指標を生成します。わかりやすく言うと、この計算されたデータは SDK が追跡するものではなく、Braze サービスによって生成されるデータであり、ユーザープロファイルには追跡されたデータと生成されたデータの両方が表示されます。
計算された指標には、次の属性が含まれます。
| 属性 | 説明 |
|---|---|
| 最初に使用したアプリ | 時刻 |
| 最後に使用したアプリ | 時刻 |
| 総セッション数 | 数値 |
| クリックされたカード | 数値 |
| 最後に受信したメッセージ | 時刻 |
| 最終受信メールキャンペーン | 時刻 |
| 最後に受信したプッシュキャンペーン | 時刻 |
| フィードバック項目の数 | 数値 |
| 直近 Y 日間のセッション数 | 数値と時刻 |
| キャンペーンからメッセージを受信 | ブール値。このフィルターは、過去のキャンペーンを受信したかどうかに基づいてユーザーをターゲットにします。 |
| タグの付いたキャンペーンからメッセージを受信 | ブール値。このフィルターは、現在タグが付いているキャンペーンを受信したかどうかに基づいてユーザーをターゲットにします。 |
| リターゲットキャンペーン | ブール値。このフィルターは、過去に特定のメール、プッシュ、アプリ内メッセージを開封またはクリックしたかどうかに基づいてユーザーをターゲットにします。 |
| アンインストール | ブール値と時刻 |
最小限の連携のみに関心があり、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 イベントを取り込まなくなります。詳細については、「スパムのブロック」を参照してください。
GitHub でこのページを編集