|
| `inventory` | 필수 | 숫자
32비트 부호 없는 정수 권장
| 상품의 재고입니다. 값이 0이면 해당 상품의 상품 광고가 노출되지 않습니다. | 1 |
| `description` | 필수 | 텍스트
최대 5000자
| 상품의 설명입니다. | 대비되는 화이트 컬러의 자수 트레포일과 아웃라인 3-스트라이프가 특징인 스포츠 스웨트 쇼츠는 Adidas Originals의 신제품입니다. |
| `KEY (as a value)` | 카테고리 및 브로드 디스플레이 지면에 필수 | 텍스트
열당 최대 1000자
| 이 유형의 열을 사용하는 경우 리테일러는 \에 대한 값을 제공해야 합니다.
TSV 파일에 이 구문을 사용하는 열이 여러 개 있을 수 있습니다.
| 열 이름은 “brand”일 수 있으며, 해당 열의 셀 값은 “green-fairy”일 수 있습니다. 이 경우 상품에 "brand:green-fairy" 필터가 적용됩니다. |
| `subClassName` | 더 이상 사용되지 않음(Deprecated).
상품 크로스셀/업셀 지면에 필수
| 텍스트
최대 750자
| 해당 상품이 속한 서브클래스/카테고리의 이름입니다.
서브클래스를 사용하면 더 정확한 상품 타겟팅이 가능해집니다. 예: 버터 상품은 빵을 타겟팅할 수 있지만 대용두창 반창고는 타겟팅하지 않습니다.
| 치즈 |
| `xSellSubClassName` | 더 이상 사용되지 않음(Deprecated).
상품 크로스셀/업셀 지면에 필수
| 텍스트
최대 750자
| 해당 상품이 내에서 상품을 타겟팅할 수 있는 서브클래스/카테고리의 이름입니다. | 빵류, 스프레드, 크래커 |
| `price` | 선택 | 숫자
소수점 2자리 권장
| 상품의 가격입니다. | 30.00 |
| `brand` | 필수 | 텍스트
최대 70자
| 상품의 브랜드입니다. | 타미 힐피거 |
| `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/ko/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은 압생트나 카카오 러버를 위한 완벽한 선물입니다. 스푼 위에 설탕 한 조각을 올리고 그 위에 압생트를 부어 정통 방식으로 이 스피릿을 즐겨보세요! | 선물, 주류, 기프트 팩 | 500ml | 체코 공화국 | 선물, 주류, 기프트 팩 | `5.00` | Green Fairy | 주류 | 선물>주류>기프트 팩 | 식품, 음료 및 담배>음료>알코올 음료>독주 및 스피릿>압생트 | 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 형식을 지원하며, 이는 더 큰 파일 유연성과 함께 하루에 여러 번 파일을 동기화할 수 있는 기회를 제공합니다.
{% 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/ko/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 스키마() 기반 유효성 검사가 수행됩니다. 페이로드 사양은 아래 링크를 통해 제공됩니다(JSON 스키마 표기법):
상품 광고 응답에서, 정확한 맞춤형 페이로드가 다음 이름의 필드로 연동 기능 제공자에게 반환됩니다: `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/ko/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.