どのようにお手伝いできますか?

検索

カスタマーユーザーID（CUID）フィールド

  • 更新

CUIDを使うと、異なるデバイス、メディアソース、チャネルで発生した同一ユーザーのイベントをまとめられます。

CUIDとは

カスタマーユーザーID（CUID）は、アプリ側で設定する一意のユーザー識別子です。通常、アプリの運営者がユーザー登録時に生成・設定します。 CUIDを使うと、アプリの運営者は複数のデバイスにまたがるユーザーの一連の行動を追跡できます。

例

たとえば、2台以上のデバイスを使うユーザーに、各アプリで共通のCUIDを設定します。ユーザーがモバイル端末やデスクトップ端末でイベントを実行するたびに、SDKがイベントとCUIDを取得します。広告主は各デバイスのデータを統合し、ユーザーの行動を全体として把握できます。

主な活用例：

  • 同一ユーザーが複数のデバイス（スマートフォン、タブレット、テレビ、デスクトップ）で同じアプリ内の購入を行った場合、それらを1人のユーザーの購入データとしてまとめて確認できます。
  • 複数のプラットフォーム（デスクトップ、モバイル、テレビ）でユーザーの利用状況データを共有し、一貫したユーザー体験を提供できます。

CUIDの設定

できるだけ多くのイベントをCUIDに紐づけられるよう、SDKの初期化処理のできるだけ早い段階でCUIDを設定することを推奨します。

Androidネイティブ

CUIDを取得できたら、setCustomerUserIDを呼び出して設定できます。 CUIDを紐づけられるのは、設定後に発生したアプリ内イベントのみです。そのため、startをsetCustomerUserIDより先に呼び出すと、インストールイベントにCUIDは含まれません。

インストールイベントとCUIDの紐付け

インストールイベントにCUIDを紐づける必要がある場合は、startを呼び出す前に設定することを推奨します。

重要：startより先にCUIDを設定する実装では、CUIDの設定を待つ間、SDKからインストールイベントが送信されず、アトリビューションが行われなくなる場合があります。たとえば、ユーザーがアプリを初めて起動した後、SDKがCUIDを設定する前にアプリを終了すると、この状況が発生する可能性があります。

Androidでは、アプリの実装に応じて、グローバルなApplicationクラスまたはActivityクラスからstartメソッドの実行とCUIDの設定を行えます。詳細は、SDKを開始するクラスの選択を参照してください。

ApplicationクラスでSDKを開始する場合

グローバルなApplicationクラスからSDKを開始し、インストールイベントにCUIDを紐づける場合は、waitForCustomerUserIdメソッドを使ってインストールイベントの送信を遅らせてください。このメソッドは、CUIDが設定されるまでSDKを待機状態にします。

注意：何らかの理由でCUIDの設定に失敗すると、SDKは待機状態のままとなり、イベントを一切送信しません。

ActivityクラスでSDKを開始する場合

ActivityクラスからSDKを開始し、インストールイベントにCUIDを紐づける場合は、インストールイベントの送信を遅らせる必要はありません。 startを呼び出す前にsetCustomerUserIdを呼び出してください。

開発者向けの手順

開発者に、以下を伝えてください。

  • グローバルなApplicationクラスからSDKを開始する場合は、waitForCustomerUserIdを使用します。
  • 開発者向けのリンク：
    • インストールイベントにCUIDを紐づける方法は、こちらを参照してください。
iOSネイティブ

customerUserIdメソッドを使ってCUIDを設定します。 startメソッドを呼び出す前と後のどちらでcustomerUserIdを設定するかによって、CUIDを紐づけられるイベントが異なります。

  • startより先にcustomerUserIdを呼び出すと、SDKはインストールイベントと、それ以降のアプリ内イベントにCUIDを紐づけます。
  • startの後に呼び出すと、SDKはCUIDの設定後に記録されたイベントにのみCUIDを紐づけます。

開発者向けの手順

Dev HubのカスタマーユーザーIDの設定を開発者に案内してください。

Unity

開発者向けの手順

Dev HubのカスタマーユーザーIDの設定を開発者に案内してください。

React Native

開発者向けの手順

Dev HubのAPIリファレンスにあるsetCustomerUserIdの説明を開発者に案内してください。

Web

実装手順の詳細は、「AppsFlyer Web SDKの実装」のカスタマーユーザーIDの設定を参照してください。

CUIDとプライバシー

AppsFlyerはユーザーのプライバシーを尊重し、機微な個人情報の収集やAppsFlyerプラットフォームへの送信を認めていません。

ユーザーのプライバシーを保護するため、ユーザーを直接識別できる情報をCUIDに含めないでください。これには、社会保障番号や国民識別番号が含まれます。

CUIDにユーザーのメールアドレスや電話番号が含まれる場合は、AppsFlyerに送信する前にハッシュ化する必要があります。個人情報を含むCUIDを、ハッシュ化せずにAppsFlyerに送信しないでください。

関連情報

Tags