ไฟล์ข้อมูลที่มีโครงสร้าง (SDF) คือไฟล์ CSV ที่จัดรูปแบบเป็นพิเศษ ซึ่งช่วยให้ดึงข้อมูล สร้าง และแก้ไขทรัพยากรจำนวนมากใน Display & Video 360 ได้ อัปเดตทรัพยากรหลายรายการพร้อมกันโดยการดาวน์โหลด แก้ไข แล้วอัปโหลด SDF อีกครั้ง
UI ของ Display & Video 360 รองรับการดาวน์โหลดและอัปโหลด SDF Display & Video 360 API รองรับการดาวน์โหลด SDF
รูปแบบ
SDF ใช้รูปแบบพื้นฐาน 2 รูปแบบ ได้แก่ Standard และ QA
- คุณดาวน์โหลดและอัปโหลดไฟล์รูปแบบมาตรฐานได้ ข้อมูลในไฟล์เหล่านี้ อาจใช้รหัสตัวเลขเพื่อให้มั่นใจในความถูกต้องเมื่ออัปโหลด คุณอาจต้องมีข้อมูลอ้างอิง เพื่อตีความข้อมูล
- คุณดาวน์โหลดไฟล์รูปแบบ QA ได้ ไฟล์เหล่านี้มีข้อมูลเหมือนกับ ไฟล์รูปแบบมาตรฐาน แต่ใช้ค่าที่มนุษย์อ่านได้มากขึ้น เช่น บางคอลัมน์อาจใช้ชื่อที่แสดงแทนรหัส คอลัมน์ที่เฉพาะเจาะจงสำหรับรูปแบบนี้จะใช้คำต่อท้าย "Qa"
ประเภทไฟล์
SDF รองรับทรัพยากร 7 ประเภท ทรัพยากรแต่ละประเภทจะมีประเภทไฟล์ของตัวเองพร้อม โครงสร้างคอลัมน์ของตัวเอง ประเภททรัพยากรที่รองรับมีดังนี้
- แคมเปญ
- ใบสั่งซื้อการใส่โฆษณา
- รายการโฆษณา
- กลุ่มโฆษณา
- โฆษณา
- แหล่งที่มาของพื้นที่โฆษณา
- ผลิตภัณฑ์สื่อ
เฉพาะไฟล์ประเภทรายการโฆษณาและกลุ่มโฆษณาเท่านั้นที่รองรับรูปแบบ QA
เราเผยแพร่ SDF เวอร์ชันใหม่เป็นประจำและเลิกใช้งานเวอร์ชันก่อนหน้า เวอร์ชันใหม่จะอัปเดตโครงสร้างคอลัมน์ประเภทไฟล์ หากจำเป็น SDF เวอร์ชันใหม่จะมีคู่มือ การย้ายข้อมูลเมื่อเปิดตัว
ดาวน์โหลดข้อผิดพลาด
การดาวน์โหลด SDF อาจทำให้เกิดข้อผิดพลาด 2 ประเภท ได้แก่ ข้อผิดพลาดการสร้างไฟล์และทรัพยากรที่ข้าม
ข้อผิดพลาดในการสร้างไฟล์
การสร้าง SDF อาจสิ้นสุดลงโดยมีข้อผิดพลาด หากการสร้างล้มเหลวเมื่อใช้ Display & Video 360 API งานที่เสร็จสมบูรณ์จะตั้งค่าฟิลด์ error ด้วยออบเจ็กต์ Status ออบเจ็กต์
Status จะมีข้อความที่อธิบายสาเหตุของข้อผิดพลาด
อ่านเพิ่มเติมเกี่ยวกับข้อผิดพลาดเหล่านี้ได้ในหน้าคำแนะนำเกี่ยวกับข้อผิดพลาดและคำเตือน
ข้อผิดพลาดที่ข้าม
SDF ไม่รองรับทรัพยากรประเภทย่อยทั้งหมด หากรวมทรัพยากรใน SDF ไม่ได้ ระบบจะรวมไฟล์ "ข้าม" (เช่น SDF-LineItems-Skipped.csv) ไว้ในการดาวน์โหลด ไฟล์นี้มีโครงสร้าง 2 คอลัมน์ คอลัมน์แรกระบุ
ทรัพยากรที่ข้าม คอลัมน์ที่ 2 จะอธิบายการยกเว้น
อัปโหลดไฟล์
อัปโหลด SDF โดยใช้ UI ของ Display & Video 360 เพื่อสร้างหรืออัปเดต ทรัพยากรที่มีอยู่
ทำตามขั้นตอนต่อไปนี้เพื่อลดข้อผิดพลาดเมื่ออัปเดตหรือสร้างทรัพยากรด้วย SDF
- ดาวน์โหลด SDF โดยใช้ Display & Video 360 API หรือ UI
- แก้ไขรายการไฟล์ที่มีอยู่เพื่ออัปเดตทรัพยากรที่มีอยู่
- เพิ่มรายการไฟล์เพื่อสร้างทรัพยากรใหม่
- นำรายการที่ไม่ได้อัปเดตหรือเป็นรายการใหม่ ซึ่งจะช่วยลดขนาดไฟล์และ ลดโอกาสในการอัปเดตโดยไม่ตั้งใจ
- อัปโหลดไฟล์ใน UI ของ Display & Video 360
หลังจากอัปโหลดและประมวลผล SDF แล้ว SDF-ResultFile.zipไฟล์จะพร้อมให้
ดาวน์โหลด ไฟล์ ZIP นี้อาจมีไฟล์ 2 ประเภทต่อไปนี้
SDF-{ResourceType}-Updated-ResultFile.csvซึ่งแสดงทรัพยากรที่อัปเดตหรือสร้างสำเร็จแล้วSDF-{ResourceType}-Failed-ResultFile.csvซึ่งแสดงรายการการดำเนินการที่ไม่สำเร็จและ ข้อความแสดงข้อผิดพลาดที่เกี่ยวข้อง
ไฟล์ ZIP อาจมีไฟล์ใดไฟล์หนึ่งหรือทั้ง 2 ไฟล์