옵션 2: 카탈로그 업데이트를 위한 제품 데이터 파일 제공
이 문서에서는 캠페인을 실행하고 Epsilon Retail Media가 개인화된 광고를 제공하는 데 필수적인 TSV 파일을 업데이트하고 데이터 파일을 Epsilon Retail Media로 전송하는 방법을 설명합니다.
제품 세부 정보 파일 전송을 위한 사전 필수 조건
- 파일 형식: 모든 파일은 탭으로 구분(TSV)되어야 하며 모든 파일에서 일관성을 유지하는 것이 좋습니다.
- 따옴표가 없는 TSV: TSV 파일은 따옴표 형식일 수 없습니다. 따옴표가 없는 파일을 동기화해야 합니다.
- 헤더 행: 각 데이터 파일에 열을 식별하기 위한 헤더 행을 포함합니다.
- Gzip 압축: TSV 파일은 gzip 압축을 사용하여 전송하는 것이 좋습니다.
- 파일 이름 지정 규칙: 파일 이름 지정 시 다음 형식을 사용합니다.
<clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz- <clientname>: 적절한 클라이언트 이름으로 바꿉니다.
- YYYYMMDD: 년-월-일 형식의 파일 전송 날짜입니다. 최상의 광고를 실행하려면 매일 제품 카탈로그를 수집하는 것이 좋습니다. 각 수집은 전체 새로 고침으로 전날의 카탈로그가 완전히 지워지고 새 카탈로그가 업로드되어 사용되므로 파일 이름의 날짜가 매우 중요합니다.
제품 카탈로그 필드 내 필수 필드
다음 세부 정보가 포함된 TSV 파일을 공유해야 합니다.
| 필드 이름 | 설명 |
|---|---|
| product_code or product_id(필수) | A code to identify the product in your system, typically the GTIN of the product. This is the same product ID used within your site's integration with Epsilon/CitrusAd. It should be a product-level ID, not a SKU-level ID (i.e., it should not contain size or color information). |
| product_name(필수) | 사이트에 표시되는 제품의 이름 또는 제목입니다. |
| product_description(필수) | 사이트에 표시되는 제품 설명입니다. |
| URL(필수) | 사이트에서 이 제품이 포함된 페이지의 URL입니다. |
| image_url(선택) | 제품의 이미지에 대한 하이퍼링크입니다. 유효한 URL이어야 합니다. |
| 재고 또는 가용성(필수) | Indicate "Y" if the product is currently available for purchase online; otherwise, indicate "N". Alternatively, this can be provided as a numeric inventory value, where 0 represents "N" and 1 represents "Y". If the value is 0, product ads will not be served for the product. |
| 가격(선택) | 현지 통화로 표시된 제품의 가격(달러 및 센트 단위의 정확한 금액)입니다. 통화 기호를 포함하지 마십시오. |
| sale_price(선택) | 현지 통화로 표시된 제품의 판매 가격(달러 및 센트 단위의 정확한 금액)입니다. 통화 기호를 포함하지 마십시오. |
| 유형(선택) | 제품 카테고리 또는 분류입니다. 이 필드는 일반적으로 소매업체에 따라 다르며 NULL인 경우가 많습니다. 이 필드를 정확하게 채우려면 추가 정보나 지침이 필요할 수 있습니다. |
| UPC(필수) | 제품의 범용 제품 코드(UPC)입니다. |
| PARENT_SKU_NUMBER(선택) | 상위 SKU 번호 - 클라이언트는 상위 SKU 번호를 사용할 수 없는지 확인하고 UPC 또는 제품 ID를 대안으로 사용해야 하는지 확인해야 합니다. |
| CATEGORY_HIERARCHY_IDS(선택) | 제품에 대한 카테고리 ID의 구분된 계층 구조입니다. 예: 1234>2345>3456 |
| CATEGORY_HIERARCHY_NAMES(선택) | 제품에 대한 카테고리 이름의 구분된 계층 구조입니다. 예: 남성>상의>셔츠 |
| PRODUCT_BRAND(필수) | 이 제품과 관련된 브랜드입니다. |
| FILTERS(필수) | 제품 필터의 json 배열입니다. |
| FILTER:KEY(필수) | This is required for the category and broad display placements. To add filters like categories into the system effectively, we recommend that retailers share their list of categories (retailer_taxonomy). Categories should be added in the format "category:<value>", such as "category:Books". 이 유형의 열이 사용되는 경우 소매업체는 다음에 대한 값을 제공해야 합니다. |
| subClassName(교차 판매 온사이트 게재위치에만 필요) | 관련 제품이 속한 하위 클래스 또는 카테고리의 이름입니다. 예를 들어 버터 제품은 '빵' 하위 클래스에 속할 수 있지만 '붕대' 하위 클래스에는 속하지 않습니다. 이 분류를 통해 더 나은 제품 타기팅이 가능합니다. |
| xSellSubClassName(교차 판매 온사이트 게재위치에만 필요) | 관련 제품이 동일한 카테고리 내의 제품을 대상으로 지정할 수 있는 하위 클래스/카테고리의 이름입니다. |
| custom_payload(선택 - 소매업체가 제품을 렌더링하기 위해 추가 사용자 지정 메타데이터를 수신하는 통합의 경우에만 온사이트에서 사용) | This field contains a custom payload that should be threaded through to ad generation. The value for this column must be a valid JSON object serialized into a byte array and Base64 encoded. |
| PRODUCT_REVIEW_COUNT(선택) | 이 제품에 대한 현재 온라인 리뷰 수입니다. |
| PRODUCT_RATING_COUNT(선택) | 이 제품에 대한 현재 온라인 평점 수입니다. |
| PRODUCT_RATING_AVERAGE(선택) | 이 제품의 현재 평균 평점입니다. |
| COLLECTION_ID(선택) | 제품이 속한 컬렉션의 ID입니다(예: Outfit, Series). 동일한 컬렉션에 있는 모든 제품은 동일한 컬렉션 ID를 공유해야 합니다. |
| COLLECTION_TYPE(선택) | 제품이 속한 컬렉션의 유형(예: Outfit, Series)입니다. 동일한 컬렉션의 모든 제품은 동일한 컬렉션 ID를 공유해야 합니다. |
| COLLECTION_IMAGE_URL(선택) | 이 컬렉션을 표시하는 이미지의 URL입니다. |
| COLLECTION_URL(선택) | 이 컬렉션이 포함된 사이트 페이지의 URL입니다. |
| 성별(선택) | 이 제품이 연관된 성별(남성, 여성, 소년, 소녀, 알 수 없음)입니다. |
| 사이즈 | 이 제품의 크기입니다. |
| CUSTOM_PRODUCTATTRIBUTE# | 귀하의 비즈니스와 관련된 정보가 포함된 사용자 정의 필드입니다. 클라이언트 통합 엔지니어와 상의하여 이 필드의 콘텐츠 또는 추가 필드가 필요한지 확인합니다. |
TSV 파일 공유
모든 필수 필드를 포함한 TSV 파일을 업데이트한 후 Epsilon 클라이언트 통합 엔지니어(CIE)와 공유합니다. 또한 파일과 함께 다음 세부 정보를 제공하세요.
- 데이터 담당자 이메일 주소
- 각 파일에 대한 헤더 레코드
- 각 파일에 대한 행 수 정보를 포함하여 Epsilon 팀에 파일이 전송되었음을 알립니다.
업데이트됨 17일 전