ファーストパーティCookieは、ユーザーが現在アクセスしているウェブサイト（またはドメイン）に保存されている小さなデータです。これらのCookieは、ウェブサイト自体によって直接作成、保存され、そのウェブサイトからのみアクセスできます。

ユーザーがウェブサイトにアクセスすると、ブラウザにファーストパーティCookieが設定されます。このCookieには、固有のユーザーIDや、サイトでのユーザーの操作に関するデータなど、さまざまな情報が含まれる場合があります。このCookieは複数のセッションや訪問にわたって保持されるため、ウェブサイトはリピーターを認識し、時間の経過とともにそのユーザーのアクションを関連付けることができます。これらのIDは、システム上で約13か月間使用可能です。

EpsilonはこのCookieを活用して、より詳細なオムニチャネルレポートとアトリビューションを実現します。

前提条件

サイトにファーストパーティCookie（FPC）ベースのアトリビューションを正常に実装するには、オンサイトアクティビティをEpsilonのファーストパーティCookieと統合する前に、次のデータがあることを確認してください。

必要なデータを準備する

顧客データ、コンバージョンデータ、Epsilonサイトタグが準備されていることを確認します。

• コンバージョンデータ：コンバージョンデータは、正確なアトリビューション、ターゲティングの強化、パフォーマンスの最適化、データの一貫性の確保、包括的な顧客インサイトの提供に役立ちます。
  • キャンペーンのコンバージョンデータ：店舗、オンライン、カタログなど、すべての購入チャネルのコンバージョンデータを含めます。
  • すべてのコンバージョン：既知および未知の顧客からのすべてのコンバージョンを含めます。
  • 総売上高のみ：注文の更新やキャンセルを除いた総売上高のみを提供します。
  • 一貫した注文ID：コンバージョンファイルで渡される注文IDがウェブサイトのタグに渡された注文IDと一致していることを確認してください。
• Epsilonサイトタグ：サイトのタグ付けでは、トラッキングコードをウェブページに埋め込んで、ファーストパーティCookieを設定して読み取る必要があります。このプロセスは、ユーザーインタラクションを長期にわたって正確に把握し、アクションを正確に把握するために不可欠です。

  📘

  シームレスな統合を実現するためには、カスタマー統合エンジニア（CIE）および統合プログラム・マネージャー（IPM）チームと協力する必要があります。次のような必要な手順を案内します。

  • タグ付け戦略：関連するすべてのユーザーインタラクションを捉える戦略を策定します。
  • 実装：トラッキングコードをウェブページに正しく埋め込みます。
  • テスト：Cookieが正しく設定され、読み取られていることを確認するために、徹底的にテストします。

一致する属性を提供する

クライアントは、以下のデータポイントにわたって一致する属性を提供する必要があります。

ファーストパーティCookieの実装

このセクションでは、Epsilonのファーストパーティ Cookie（FPC）をオンサイトアクティビティと正常に統合し、正確な追跡とアトリビューションを確保するために必要な一連の手順の概要を説明します。

ステップ1：ファーストパーティCookieを識別して取得

1. クライアントのブラウザでFPCがいつ設定されるかを決定します。

2. Cookieデータ内の dtm_token 値を見つけて特定します。

   

📘

新しいユーザーが初めてサイトにアクセスしたとき、FPCは設定されません。ユーザーがサイト内を初めて移動したときにファーストパーティCookieの値が表示されます。 dtm_token が利用可能になり次第、利用を開始することができます。

ステップ2：オンサイト広告リクエストAPI呼び出しで dtm_token を渡す

1. オンサイト広告リクエストAPI呼び出しを行うときは、 dtm_token 値を dtmCookieId フィールドに含めます。これにより、ユーザーインタラクションの正確な追跡と帰属が可能になります。

2. さらに、 CustomerId 値を CustomerId フィールドに渡すと、Cookieが特定の顧客に関連付けされ、追跡の精度が向上します。 CustomerId 値は、顧客が小売業者のサイトにログインすると使用可能になります。

   リクエストの例

   HTTP

   {
     "sessionid": "{SESSION_ID}", // Set to value advised by your CIE.
     "customerid": "{CUSTOMER_ID}", // Set to CustomerId value when available.
     "dtmCookieId": "{DTM_TOKEN_VALUE}" // Set to dtm_token value.
   }
   
   

   レスポンスの例

   HTTP

   {
     "sessionid": "SESSION_1", // Set to value advised by your CIE.
     "customerid": "CUSTOMER_1", // Set to CustomerId value when available.
     "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE" // Set to dtm_token value.
   }
   
   

広告リクエストAPI呼び出しの詳細については商品広告の生成を参照してください。

📘

システムがキャッシュを使用してデータやコンテンツを一時的に保存してパフォーマンスを向上させる場合は、すべてのインプレッションイベントとクリックイベントの呼び出しに dtm_token 値を含めることが不可欠です。これにより、データがキャッシュから提供される場合でも、ユーザーの操作が正しく追跡されるようになります。

ステップ2a：キャッシュの実装を処理

キャッシュ機能を統合している場合は、インプレッションとクリックイベントの呼び出しに dtm_token 値を送信していることを確認してください。

インプレッションイベントの例

GET {integration}.citrusad.com/v1/resource/first-i/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

クリックイベントの例

GET {integration}.citrusad.com/v1/resource/second-c/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

ステップ3：オンサイト注文API呼び出しで dtm_token を渡す

1. オンサイト広告リクエストAPI呼び出しを行うときは、 dtm_token 値を dtmCookieId フィールドに含めます。これにより、注文やコンバージョンアクションを特定のユーザーに正確に帰属させることができます。
2. さらに、 CustomerId 値を CustomerId フィールドに渡すと、注文データが顧客プロファイルにリンクされ、より詳細なレポートと分析が容易になります。CustomerId値は、顧客が小売業者のサイトにログインすると使用可能になります。

レスポンスの例

{
    "orders": [
       {
        "customerId": "npc-s243-ir",
        "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
        "sessionId": "5cat7-9964-4f",
        "dtmCookieId": " AAAF8xLBTA968AB6TOthAAAAAAE"
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",  
                  "quantity": 3, 
                  "regularUnitPrice": 1.00,
                  "totalOrderItemPriceAfterDiscounts": 3.00,
                  "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
                  "citrusDiscountAmount": 0.0,
                  "substitutedFor": null,
                  "sellerId": "seller_id_601_64"
                }
              ]
            }
    ]
}

広告リクエストAPI呼び出しの詳細についてはAPIを介した注文データの同期を参照してください。