概要: CUIDを使用すると、異なる端末、メディアソース、またはチャネル間で同じユーザーのイベントをグループ化できます。
CUIDとは?
カスタマーユーザーID(CUID)は、 一位のユーザー識別子です。通常、ユーザー登録時にアプリの所有者によって生成および採番されます。CUIDを使用すると、アプリの所有者はさまざまなデバイス間でユーザージャーニーを追跡できます。
例
2つ以上のデバイスを持つユーザーは、アプリ内で同じ CUIDを持ちます。 ユーザがモバイル端末またはデスクトップ端末でイベントを実行するたびに、イベントが CUIDと共に記録されます。これにより、広告主はデバイスのデータを全体的なユーザービューに結合できます。
使用例:
- 同じユーザーが同じアプリで複数のデバイス(スマートフォン、タブレット、テレビ、デスクトップ)で実行したアプリ内購入を1つのビューにまとめることができます。
- 複数のプラットフォーム(デスクトップ、モバイル、テレビ)にインストールされたゲームのユーザーパフォーマンスをこれらのプラットフォーム間で共有して、全体的なユーザーエクスペリエンスを実現できます。
CUIDの設定
できるだけ多くのイベントがCUIDの紐付けを取得できるように、SDK初期化フローのできるだけ早い段階でCUIDを設定することをお勧めします。
CUIDが使用・取得可能になり次第、 setCustomerUserId
を呼び出して計測するよう設定します。CUIDは、設定後に発生するアプリ内イベントにのみ紐付けることができます。従って、 start
がsetCustomerUserID
の前に 呼び出された場合、インストールイベントはCUIDに紐付けられません。
CUIDをインストールイベントに紐付ける
インストールイベントに CUIDを紐付けることが重要な場合は、 start
を呼び出す前に設定する必要があります。
重要: アプリで start
をコールする前にCUIDを設定すると、SDKがインストールイベントを送信するのをブロックし、アトリビューションが発生しなくなる可能性があることを忘れないでください。これは、たとえば、ユーザがアプリを初回起動し、SDKがCUIDが付与される前に離脱した際に発生します。
Androidでは、アプリの実装に応じて、start
メソッドとCUIDの設定は、グローバルApplication
クラスまたは Activity
クラスのどちらからでも実行できます。
詳細: SDKを起動するクラスを選択する
SDKをApplicationクラスで起動する場合
グローバル Application
クラスから開始するときに CUIDを インストールイベント に紐付ける場合は、この waitForCustomerUserId
メソッドを使用してインストールイベントの送信を遅らせることができます。このメソッドは、CUID が設定されるまで SDKの開始(=アトリビューション計測の開始)を待機モードにします。
注:何らかの理由で CUIDの設定が失敗した場合、SDKは待機モードのままになり、インストールイベントは送信されません。
SDKをActivityクラスで起動する場合
Activity
クラスから開始するときに、 インストール イベントにCUIDを紐付けたい場合は、インストールイベントの送信を遅らせる必要はありません。 start
をコールする前に setCustomerUserID
を呼び出してください。
開発者向けの手順
開発者に以下内容を連携してください:
- SDKをグローバル
Application
クラスで起動する場合は、waitForCustomerUserId
を使用します。 - 開発者向けリンク:
- CUIDをインストールイベントに紐づける場合は、 こちらを参照してください。
この customerUserId
メソッドを使用して CUIDを設定します。start
メソッドに関連するsetCustomerUserId
の位置は、CUIDに紐付けられるイベントを決定します。
start
を呼び出す前にcustomerUserId
が呼び出された場合、CUIDはインストールと以下のアプリ内イベントに紐付けられます。start
後に呼び出された場合、CUIDは、CUID設定後に記録されたイベントにのみ紐付けられます。
開発者向けの手順
開発者にDev HubのカスタマーユーザーIDを参照するよう伝えます。
開発者向けの手順
開発者にDev HubのカスタマーユーザーIDを参照するよう伝えます。
開発者向けの手順
開発者に、AppsFlyer公式デベロッパーハブの setCustomerUserId APIリファレンスを共有してください。
CUIDとプライバシー
AppsFlyerは、ユーザーのプライバシーを尊重し、 機密性の高い個人データの収集またはAppsFlyerプラットフォームへの転送を許可しません。
ユーザーのプライバシーを保護するため、ユーザーを直接識別する情報を使用して CUIDを設計することは許可されていません。 これには、社会保障番号または国民識別番号が含まれます。
さらに、設定されたCUIDにユーザーのメールアドレスまたは電話番号が含まれている場合、そのような情報はAppsFlyerに送信する際に常にハッシュ化する必要があります。 個人データを含むハッシュ化されていないCUIDをAppsFlyerに送信することは禁止されています。
参照:
- ユーザージャーニーレポート (ローデータレポートにおけるCUIDの詳細)
- Googleアナリティクスヘルプ:個人を特定できる情報(PII)を送信しないようにするためのヒント