옵션 2: 카탈로그 업데이트를 위한 제품 데이터 파일 제공
제품 데이터 파일을 사용하여 카탈로그에 제품 세부 정보를 추가합니다.
이 문서에서는 캠페인을 실행하고 Epsilon Retail Media가 개인화된 광고를 제공하는 데 필수적인 TSV 파일을 업데이트하고 데이터 파일을 Epsilon Retail Media로 전송하는 방법을 설명합니다.
제품 세부 정보 파일 전송을 위한 사전 필수 조건
- 파일 형식: 모든 파일이 탭으로 구분(TSV)되어 있는지 확인합니다. 이 형식은 모든 파일에서 일관되어야 합니다.
- 따옴표가 없는 TSV: TSV 파일은 따옴표 형식일 수 없습니다. 따옴표가 없는 파일을 동기화해야 합니다.
- 헤더 행: 각 데이터 파일에 열을 식별하기 위한 헤더 행을 포함합니다.
- Gzip 압축: gzip 압축을 사용하여 TSV 파일을 전송합니다.
- 파일 이름 지정 규칙: 파일 이름 지정 시 다음 형식을 사용합니다.
<clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz- <clientname>: 적절한 클라이언트 이름으로 바꿉니다.
- YYYYMMDD: 년-월-일 형식의 파일 전송 날짜입니다. 최상의 광고를 실행하려면 매일 제품 카탈로그를 수집하는 것이 좋습니다. 각 수집은 전체 새로 고침으로 전날의 카탈로그가 완전히 지워지고 새 카탈로그가 업로드되어 사용되므로 파일 이름의 날짜가 매우 중요합니다.
제품 카탈로그 필드 내 필수 필드
다음 세부 정보가 포함된 TSV 파일을 공유해야 합니다.
| 필드 이름 | 설명 |
|---|---|
| product_code or product_id(필수) | 시스템에서 제품을 식별하는 코드로, 일반적으로 제품의 GTIN입니다. 이 ID는 Epsilon/CitrusAd와의 사이트 통합에 사용된 제품 ID와 동일합니다. SKU 레벨 ID가 아닌 제품 레벨 ID여야 합니다(사이즈나 색상 정보를 포함하지 않아야 함). |
| product_name(필수) | 사이트에 표시되는 제품의 이름 또는 제목입니다. |
| product_description(필수) | 사이트에 표시되는 제품 설명입니다. |
| URL(필수) | 사이트에서 이 제품이 포함된 페이지의 URL입니다. |
| image_url(선택) | 제품의 이미지에 대한 하이퍼링크입니다. 유효한 URL이어야 합니다. |
| 재고 또는 가용성(필수) | 현재 온라인에서 제품을 구매할 수 있는 경우 "Y", 구매할 수 없는 경우 "N"을 표시합니다. 숫자로 재고 유무를 표시할 수도 있습니다. 0은 "N", 1은 "Y"를 나타냅니다. 값이 0인 경우 제품 광고가 실행되지 않습니다. |
| 가격(선택) | 현지 통화로 표시된 제품의 가격(달러 및 센트 단위의 정확한 금액)입니다. 통화 기호를 포함하지 마십시오. |
| 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(필수) | 카테고리 및 확장 디스플레이 게재 위치에 필요합니다. 카테고리와 같은 필터를 시스템에 효과적으로 추가하려면 소매업체가 카테고리 목록(retailer_taxonomy)을 공유하는 것이 좋습니다. 카테고리는 "category:Books"와 같이"category:" 형식으로 추가해야 합니다. 이 유형의 열을 사용하는 경우 소매업체는 다음에 대한 값을 제공해야 합니다. 이 구문이 사용된 여러 열을 TSV 파일에 포함할 수 있습니다. |
| subClassName(교차 판매 온사이트 게재위치에만 필요) | 관련 제품이 속한 하위 클래스 또는 카테고리의 이름입니다. 예를 들어 버터 제품은 '빵' 하위 클래스에 속할 수 있지만 '붕대' 하위 클래스에는 속하지 않습니다. 이 분류를 통해 더 나은 제품 타기팅이 가능합니다. |
| xSellSubClassName(교차 판매 온사이트 게재위치에만 필요) | 관련 제품이 동일한 카테고리 내의 제품을 대상으로 지정할 수 있는 하위 클래스/카테고리의 이름입니다. |
| custom_payload(선택 - 소매업체가 제품을 렌더링하기 위해 추가 사용자 지정 메타데이터를 수신하는 통합의 경우에만 온사이트에서 사용) | 이 필드는 광고 생성으로 스레드되어야 하는 사용자 정의 페이로드를 포함합니다. 이 열의 값은 바이트 배열로 직렬화되고 Base64로 인코딩된 유효한 JSON 객체여야 합니다. |
| 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입니다. |
| 성별(선택) | 이 제품이 연관된 성별(남성, 여성, 소년, 소녀, 알 수 없음)입니다. |
| 사이즈 | 이 제품의 크기입니다. |
| CUSTOMPRODUCT_ATTRIBUTE# | 귀하의 비즈니스와 관련된 정보가 포함된 사용자 정의 필드입니다. 클라이언트 통합 엔지니어와 상의하여 이 필드의 콘텐츠 또는 추가 필드가 필요한지 확인합니다. |
TSV 파일 공유
모든 필수 필드를 포함한 TSV 파일을 업데이트한 후 Epsilon 클라이언트 통합 엔지니어(CIE)와 공유합니다. 또한 파일과 함께 다음 세부 정보를 제공하세요.
- 데이터 담당자 이메일 주소
- 각 파일에 대한 헤더 레코드
- 각 파일에 대한 행 수 정보를 포함하여 Epsilon 팀에 파일이 전송되었음을 알립니다.
업데이트됨 4개월 전