> 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/catalog-products-2/syncing-catalog-products-via-file.md).
# ファイル経由でのカタログと商品の同期
Epsilon Retail Media はファイル経由の商品データ同期で2つのフォーマット形式をサポートしています:
* TSV
* CSV
このセクションでは、処理される商品データの各ファイルフォーマットの構造について説明します。 Epsilon Retail Media.
## 最大ファイルサイズ
Epsilon Retail Media はリテール事業者あたり1,000万商品以下のカタログファイルをサポート可能で、ほとんどのマーケットプレイス規模のカタログに対応できます。
{% hint style="info" %}
1,000万商品を超えていますか？
カタログがこのボリュームを超える場合、 Epsilon Retail Media はカタログサイズがサポート可能かどうかを評価できます。これには商用上の調整が必要になる場合があることにご注意ください。
{% endhint %}
## TSV/CSVファイル
以下の表は、TSV/CSVファイル内の商品の列名と列の説明を示しています。この表では、ファイル内で提供が必須となる必須列も指定しています。列が必須である場合、その行のすべての値を列に入力する必要があります。
{% hint style="warning" %}
️ クォートなしのTSV
TSVファイルはクォート形式にできません。TSV経由で同期する場合は、クォートで囲まれていないファイルを同期するようにしてください。
{% endhint %}
### TSV/CSVファイルにおける商品データの列名と説明
| 列名 | 必須/任意 | データ型 | 説明 | 例 |
| ------------------------ | ------------------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `product_code` | 必須 | テキスト
最大50文字
| システム内で商品を識別するためのコード。このフィールドは、APIおよびXMLファイルの同期におけるgtinフィールドおよびitemフィールドと同一です。 | F153212AN1 |
| `name` | 必須 | テキスト
最大150文字
| 商品の名称。 | SS Sticker Tee - Kids |
| `image_url` | 必須 | Url
最大2048文字
| 商品の画像へのハイパーリンク。有効なURLである必要があります。 | |
| `inventory` | 必須 | 数値
32ビット符号なし整数を推奨
| 商品の在庫。数が0の場合、その商品の商品広告は配信されません。 | 1 |
| `description` | 必須 | テキスト
最大5000文字
| 商品の説明文。 | コントラストホワイトのトレフォイルの刺繍とアウトラインの3ストライプスをあしらったSport Sweat Shortsは、Adidas Originalsのフレッシュな新商品です。 |
| `KEY (as a value)` | カテゴリーおよびブロードディスプレイ枠で必須 | テキスト
1列あたり最大1000文字
| このタイプの列を使用する場合、リテール事業者は\の値を設定する必要があります。
TSVファイル内にこの構文を持つ列が複数存在する場合があります。
| 列名を「brand」、列内のセルの値を「green-fairy」にすることができます。これにより、商品に対して「brand:green-fairy」というフィルターが適用されます。 |
| `subClassName` | 非推奨。
商品クロスセル/アップセル枠で必須
| テキスト
最大750文字
| 該当商品が属するサブクラス/カテゴリーの名称。
サブクラスを使用すると、より適切な商品ターゲティングが可能になります。たとえば、バターの商品であればパンをターゲットにできますが、バンドエイドをターゲットにすることはありません。
| チーズ |
| `xSellSubClassName` | 非推奨。
商品クロスセル/アップセル枠で必須
| テキスト
最大750文字
| 該当商品が商品ターゲティング可能なサブクラス/カテゴリーの名称。 | パン、スプレッド、クラッカー |
| `price` | 任意 | 数値
小数点以下2桁を推奨
| 商品の価格。 | 30.00 |
| `brand` | 必須 | テキスト
最大70文字
| 商品のブランド。 | Tommy Hilfiger |
| `type` | 必須 | テキスト
最大750文字
| 商品タイプ。 | 衣料品 |
| `retailer_taxonomy` | 高度なアトリビューションで必須。文字の間にスペースを含めることはできません `>` 文字 | テキスト
最大750文字
| 個別のリテール事業者独自の商品タクソノミー。 | メンズ>メンズ衣料品>セーター |
| `google_taxonomy` | 以下を提供できない場合、高度なアトリビューションで必須 `retailer_taxonomy` 提供できません | テキスト
最大750文字
| 商品の標準Googleタクソノミー。詳細についてはこちらをご覧ください: | アパレル・小物 > 衣料品 > トップス |
| `global_identifier` | 必須 | テキスト
最大50文字
| 商品のグローバル識別子。 | 08719108994761 |
| `global_identifier_type` | 必須 | テキスト | グローバル識別子のタイプ。 | GTIN |
| `custom_payload` | 指示がない限り不要です。 | Base64エンコードされたバイト配列 | このフィールドには、広告生成までスレッド化されるカスタムペイロードが含まれます。フィールドには、バイト配列にシリアル化され、Base64エンコードされた有効なJSONオブジェクトを含める必要があります。JSONオブジェクトはスキーマに準拠している必要があります。 | カスタムペイロードのセクションを参照してください。 |
| `hfss` | 任意 | Boolean | 商品がHFSSであるかどうかを示すために使用されます。これはさらに Epsilon Retail MediaのUIで活用されます。詳細については、弊社の [HFSSドキュメント](/retail-media-interface/integration/ja/feature-integrations/placement-level-product-type-blocking-hfss-support.md) をご覧ください。 | true |
| `seller_id` | 任意 | テキスト
最大50文字
| 出品者の固有ID。マーケットプレイスの出品者をオンボーディングする場合にのみ必要です。非マーケットプレイス商品の場合は空欄のままにすることができます。
seller\_idsを統合するには追加の要件があります。以下を参照してください。 マーケットプレイス sellerId をご覧ください。
| aes-de4-ss |
表として表されるサンプルファイルは以下で確認できます。
| `product_code` | `name` | `image_url` | `inventory` | `description` | `filter:Category` | `filter:Size` | `filter:Country` | `groups` | `price` | `brand` | `type` | `retailer_taxonomy` | `google_taxonomy` | `global_identifier` | seller\_id | subClassName | xSellSubClassName |
| -------------- | ----------------------------------- | ------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------- | ---------------- | ---------------------------- | ------- | ----------- | ------- | ------------------- | ----------------------------------- | ------------------- | ----------------- | ------------ | ----------------- |
| 80591101 | Green Fairy Absinth Gift Pack 500mL | | `20` | このGreen Fairy Absinth & Spoon Gift Packは、アブサンやカクテルを愛するすべての人への完璧なギフトです。スプーンの上に角砂糖を置き、上からアブサンを注ぐことで、本物の飲み方でこのスピリッツを楽しめます！ | Gifts, Alcoholic, Gift-packs | 500ml | チェコ共和国 | Gifts, Alcoholic, Gift-packs | `5.00` | Green Fairy | Alcohol | ギフト>アルコール飲料>ギフトパック | 食品・飲料・タバコ>飲料>アルコール飲料>蒸留酒・スピリッツ>アブサン | 8594001443079 | 7328s-dmie3-9jdae | ギフトパック | 酒類 |
{% hint style="info" %}
TSVファイルは引用符で囲んだ形式にすることはできません。
{% endhint %}
## 商品画像の更新
Epsilon は画像URLをキャッシュして、一貫したパフォーマンスを確保し、画像サーバーへのリクエストを削減します。 URLを変更せずに画像を更新する場合は、明確に再読み込みをトリガーする必要があります Epsilon。これを行うには：
* 商品から既存のimage\_urlを削除します。
* 更新が完了したら、同じimage\_urlを再送信します。
あるいは、画像サーバーがサポートしている場合は、既存のURLにクエリ文字列（バージョンやタイムスタンプなど）を追加して、強制的に再読み込みすることができます。これにより Epsilon が画像を再読み込みします。
{% hint style="info" %}
画像はUIでのみ使用されます
商品画像は広告レスポンスでは提供されません。画像の更新は、キャッシュの再読み込みが発生している間の Epsilon UIでの商品の表示方法にのみ影響します。
{% endhint %}
## XMLファイル - 非推奨化予定
{% hint style="danger" %}
️ 新しいお客様には非推奨
以下は、現在もXML形式を利用している既存のお客様向けに提供されています。新しいカタログのオンボーディングでは、上記でドキュメント化されているTSVおよびCSV形式をサポートしており、より優れたファイルの柔軟性と、1日に複数回ファイルを同期する機会を提供します。
{% endhint %}
Epsilon Retail Media は、商品のXMLドキュメントを記述するために使用されるタグのリストを定義しています。下の表は、タグとその説明を示しています。タグ「item」は、XMLドキュメント内の商品を記述するために使用されます。他のフィールドの他のすべてのタグは、このタグの中に記述する必要があります。
| XMLタグ | 必須/任意 | 説明 |
| ------------------------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item` | 必須 | このタグは商品を記述するために使用されます。商品の他のすべてのXMLタグは、このタグの中にある必要があります。商品のXMLドキュメントには、itemタグのリストが含まれている必要があります。このフィールドは、APIおよびTSVファイルの同期におけるgtinおよびproduct\_codeフィールドと同一です。 |
| `id` | 必須 | システム内で商品を識別するためのコード。 `product_code` （TSVファイル内）に相当します。このフィールドは、APIおよびXMLファイルの同期におけるgtinおよびitemフィールドと同一です。 |
| `title` | 必須 | 商品の名称。 |
| `image_link` | 必須
最大50文字
| 商品の画像へのハイパーリンク。有効なURLである必要があります。 |
| `brand` | 必須
最大70文字
| 商品のブランド。 |
| `availability` | 必須
32ビット符号なし整数を推奨
| このタグは商品の在庫を記述するためのものです。値は数値である必要があります。 |
| `description` | 必須
最大5000文字
| このタグは商品の説明を記述するためのものです。 |
| `price` | 任意
小数点以下2桁を推奨
| このタグは商品の価格を記述するためのものです。タグ内の値が提供される場合は、数値である必要があります。 |
| `type` | 任意
最大750文字
| 商品タイプ。 |
| `retailer_taxonomy` | エンハンスト・アトリビューションに必要です。カテゴリ統合にも必要です。
最大750文字
| 商品の個別の小売り分類体系。例：メンズ>メンズ衣料>セーター |
| `google_taxonomy` | 以下を提供できない場合、高度なアトリビューションで必須 retailer\_taxonomy 提供できません
最大750文字
| 商品の標準Googleタクソノミー。詳細についてはこちらをご覧ください: |
| `global_identifier` | 必須
最大50文字
| 商品のグローバル識別子。例： `08719108994761` |
| `global_identifier_type` | 必須 | グローバル識別子のタイプ。例： `GTIN` |
| `custom_payload` | 指示がない限り不要です。 | このフィールドには、広告生成までスレッド化されるカスタムペイロードが含まれます。フィールドには、バイト配列にシリアル化され、Base64エンコードされた有効なJSONオブジェクトを含める必要があります。JSONオブジェクトはスキーマに準拠している必要があります。 |
| `hfss` | 任意 | 商品がHFSSであるかどうかを示すために使用されます。これはさらに Epsilon Retail MediaのUIで活用されます。詳細については、弊社の [HFSSドキュメント](/retail-media-interface/integration/ja/feature-integrations/placement-level-product-type-blocking-hfss-support.md) をご覧ください。 |
| `seller_id` | 任意
最大50文字
| 出品者の固有ID。マーケットプレイスの出品者をオンボーディングする場合にのみ必要です。非マーケットプレイス商品の場合は空欄のままにすることができます。
seller\_idsを統合するには追加の要件があります。以下を参照してください。 マーケットプレイス sellerId をご覧ください。
|
タグを含む有効なXMLドキュメントの例を以下に示します。
```xml
-
80591011
Melissa & Doug Dinosaur Stamp Set, 4yrs+
Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around
https://www.retailer.com/productImages/image1.jpg
£9.99
Melissa & Doug
Food Cupboard
10
true
-
87086011
Waitrose Splits Strawberry Ice Lollies
Strawberry splits; Suitable for vegetarians. Strawberry splits vanilla flavoured ice cream with a fruity strawberry ice coating. Our fundamental belief is that few things in life are more important than the food you buy. Good quality is essential.
https://www.retailer.com/productImages/image2.jpg
£1.25
Waitrose
Frozen Ice Cream Ice Cream Lollies
20
Waitrose
false
432un3-sd32s-ssaar
```
## カスタムペイロード
### カスタムペイロードとは何ですか？
カスタムペイロードとは、カタログの取り込みから広告配信まで「そのまま」スレッド化されるフィールドです。フィールドに変換は適用されません。ただし、JSON Schema（）に基づく検証がフィールドに対して実行されます。ペイロード仕様は、以下のリンク（JSON Schema表記）を介して提供されます。
商品広告レスポンスでは、正確なカスタムペイロードが `customPayload`という名前のフィールドでインテグレーターに返されます。有効なペイロードの例を以下に示します。
```json
{
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
}
```
{% hint style="warning" %}
ファイルのみ
カスタムペイロードは、ファイル経由で商品を同期する場合にのみサポートされることに注意してください。
{% endhint %}
### 広告生成におけるカスタムペイロード
商品広告を返す際、カスタムペイロードは生成された広告の一部として受け渡されます。返される広告ペイロードには追加のフィールドが含まれ、 `customPayload` フィードで提供された情報と同じ仕様に準拠したJSONオブジェクトが含まれます。
レスポンスの例は次のようになります:
```json
{
"ads": [
{
"id": "display_SEY2W7-VZzspoirbw4ANs-r-w6YyODk5MDQ5UA==",
"gtin": "4400000463",
"customPayload": {
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
} ,
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2019-12-10T01:46:07.516943179Z"
}
],
"banners": [],
"products": []
}
```
{% hint style="warning" %}
カスタムペイロードは当社の広告生成サービスにとって追加の負荷となるため、特に明記されていない限り、カスタムペイロードの連携は Epsilon Retail Media SLAの対象外となりますのでご注意ください。
{% 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/catalog-products-2/syncing-catalog-products-via-file.md?ask=&goal=
```
`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.