ตัวเลือกที่ 2: จัดเตรียมไฟล์ข้อมูลผลิตภัณฑ์เพื่ออัปเดตแค็ตตาล็อกของคุณ

เพิ่มรายละเอียดผลิตภัณฑ์ลงในแคตตาล็อกของคุณโดยใช้ไฟล์ข้อมูลผลิตภัณฑ์

เอกสารนี้อธิบายถึงวิธีอัปเดตไฟล์ TSV และส่งไฟล์ข้อมูลไปยัง Epsilon Retail Media ซึ่งจำเป็นสำหรับการดำเนินการแคมเปญและการเปิดใช้งาน Epsilon Retail Media เพื่อส่งมอบโฆษณาที่ปรับแต่งเฉพาะบุคคล

ข้อกำหนดเบื้องต้นสำหรับการจัดส่งไฟล์รายละเอียดสินค้า

  • รูปแบบไฟล์: ตรวจสอบให้แน่ใจว่าไฟล์ทั้งหมดถูกคั่นด้วยแท็บ (TSV) รูปแบบนี้จะต้องสอดคล้องกันในทุกไฟล์
  • TSV ที่ไม่ได้อ้างอิง: ไฟล์ TSV ไม่สามารถอยู่ในรูปแบบที่อ้างถึงได้ ตรวจสอบให้แน่ใจว่าคุณซิงโครไนซ์ไฟล์ที่ไม่ได้ใส่เครื่องหมายคำพูด
  • แถวส่วนหัว: รวมแถวส่วนหัวในแต่ละไฟล์ข้อมูลเพื่อระบุคอลัมน์
  • การบีบอัด Gzip: ส่งไฟล์ TSV โดยใช้การบีบอัด gzip
  • ข้อตกลงการตั้งชื่อไฟล์: ใช้รูปแบบต่อไปนี้สำหรับการตั้งชื่อไฟล์: <clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz
    • <clientname>: แทนที่ด้วยชื่อไคลเอนต์ที่เหมาะสม
    • ปปปปดดวว: ให้ส่งวันที่ไฟล์ในรูปแบบปี-เดือน-วัน ขอแนะนำให้นำเข้าแคตตาล็อกผลิตภัณฑ์ทุกวันเพื่อให้แสดงโฆษณาได้ดีที่สุด การนำเข้าแต่ละครั้งจะเป็นการรีเฟรชอย่างเต็มรูปแบบ ซึ่งหมายความว่าแค็ตตาล็อกของวันก่อนหน้าจะถูกลบทิ้งทั้งหมด และแค็ตตาล็อกใหม่จะถูกอัปโหลดและใช้งาน ดังนั้น วันที่ในชื่อไฟล์จึงมีความสำคัญ

ช่องที่ต้องระบุสำหรับช่องแค็ตตาล็อกผลิตภัณฑ์

คุณต้องแชร์ไฟล์ TSV ซึ่งมีรายละเอียดดังต่อไปนี้:

ชื่อฟิลด์คำอธิบาย
product_code or product_id (ต้องระบุ)รหัสเพื่อระบุผลิตภัณฑ์ในระบบของคุณ โดยทั่วไปคือ GTIN ของผลิตภัณฑ์

นี่คือ ID ผลิตภัณฑ์เดียวกับที่ใช้ในการบูรณาการไซต์ของคุณกับ Epsilon/CitrusAd ควรเป็น ID ระดับผลิตภัณฑ์ ไม่ใช่ ID ระดับ SKU (กล่าวคือ ไม่ควรมีข้อมูลขนาดหรือสี)
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 (จำเป็น)ยี่ห้อที่ผลิตภัณฑ์นี้มีความเกี่ยวข้อง
ตัวกรอง (จําเป็น)อาร์เรย์ Json ของตัวกรองผลิตภัณฑ์
FILTER:KEY (จําเป็น)จำเป็นสำหรับหมวดหมู่และตำแหน่งการแสดงผลแบบกว้าง

หากต้องการเพิ่มตัวกรอง เช่น หมวดหมู่ ลงในระบบอย่างมีประสิทธิภาพ เราขอแนะนำให้ผู้ค้าปลีกแชร์รายการหมวดหมู่ของตน (retailer_taxonomy) ทั้งนี้ ควรเพิ่มหมวดหมู่ในรูปแบบ "หมวดหมู่:" เช่น "หมวดหมู่:หนังสือ"

หากใช้คอลัมน์ประเภทนี้ ผู้ค้าปลีกต้องระบุค่าสำหรับ สามารถรวมคอลัมน์หลายคอลัมน์ที่มีรูปแบบนี้ได้ในไฟล์ TSV
subClassName (จำเป็นสำหรับการขายแบบไขว้บนเว็บไซต์เท่านั้น)ชื่อของประเภทย่อยหรือหมวดหมู่ที่ผลิตภัณฑ์นั้นถูกจัดให้อยู่ ตัวอย่างเช่น ผลิตภัณฑ์เนยอาจถูกจัดอยู่ในประเภทย่อย 'ขนมปัง' แต่ไม่อยู่ในประเภท 'ผ้าพันแผล' การแบ่งประเภทนี้ช่วยให้สามารถกำหนดเป้าหมายผลิตภัณฑ์ได้ดีขึ้น
xSellSubClassName (จำเป็นสำหรับการขายแบบไขว้บนเว็บไซต์เท่านั้น)ชื่อของคลาสย่อย/หมวดหมู่ที่ผลิตภัณฑ์ที่เกี่ยวข้องสามารถกำหนดเป้าหมายผลิตภัณฑ์ภายใน
custom_payload (ไม่บังคับ - ในเว็บไซต์เฉพาะสำหรับการบูรณาการเท่านั้น ซึ่งผู้ค้าปลีกจะได้รับข้อมูลเมตาที่กำหนดเองเพิ่มเติมเพื่อแสดงผลิตภัณฑ์)ฟิลด์นี้มีเพย์โหลดกำหนดเองที่ควรถูกเธรดผ่านไปยังการสร้างโฆษณา

ค่าสำหรับคอลัมน์นี้จะต้องเป็นอ็อบเจ็กต์ JSON ที่ถูกต้อง ซึ่งถูกแปลงเป็นอาร์เรย์ไบต์และเข้ารหัสแบบ Base64
PRODUCT_REVIEW_COUNT (ไม่บังคับ)จำนวนรีวิวออนไลน์ปัจจุบันสำหรับผลิตภัณฑ์นี้
PRODUCT_RATING_COUNT (ไม่บังคับ)จำนวนคะแนนออนไลน์ปัจจุบันสำหรับผลิตภัณฑ์นี้
PRODUCT_RATING_AVERAGE (ไม่บังคับ)คะแนนเฉลี่ยปัจจุบันสำหรับผลิตภัณฑ์นี้
COLLECTION_ID (ไม่บังคับ)ID สำหรับคอลเลกชันที่ผลิตภัณฑ์นั้นอยู่ (เช่น เครื่องแต่งกาย ซีรีส์ ฯลฯ) ผลิตภัณฑ์ทั้งหมดในคอลเลกชันเดียวกันควรใช้ ID คอลเลกชันเดียวกัน
COLLECTION_TYPE (ไม่บังคับ)ประเภทสำหรับคอลเลกชั่นที่ผลิตภัณฑ์นั้นอยู่ (เช่น เครื่องแต่งกาย ซีรีส์ ฯลฯ) ผลิตภัณฑ์ทั้งหมดในคอลเลกชันเดียวกันควรใช้ ID คอลเลกชันเดียวกัน
COLLECTION_IMAGE_URL (ไม่บังคับ)URL ของภาพที่แสดงคอลเลกชันนี้
COLLECTION_URL (ไม่บังคับ)URL ของเพจบนเว็บไซต์ของคุณที่มีคอลเลกชันนี้
เพศ (ไม่บังคับ)เพศ (ชาย, หญิง, เด็กชาย, เด็กหญิง, ไม่ทราบ) ที่เชื่อมโยงกับผลิตภัณฑ์นี้
ขนาดขนาดผลิตภัณฑ์นี้
CUSTOMPRODUCT_ATTRIBUTE#ฟิลด์แบบกำหนดเองซึ่งมีข้อมูลที่เฉพาะเจาะจงสำหรับธุรกิจของคุณ ทำงานร่วมกับวิศวกรบูรณาการลูกค้าของคุณเพื่อกำหนดเนื้อหาของฟิลด์นี้ หรือเพื่อดูว่าจำเป็นต้องมีฟิลด์เพิ่มเติมหรือไม่

แชร์ไฟล์ TSV ของคุณ

หลังอัปเดตไฟล์ TSV ด้วยฟิลด์ที่จำเป็นทั้งหมดแล้ว ให้แชร์ไฟล์ดังกล่าวกับวิศวกรบูรณาการลูกค้าของ Epsilon (CIE) ของคุณ นอกจากนี้ ให้ระบุรายละเอียดต่อไปนี้พร้อมกับไฟล์

  • ที่อยู่อีเมลติดต่อข้อมูล
  • ระเบียนส่วนหัวสําหรับแต่ละไฟล์
  • แจ้งทีม Epsilon ว่ามีการส่งไฟล์และรวมจํานวนแถวสําหรับแต่ละไฟล์