> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/data-api/order-data-1.md).

# 注文データ

Epsilon Retail Media は関連性の高い広告を生成するために注文データを必要とします。また、注文は売上、コンバージョン、売上高、ROASの計算に使用されるため、注文を同期することは、 Epsilon Retail Media ポータル内の広告主およびリテール業者向けダッシュボードにとっても非常に価値があります。このデータは、広告チームが投資効果を分析し、それに応じて追加の支出を行うことができるため、非常に役立ちます。

<figure><img src="/files/0valwseg4Ur8u4Qie6Pv" alt="Reporting.png" width="100%"><figcaption><p>キャンペーン画面の画像</p></figcaption></figure>

## 注文データの同期

注文データの同期では、リテール業者が広告リクエスト内で顧客の\*\*`sessionId`\*\*を送信し、その後 Epsilon Retail Mediaとの注文データ同期を行います。この情報により、 Epsilon Retail Media は `adId`'s の広告リクエストに対して提供された `sessionId`を確認し、設定されたアトリビューションウィンドウ内で適切に属性を付与できます。

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

<figure><img src="/files/3Anq78CTAv9unTclneqb" alt="Group 95.png" width="100%"><figcaption></figcaption></figure>

#### 連携の要件

この連携では、以下に示す例のように、広告リクエストと注文確認において Epsilon Retail Media 顧客の固有セッション識別子を送信する必要があります：

```json
{
   "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"
                }
              ]
            }
    ]
}
```

{% hint style="info" %}
この `sessionId` は、送信される広告リクエストで提供されるものと同じである必要があります Epsilon Retail Media.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/data-api/order-data-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.