Tài liệu này giải thích cách cập nhật tệp TSV và gửi tệp dữ liệu tới Epsilon Retail Media, điều cần thiết để chạy chiến dịch và cho phép Epsilon Retail Media phân phối quảng cáo được cá nhân hóa.

Điều kiện tiên quyết để cung cấp tệp tin thông tin chi tiết sản phẩm

Định dạng tệp tin: Đảm bảo tất cả các tệp tin được phân tách bằng tab (TSV). Định dạng này phải nhất quán trong tất cả các tệp tin.
TSV không có trích dẫn: Các tệp TSV không thể ở định dạng trích dẫn. Đảm bảo bạn đồng bộ hóa các tệp không có trích dẫn.
Hàng tiêu đề: Bao gồm một hàng tiêu đề trong mỗi tệp dữ liệu để xác định các cột.
Nén Gzip: Phân phối các tệp TSV bằng cách sử dụng nén gzip.
Quy ước đặt tên tệp: Sử dụng định dạng sau để đặt tên tệp: <clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz
- <clientname>: Thay thế bằng tên khách hàng thích hợp.
- YYYYMMDD: Ngày gửi tệp theo định dạng Năm-Tháng-Ngày. Nên truy cập danh mục sản phẩm hàng ngày để có được quảng cáo tốt nhất. Mỗi lần truy cập là một lần làm mới hoàn toàn, nghĩa là danh mục của ngày hôm trước sẽ bị xóa hoàn toàn và danh mục mới sẽ được tải lên và sử dụng. Do đó, ngày tháng trong tên tệp rất quan trọng.

Các trường bắt buộc cho các trường danh mục sản phẩm

Bạn phải chia sẻ tệp TSV có chứa các thông tin chi tiết sau:

Tên trường	Mô tả
product_code hoặc product_id (Bắt buộc)	Mã để xác định sản phẩm trong hệ thống của bạn, thường là GTIN của sản phẩm. Đây là ID sản phẩm giống với ID được sử dụng trong tích hợp trang web của bạn với Epsilon/CitrusAd. ID này phải là ID cấp độ sản phẩm, không phải ID cấp độ SKU (tức là không chứa thông tin về kích thước hoặc màu sắc).
product_name (Bắt buộc)	Tên hoặc tiêu đề của sản phẩm khi xuất hiện trên trang web của bạn.
product_description (Bắt buộc)	Mô tả sản phẩm khi nó xuất hiện trên trang web của bạn.
URL (Bắt buộc)	URL của trang có chứa sản phẩm này trên trang web của bạn.
image_url (Tùy chọn)	Siêu liên kết dẫn đến hình ảnh của sản phẩm. Phải là URL hợp lệ.
hàng tồn kho hoặc tình trạng sẵn có (Bắt buộc)	Đánh dấu "Y" nếu sản phẩm có hàng để mua trực tuyến; nếu không, hãy đánh dấu "N". Ngoài ra, giá trị này có thể được cung cấp dưới dạng giá trị kiểm kê bằng số, trong đó 0 biểu thị "N" và 1 biểu thị "Y". Nếu giá trị là 0, quảng cáo sản phẩm sẽ không được phân phát cho sản phẩm này.
giá (Tùy chọn)	Giá sản phẩm theo đơn vị tiền tệ địa phương, bao gồm số tiền chính xác bằng đô la và xu. Không bao gồm ký hiệu tiền tệ.
giá_bán (Tùy chọn)	Giá bán của sản phẩm này theo đơn vị tiền tệ địa phương, bao gồm số tiền chính xác bằng đô la và xu. Không bao gồm ký hiệu tiền tệ.
loại (Tùy chọn)	Danh mục hoặc phân loại sản phẩm. Trường này thường dành riêng cho nhà bán lẻ và thường có thể là NULL. Có thể cần thêm thông tin hoặc hướng dẫn để điền chính xác vào trường này.
UPC (Bắt buộc)	Mã sản phẩm thông dụng (UPC) của sản phẩm.
PARENT_SKU_NUMBER (Tùy chọn)	Số SKU gốc – Khách hàng nên xác minh xem số SKU gốc có khả dụng không và xác nhận xem có nên sử dụng UPC hoặc ID sản phẩm thay thế hay không.
CATEGORY_HIERARCHY_IDS (Tùy chọn)	Phân cấp được phân định của ID danh mục cho sản phẩm. Ví dụ: 1234>2345>3456
CATEGORY_HIERARCHY_NAMES (Tùy chọn)	Phân cấp được phân định của tên danh mục cho sản phẩm. Ví dụ: Nam>Áo>Áo sơ mi
PRODUCT_BRAND (Bắt buộc)	Thương hiệu mà sản phẩm này liên quan đến.
FILTERS (Bắt buộc)	Mảng json của các bộ lọc sản phẩm.
FILTER:KEY (Bắt buộc)	Bắt buộc phải có giá trị này đối với danh mục và vị trí hiển thị rộng. Để thêm các bộ lọc như danh mục vào hệ thống một cách hiệu quả, các nhà bán lẻ nên chia sẻ danh sách danh mục của họ (retailer_taxonomy). Các danh mục nên được thêm vào theo định dạng "danh mục:", ví dụ "danh mục:Sách". Nếu sử dụng loại cột này thì nhà bán lẻ phải cung cấp một giá trị cho . Nhiều cột có cú pháp này có thể được đưa vào một tệp TSV.
subClassName (Chỉ bắt buộc đối với các vị trí bán chéo tại chỗ)	Tên của phân nhóm hoặc danh mục mà sản phẩm có liên quan thuộc về. Ví dụ, sản phẩm bơ có thể thuộc phân nhóm 'bánh mì' nhưng không thuộc phân nhóm 'băng gạc'. Phân loại này cho phép nhắm mục tiêu sản phẩm tốt hơn.
xSellSubClassName (Chỉ bắt buộc đối với các vị trí bán chéo tại chỗ)	Tên của các lớp con/danh mục mà sản phẩm có liên quan có thể nhắm mục tiêu đến các sản phẩm bên trong.
custom_payload (Tùy chọn - Chỉ áp dụng tại chỗ cho các tích hợp mà nhà bán lẻ nhận được siêu dữ liệu tùy chỉnh bổ sung để hiển thị sản phẩm.)	Trường này chứa một tải trọng dữ liệu tùy chỉnh và tải trọng này sẽ được chuyển đến quá trình tạo quảng cáo. Giá trị cho cột này phải là một đối tượng JSON hợp lệ được tuần tự hóa thành một mảng byte và được mã hóa Base64.
PRODUCT_REVIEW_COUNT (Tùy chọn)	Số lượng đánh giá trực tuyến hiện tại cho sản phẩm này.
PRODUCT_RATING_COUNT (Tùy chọn)	Số lượng đánh giá trực tuyến hiện tại cho sản phẩm này.
PRODUCT_RATING_AVERAGE (Tùy chọn)	Đánh giá trung bình hiện tại cho sản phẩm này.
COLLECTION_ID (Tùy chọn)	ID cho bộ sưu tập mà sản phẩm thuộc về (ví dụ: Trang phục, Bộ truyện, v.v.). Tất cả các sản phẩm trong cùng một bộ sưu tập phải chia sẻ cùng ID bộ sưu tập.
COLLECTION_TYPE (Tùy chọn)	Loại cho bộ sưu tập mà sản phẩm thuộc về (ví dụ: Trang phục, Dòng sản phẩm, v.v.). Tất cả các sản phẩm trong cùng một bộ sưu tập phải chia sẻ cùng ID bộ sưu tập.
COLLECTION_IMAGE_URL (Tùy chọn)	URL của hình ảnh hiển thị bộ sưu tập này.
COLLECTION_URL (Tùy chọn)	URL của trang trên trang web của bạn có chứa bộ sưu tập này.
GENDER (Tùy chọn)	Giới tính (nam, nữ, bé trai, bé gái, không rõ) liên quan đến sản phẩm này.
SIZE	Kích cỡ của sản phẩm này.
CUSTOMPRODUCT_ATTRIBUTE#	Các trường tùy chỉnh chứa thông tin cụ thể cho doanh nghiệp của bạn. Làm việc với Kỹ sư Tích hợp Máy khách của bạn để xác định nội dung của trường này hoặc nếu cần các trường bổ sung.

Chia sẻ tệp TSV của bạn

Sau khi cập nhật tệp TSV của bạn với tất cả các trường bắt buộc, hãy chia sẻ tệp đó với Kỹ sư Tích hợp Máy khách (CIE) Epsilon của bạn. Ngoài ra, hãy cung cấp các thông tin chi tiết sau cùng với tệp:

Địa chỉ email liên hệ dữ liệu
Bản ghi Tiêu đề cho từng tệp
Thông báo cho nhóm Epsilon rằng các tệp đã được gửi và bao gồm số lượng hàng cho mỗi tệp