CitrusAdは、関連する広告を生成するために注文データを必要とします。注文の同期は、CitrusAdポータル内の広告主や小売業者のダッシュボードでも非常に有効です。注文のデータは、販売量、コンバージョン、売上額、ROASの計算に使用されるからです。このデータを使用して投資効果を分析し、追加の支出の検討に役立てることもできるため、このデータは広告チームにとって非常に有益です。

注文データの同期

注文データの同期には、小売業者が広告のリクエストで顧客の sessionId を送信し、CitrusAdと注文データを同期することが含まれます。この情報により、CitrusAdはその adIdを確認し（ sessionIdの広告リクエストに対して提供）、設定されたアトリビューションウィンドウ内で情報に応じてアトリビューションを行うことができます。

必要に応じて、 sessionId を長期のハッシュ化顧客識別子に代えて、セッション全体をアトリビューションすることもできます。詳しくは、テクニカルアカウントマネージャーにお問い合わせください。

統合の要件

この統合では、以下の例のように、広告要求と注文確認で、顧客の一意のセッション識別子をCitrusAdに送信することが要求されます。

{
   "orders": [
       {
        "customerId": "npc-s243-ir",
        "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
        "sessionId": "5cat7-9964-4f",
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",
                  "quantity": 3,
                  "regularUnitPrice": "1.00",
                  "totalOrderItemPriceAfterDiscounts": "3.00"              
                }
              ]
            }
    ]
}

📘

この sessionId は、CitrusAdに送信される広告リクエストと同じである必要があります。