> 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/syncing-order-data-via-file.md).

# ファイル経由での注文データの同期

Epsilon Retail Mediaf は注文データとして TSV フォーマットのみをサポートしています。以下の表は、TSV ファイル内の列名とその説明を示しています。

{% hint style="warning" %}
TSV 経由で同期する場合、 `order_id` は順序通りに提供する必要があり、複数の商品が購入された場合は、それらが同時に同じ `order_Id` に紐付けられるようにする必要があります。

もし `order_id`が断片化している場合、注文内の以降の商品は紐付けされません。
{% endhint %}

## TSV ファイル内の顧客データの列名と説明

| 列名                     | 必須/オプション | データ型 | 説明                                                                                                                                                                                                                                                                                       |
| ---------------------- | -------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | 必須       | テキスト | <p>これは小売業者のシステムにおける注文の識別子です。<br><br>orderId で並べ替える<strong>必要があります</strong>。</p>                                                                                                                                                                                                          |
| `order_date`           | 必須       | テキスト | <p>これは注文の日付または日時です。ISO-8601 標準の形式である必要があり、正確で完全なタイムスタンプである必要があります（例： <code>2019-03-14T15:06:17+10:00</code><br>タイムゾーン調整済み（UTC+10 の場合は +10:00）または UTC 時間のいずれかである必要があります。</p>                                                                                                              |
| `product_code`         | 必須       | テキスト | これは注文内の商品を特定するためのコードです。                                                                                                                                                                                                                                                                  |
| `quantity`             | 必須       | 数値   | <p>これは注文内の商品の数量です。<br><br>これは整数である<strong>必要があります</strong>。</p>                                                                                                                                                                                                                          |
| `regular_unit_price`   | オプション    | 数値   | <p>これは注文内の商品の通常単価です。<br><br>提供する場合、数値である<strong>必要があります</strong>。</p>                                                                                                                                                                                                                    |
| `price_with_discounts` | 必須       | 数値   | これは割引後の商品の合計価格です。数値である**必要があります**。例えば、注文アイテムに価格 2.00 の商品が 3 点含まれている場合、値は次のようになります： `6`.                                                                                                                                                                                                  |
| `customer_id`          | オプション    | テキスト | これは注文の顧客の識別子です。                                                                                                                                                                                                                                                                          |
| `session_id`           | 必須。      | テキスト | これはユーザーのセッションを識別するために管理者が制御する生成された ID です。 Epsilon Retail Media はこれを購入の紐付けに使用できます。                                                                                                                                                                                                        |
| `seller_id`            | オプション    | テキスト | <p>出品者のユニーク ID。<strong>マーケットプレイス出品者をオンボーディングする場合のみ必須</strong>。マーケットプレイス以外の商品では空欄にできます。<br><br>マーケットプレイスのサプライヤーをオンボーディングしていないときにこれを指定すると、紐付けの問題が発生する可能性があります。<br><br>seller\_ids を統合するには追加の要件があります。詳細は以下を参照してください： <a href="/pages/jM2PUi7m00cg6LBMOlac">マーケットプレイス sellerId</a> 詳細情報。</p> |

顧客の TSV ファイルの例は以下の表で確認できます。商品データや顧客データと同様に、生データはテキストファイルですが、簡単に読み取れるように表で表示されています。

| `order_id` | `order_date`                | `product_code` | `quantity` | `regular_unit_price` | `price_with_discounts` | `customer_id` | `session_id`                               | `seller_id`     |
| ---------- | --------------------------- | -------------- | ---------- | -------------------- | ---------------------- | ------------- | ------------------------------------------ | --------------- |
| 1343321    | `2019-03-15T17:06:17+00:06` | 357480         | `1`        | `469`                | `469`                  | 4234          | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA    | wde3e-sadet-d43 |
| 1343321    | `2019-03-15T17:06:17+00:06` | 4153234        | `4`        | `47.95`              | `191.8`                | 4234          | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA    |                 |
| 1343321    | `2019-03-15T17:06:17+00:06` | 73553          | `1`        | `6`                  | `6`                    | 4234          | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA    |                 |
| 6845359    | `2019-03-15T17:06:17+00:06` | 74549          | `3`        | `6`                  | `18`                   | 2462          | 4fy5MPixTU-cKAWimSlHsLkfrUZCV1NfNzM1NTM=   |                 |
| 6845360    | `2019-03-15T17:06:17+00:06` | 76542          | `2`        | `11`                 | `22`                   | 4281          | IDI0Ks\_vmSyeLUmDaa1UCCGJ\_chCV1NfNzM1NTM= |                 |

{% hint style="info" %}
このセクションで説明されている用語について不明な点がある場合は、リファレンスページをご覧ください。
{% 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/syncing-order-data-via-file.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.