SDK によるデータ収集

Braze SDK をお客様のアプリやサイトと連携すると、Braze は特定タイプのデータを自動的に収集します。このデータには、当社のプロセスに必須のものと、お客様が必要に応じてオン / オフを切り替えられるものがあります。セグメンテーションとメッセージングをさらに強化するために、インテグレータは他のタイプのデータを追加で収集するように Braze を設定することもできます。

Braze は、柔軟にデータ収集ができるように設計されています。Braze SDKは以下の方法で統合できる：

• 最小限の連携:Braze は、Braze サービスとの通信を可能にするために必要なデータを自動的に収集します。
• デフォルトで収集されるオプションのデータ:Braze は、お客様のほとんどのユースケースで広く役立つデータを自動的に取得します。インテグレーターは、最小限の統合に不可欠でない場合、このデータの自動収集を無効にすることができる。
• デフォルトでは収集されないオプションデータ：Brazeは、特定の顧客のユースケースにとって有用なデータを取得する機能を提供しているが、広範なコンプライアンス上の理由から、自動的に収集が可能になることはない。インテグレーターは、自分たちのユースケースに適した場所で、このデータの収集を選択することができる。
• パーソナライズされた連携:デフォルトのオプションデータに加えて、インテグレータはデータを柔軟に収集できます。

最小限の連携

以下に、インテグレータが SDK の初期化を選択したときに、Braze が生成し受信する厳密な必須データの一覧を示します。これらはオン / オフ設定ができない要素で、プラットフォームのコア機能に不可欠です。セッションの開始と終了を除き、自動的に追跡される他のデータはすべて、データポイントの割り当てを消費しません。

属性	プラットフォーム	説明	なぜ収集されるのか
アプリのバージョン名 アプリのバージョンコード	アンドロイド、iOS、ウェブ	アプリの最新バージョン	この属性は、アプリのバージョン互換性に関連するメッセージが正しいデバイスに送信されることを保証するために使用される。サービスの中断やバグをユーザーに通知するために使用できる。
国	アンドロイド、iOS	IPアドレスのジオロケーションによって特定される国	この属性は、位置に基づいてメッセージをターゲット化するために使用される。
デバイスID	アンドロイド、iOS、ウェブ	デバイス識別子、ランダムに生成される文字列	この属性は、ユーザーのデバイスを区別し、メッセージが正しく意図されたデバイスに送信されるようにするために使用される。
OSとOSバージョン	アンドロイド、iOS、ウェブ	現在報告されているデバイス／ブラウザとデバイス／ブラウザのバージョン	この属性は、メッセージが互換性のあるデバイスにのみ送信されることを保証するために使用される。また、アプリのバージョンをアップグレードするユーザーをターゲットとするセグメンテーションにも使用できる。
セッション開始とセッション終了	アンドロイド、iOS、ウェブ	ユーザーが統合されたアプリやサイトを使い始めるとき	Braze SDK では、ユーザーエンゲージメントやユーザーの理解に不可欠なその他の分析を計算するため、Braze ダッシュボードで使用されるセッションデータがレポートされます。アプリやサイトからセッション開始とセッション終了が呼び出される正確なタイミングは、開発者が設定できる（Android、iOS、Web）。
SDKメッセージ・インタラクション・データ	アンドロイド、iOS、ウェブ	プッシュ・ダイレクト・オープン、アプリ内メッセージ・インタラクション、コンテンツ・カード・インタラクション	この属性は、メッセージが受信されたか、送信が重複していないかをチェックするような品質管理の目的で使用される。
SDKバージョン	アンドロイド、iOS、ウェブ	現在のSDKバージョン	この属性は、メッセージが互換性のあるデバイスにのみ送信され、サービスが中断されないことを保証するために使用される。
セッションIDとセッションタイムスタンプ	アンドロイド、iOS、ウェブ	セッション識別子、ランダムに生成された文字列とセッションのタイムスタンプ。	ユーザが新しいセッションを開始しているか、既存のセッションを開始しているかを判断し、このユーザ宛てのメッセージの再有効性を判断するために使用される。 アプリ内メッセージやコンテンツカードなどの特定のメッセージングチャネルは、セッションの開始時にデバイスに同期されます。そして、私たちのバックエンドは、最後にBrazeサーバーにコンタクトしたときに関連するデータ（デバイスが保存して送り返す）を使って、ユーザーが新しいメッセージを受け取る資格があるかどうかを知る。

計算された指標

Braze バックエンドは、SDK データ、非 SDK メッセージに関連するメッセージインタラクションデータ、および派生情報を計算して指標を生成します。わかりやすく言うと、この計算されたデータは SDK が追跡するものではなく、Braze サービスによって生成されるデータであり、ユーザープロファイルには追跡されたデータと生成されたデータの両方が表示されます。

計算された指標には、次の属性が含まれます。

属性	説明
最初に使用したアプリ	時刻
最後に使用したアプリ	時刻
総セッション数	数値
クリックされたカード	数値
最後に受信したメッセージ	時刻
最終受信メールキャンペーン	時刻
最後のプッシュ・キャンペーン	時刻
フィードバック項目の数	数値
直近Y日間のセッション数	番号と時間
キャンペーンからメッセージを受信	ブールである。このフィルターによって、過去のキャンペーンを受けた（受けていない）ユーザーに基づいてターゲットを絞ることができる。
タグの付いたキャンペーンからのメッセージを受け取った	ブールである。このフィルターによって、現在タグを持つキャンペーンを受け取った（受け取っていない）ユーザーに基づいて、ユーザーをターゲットにすることができる。
リターゲットキャンペーン	ブールである。このフィルターによって、過去に特定のメール、プッシュ、アプリ内メッセージを開いたか、クリックしたかどうかに基づいて、ユーザーをターゲットにすることができる。
アンインストール	ブール値と時間

デフォルトで収集されるオプションのデータ

インテグレータが SDK を初期化すると、Braze によって、最小限の連携データに加えて次の属性が自動的に取得されます。インテグレータは、これらの属性の収集をオプトアウトして、最小限の連携を実現できます。

属性	プラットフォーム	説明	なぜ収集されるのか
ブラウザ名	Web	ブラウザ名	この属性は、メッセージが互換性のあるブラウザにのみ送信されることを保証するために使用される。また、ブラウザベースのセグメンテーションにも使用できる。
デバイスロケール	アンドロイド、iOS	デバイスのデフォルトロケール	この属性は、メッセージをユーザーの好みの言語に翻訳するために使われる。
デバイスモデル	アンドロイド、iOS	機器固有のハードウェア	この属性は、メッセージが互換性のあるデバイスにのみ送信されることを保証するために使用される。また、セグメンテーションの中でも使うことができる。
機器ブランド	Android	デバイスのブランド（例：サムスン）	この属性は、メッセージが互換性のあるデバイスにのみ送信されることを保証するために使用される。
ワイヤレス・キャリア	アンドロイド、iOS	携帯キャリア	この属性は、オプションでメッセージのターゲティングに使われる。 注:このフィールドはiOS 16で非推奨となり、将来のiOSバージョンではデフォルトで-- 。
言語	アンドロイド、iOS、ウェブ	デバイス／ブラウザの言語	この属性は、メッセージをユーザーの好みの言語に翻訳するために使われる。
通知設定	アンドロイド、iOS、ウェブ	このアプリがプッシュ通知を有効にしているかどうか。	この属性は、プッシュ通知を有効にするために使用される。
決議	アンドロイド、iOS、ウェブ	デバイス／ブラウザの解像度	オプションで、デバイスベースのメッセージターゲティングに使用される。この値のフォーマットは “<width>x<height>” である。
タイムゾーン	アンドロイド、iOS、ウェブ	デバイス／ブラウザのタイムゾーン	この属性は、各ユーザーのローカル・タイムゾーンに従って、メッセージが適切な時間に送信されるようにするために使用される。
ユーザーエージェント	Web	ユーザーエージェント	この属性は、メッセージが互換性のあるデバイスにのみ送信されることを保証するために使用される。また、セグメンテーションの中でも使うことができる。

デバイスの通信事業者、タイムゾーン、解像度など、デバイスレベルの属性の追跡の詳細については、対応するプラットフォームのドキュメントを参照してください。Android、iOS、Web。

デフォルトでは収集されないデータ

デフォルトでは、以下の属性は収集されない。それぞれを手動で統合する必要がある。

属性	プラットフォーム	説明	収集されない理由
デバイス広告のトラッキングを有効にする	アンドロイド、iOS	iOSの場合： set(adTrackingEnabled:) アンドロイドの場合： Braze.setGoogleAdvertisingId()	このプロパティは、インテグレーターによって許可されなければならない、追加のアプリレベルのパーミッションが必要である。
デバイス IDFA	iOS	広告主のデバイス識別子	これにはAd Tracking Transparencyフレームワークが必要で、App Storeによる追加のプライバシー審査が行われる。詳細は以下を参照のこと。 set(identifierForAdvertiser:)
グーグル広告ID	Android	Google Playアプリ内の広告用識別子	そのため、アプリがGAIDを取得してBrazeに渡す必要がある。詳細については、「Google広告IDのオプション」を参照のこと。

パーソナライズされた連携

Braze を最大限に活用しようとするインテグレータは、多くの場合 Braze SDK を実装し、自動的に収集されたデータに加えて、ビジネスに関連するカスタム属性、カスタムイベント、購入イベントを記録します。

パーソナライズされた連携により、ユーザーエクスペリエンスに関連付けてコミュニケーションをカスタマイズできます。