{"user_id":{"customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_name":"af_purchase","event_revenue":49.99,"event_revenue_currency":"USD","event_value":{"af_content_id":"SKU-001","af_quantity":2,"custom_parameters":{"promo_code":"SUMMER10"}},"event_url":"https://example.com/checkout/success","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

{"user_id":{"appsflyer_id":"1234567890abcdef","customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_url":"https://example.com/products/sneakers","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...","http_referrer":"https://www.google.com/","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

訪問データには、それ以降のすべてのイベントが参照するアトリビューションパラメーターが含まれています。また、システムでは、同じユーザーからイベントを受信する前に、訪問データを受信することを前提としています。訪問データより先にイベントを送信した場合、そのイベントはオーガニックとして分類されます。

afUserIdを設定するWeb SDKがないため、Cookieを自社で設定して管理する必要があります。JavaScriptで書き込むクライアントサイドCookieではなく、Set-Cookieレスポンスヘッダーで設定するHTTP Cookieとして実装してください。

この違いが重要である理由は、クライアントサイドCookie（document.cookieを使用して設定したCookie）の有効期限が短いためです。Safariでは最短7日間、ITPの対象となるドメインでは24時間で期限切れになる場合があります。Cookieの有効期限が切れると識別子がリセットされるため、再訪問したユーザーが新規ユーザーとして認識されます。一方、サーバーで設定したCookieにはこの上限が適用されず、ブラウザが許容する最大期間まで保持できます。たとえば、Chromeでは最大400日間保持できます。また、HttpOnlyを指定すれば、ページ上のスクリプトや広告ブロッカーによるCookieの読み取りや削除を防ぐことができます。さらに、ページ上でスクリプトを実行する必要もありません。

Cookieを設定して読み取る手順は、次のとおりです。

1. Cookieを持たない訪問者から最初のリクエストを受信した際に、サーバー側で永続的かつ一意のID（UUIDなど）を生成します。

2. そのIDをファーストパーティCookieとして返します：

   Set-Cookie: af_web_id=<generated-id>; Max-Age=34128000; Path=/; Secure; HttpOnly; SameSite=Lax

3. それ以降のすべてのリクエストでは、受信したCookieヘッダーから値を読み取り、同じ値を再利用します。新しい値を生成しないでください。
4. AppsFlyerへのすべてのリクエストで、その値をリクエスト内のuser_idオブジェクトにappsflyer_idとして含めて送信します。

Cookieには任意の名前を付けることができます。AppsFlyerが読み取るのは送信された値であり、Cookieの名前ではありません。ただし、必ず自社のファーストパーティドメインからCookieを設定してください。

すべてのリクエストにuser_idオブジェクトを含め、少なくともappsflyer_id（Cookieの値）またはcustomer_user_id（自社の内部ユーザーID）のいずれかを指定する必要があります。両方の値を利用できる場合は、両方を送信することでユーザー識別の精度が向上します。

留意すべき点は、Webサイトへの訪問時点では、ほとんどのユーザーが匿名であるということです。そのため、訪問データには必ずcustomer_user_idの値を含めてください。Webサイト上で発生するイベントについては、ユーザーを識別できた時点でcustomer_user_idを追加し、それ以降もCookieの値と併せて送信してください。ブラウザ以外で発生するイベントについては、以前に識別済みのセッションを通じてAppsFlyerがそのユーザーをすでに認識している場合に限り、customer_user_idのみを送信することもできます。

すべてのリクエストでuser_idのオブジェクトを指定する必要があります。以下のいずれかの識別子を必ず含めてください。

イベントおよびWeb訪問は、アプリのタイムゾーンにおける翌日の00:30までにAppsFlyerへ到着する必要があります。この期限を過ぎて受信したイベントは、イベントに含まれるタイムスタンプではなく、AppsFlyerが受信した時刻が使用されます。

すべての個人情報（PII）項目は、送信前にSHA256でハッシュ化する必要があります。ハッシュ化する前に、文字列は小文字へ変換し、前後の空白を削除して正規化してください。各ハッシュ値は、大文字・小文字を区別しない64文字の16進数文字列である必要があります。

• すべてのハッシュフィールドで使用するパターンは以下のとおりです：^[a-fA-F0-9]{64}$
• phone_number_e164_hashed を使用する場合は、電話番号をE.164形式（例：+14155552671）へ変換してからハッシュ化してください。

• afUserId は、ユーザーが初めてWebサイトへアクセスした際に、Web SDKによって設定される一意の識別子です。
• afUserId が必要な場合は、以下のいずれかの方法で取得できます。

HTTP CookieヘッダーからafUserIdを取得する

• afUserIdは、ユーザーのブラウザからWebサイトへ送信されるHTTP Cookieヘッダーに含まれています。
• 必要に応じてHTTP Cookieヘッダーから取得してください。

ブラウザでafUserIdを確認する

• トラブルシューティングやデバッグを行う場合は、ブラウザ上でafUserIdを確認できます。
• afUserIdを確認するには、ユーザーがWeb SDKを組み込んだページへ少なくとも1回アクセスしている必要があります。
• afUserId を含むCookieは、お客様のドメインに対するファーストパーティCookieとして保存されます。
• 以下の手順はChrome 81を使用して作成しています。ブラウザやOSによって表示や操作方法が異なる場合があります。

ブラウザからafUserIdを取得する：

1. ブラウザでWebサイトを開きます。
2. ページ上で右クリックし、Inspectを選択します。ブラウザの開発者ツールが表示されます。
3. (A) Applicationタブを開きます。
4. サイドメニューにて、(B)［Cookie］を開きます。
5. お客様のWebサイトを選択します。表示されない場合はブラウザを更新してください。
6. (C) フィルター欄にafUserIdと入力すると、afUserIdの値が表示されます。