ย้ายข้อมูลไปยังไฟล์ข้อมูลที่มีโครงสร้าง v8

อัปเดตล่าสุด: 12-11-2024

คู่มือนี้จะแนะนำคุณตลอดกระบวนการย้ายข้อมูลจากการใช้ Structured Data ไฟล์เวอร์ชัน 7.1 ไปยังเวอร์ชัน 8 และอธิบายการเปลี่ยนแปลงระหว่าง 2 เวอร์ชันที่อาจส่งผลต่อการผสานรวม

ดูรายการความแตกต่างทั้งหมดระหว่าง v7.1 กับ v8 ได้ในบันทึกประจำรุ่น

ย้ายข้อมูลเวอร์ชันไฟล์ Structured Data

วิธีย้ายข้อมูลไปยังไฟล์ Structured Data (SDF) เวอร์ชัน 8 จากเวอร์ชันก่อนหน้า

  1. อัปเดตทรัพยากรและการดําเนินการในการสร้าง SDF เพื่อใช้ v8
  2. อัปเดตตรรกะทรัพยากรโฆษณาเพื่อระบุประเภทเมื่อสร้าง
  3. เพิ่มตรรกะใหม่สำหรับการอ่าน การสร้าง และการอัปเดตทรัพยากร Demand Gen

อัปเดตเวอร์ชันไฟล์ Structured Data

หากต้องการใช้ไฟล์ Structured Data เวอร์ชันใหม่ ให้อัปเดตเวอร์ชันที่กำหนดในแหล่งข้อมูลของพาร์ทเนอร์และผู้ลงโฆษณาหลัก และใช้เวอร์ชันใหม่เมื่อสร้างงานการดาวน์โหลดแต่ละรายการใน Display & Video 360 API

อัปเดตการตั้งค่าทรัพยากรหลัก

ระบบจะตั้งค่าเวอร์ชันไฟล์ Structured Data เริ่มต้นที่ระดับทรัพยากรของพาร์ทเนอร์และผู้ลงโฆษณา ระบบจะใช้เวอร์ชันนี้เป็นค่าเริ่มต้นเมื่อดาวน์โหลดไฟล์ Structured Data ผ่านอินเทอร์เฟซหรือ API

กำหนดในอินเทอร์เฟซ

ที่ระดับพาร์ทเนอร์

  1. ไปที่พาร์ทเนอร์ที่ต้องการ
  2. ขยายเมนูการตั้งค่าพาร์ทเนอร์ในการนําทางด้านซ้ายมือ แล้วไปที่หน้ารายละเอียดพื้นฐาน
  3. อัปเดตการกำหนดค่าเวอร์ชัน SDF ในส่วนไฟล์ Structured Data เป็น v8

ที่ระดับผู้ลงโฆษณา

  1. ไปที่ผู้ลงโฆษณาที่ต้องการ
  2. ขยายเมนูการตั้งค่าผู้ลงโฆษณาในการนําทางด้านซ้าย แล้วไปที่หน้ารายละเอียดพื้นฐาน
  3. อัปเดตการกำหนดค่าเวอร์ชัน SDF ในส่วนไฟล์ Structured Data เป็น v8 หากตั้งค่าเวอร์ชันเริ่มต้นที่ระดับพาร์ทเนอร์ คุณอาจแก้ไขการตั้งค่านี้ไม่ได้
ตั้งค่าใน API
ที่ระดับพาร์ทเนอร์
คุณไม่สามารถตั้งค่าเวอร์ชัน SDF เริ่มต้นที่ระดับพาร์ทเนอร์ใน API
ที่ระดับผู้ลงโฆษณา
ส่งคำขอ advertisers.patch เพื่ออัปเดต dataAccessConfig.sdfConfig.sdfConfig.version เป็น SDF_VERSION_8 และหากจำเป็น ให้อัปเดต dataAccessConfig.sdfConfig.overridePartnerSdfConfig เป็น True

อัปเดตคำขอ sdfdownloadtasks.create ใน API

เมื่อส่งคําขอ sdfdownloadtasks.create โดยใช้ Display & Video 360 API ให้ตั้งค่าช่อง version ของเนื้อหาคําขอเป็น SDF_VERSION_8

ระบุประเภทในแหล่งข้อมูลโฆษณา

v8 จะเพิ่มคอลัมน์ Ad Type ลงในไฟล์ Ad ซึ่งแสดงประเภทโฆษณาที่แต่ละแถวแสดง คอลัมน์ใหม่นี้ต้องระบุและระบบจะป้อนข้อมูลสำหรับทรัพยากรที่มีอยู่เมื่อดาวน์โหลดไฟล์โฆษณา v8

เมื่ออัปเดตโฆษณาที่มีอยู่ คุณไม่ควรเปลี่ยนค่าของคอลัมน์นี้

เมื่อสร้างโฆษณาใหม่ คุณต้องป้อนค่าใดค่าหนึ่งจากค่าที่ระบุไว้ในคำอธิบายคอลัมน์ในคอลัมน์นี้

อัปเดตตรรกะสําหรับทรัพยากร Demand Gen

v8 รองรับการสร้าง การเรียกข้อมูล และการอัปเดตแคมเปญ Demand Gen โดยใช้ไฟล์รายการโฆษณา กลุ่มโฆษณา และโฆษณา แหล่งข้อมูล Demand Gen ใช้ตรรกะที่แตกต่างกันในการยืนยันการประทับเวลา กำหนดให้มีการป้อนข้อมูลคอลัมน์เพิ่มเติม และถูกจำกัดด้วยข้อจำกัดใหม่ในไฟล์ทั้ง 3 ประเภท

การยืนยันการประทับเวลา

สําหรับรายการโฆษณาที่ไม่ใช่ Demand Gen ทั้งหมด ระบบจะป้อนข้อมูลคอลัมน์ Timestamp ของไฟล์ Line Item เมื่อดาวน์โหลดพร้อมระบุเวลาที่แก้ไขรายการโฆษณาครั้งล่าสุด ระบบจะใช้ค่านี้เมื่ออัปเดตรายการโฆษณาโดยใช้ SDF เพื่อยืนยันว่ารายการโฆษณาไม่มีการอัปเดตนับตั้งแต่มีการดาวน์โหลดไฟล์ต้นฉบับ ไม่เช่นนั้นการอัปเดตจะไม่สำเร็จ

สําหรับรายการโฆษณา Demand Gen คอลัมน์ Timestamp และการยืนยันที่มาพร้อมกับรายการโฆษณาจะทํางานแตกต่างกัน สําหรับรายการโฆษณา Demand Gen คอลัมน์จะแสดงเวลาปัจจุบันเมื่อดาวน์โหลด เมื่ออัปโหลด Display & Video 360 จะตรวจสอบว่าเวลาผ่านไปนานกว่า 24 ชั่วโมงนับจากการประทับเวลาที่กำหนดหรือไม่ หากผ่านไปนานกว่า 24 ชั่วโมง ระบบจะถือว่ารายการไฟล์ต้นฉบับล้าสมัยและการอัปเดตจะดำเนินการไม่สำเร็จ หากเกิดกรณีเช่นนี้ ให้ดาวน์โหลดไฟล์อีกครั้งและทำการอัปเดตตามเวอร์ชันล่าสุด วิธีการยืนยันใหม่นี้ไม่ได้ป้องกันไม่ให้คุณเขียนทับการเปลี่ยนแปลงที่เกิดขึ้นในช่วง 24 ชั่วโมงที่ผ่านมา โปรดใส่เฉพาะบรรทัดรายการ Demand Gen ที่ต้องการอัปเดตในไฟล์ที่อัปโหลดเพื่อหลีกเลี่ยงการเขียนทับโดยไม่ตั้งใจ

คอลัมน์ที่จำเป็น

ไฟล์ประเภทต่อไปนี้มีคอลัมน์ที่จําเป็นสำหรับทรัพยากร Demand Gen บางรายการ นอกเหนือจากคอลัมน์ที่จําเป็นสําหรับเอนทิตีทั้งหมดของไฟล์ประเภทนั้น

รายการโฆษณา
คอลัมน์ที่จําเป็นสําหรับรายการต่อไปนี้ บรรทัดรายการ ค่าคอลัมน์ Type
Demand Gen
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
คอลัมน์ที่จําเป็นสําหรับค่าคอลัมน์ต่อไปนี้ โฆษณา Ad Type
ภาพสไลด์ Demand Gen
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
รูปภาพ Demand Gen
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
ผลิตภัณฑ์ Demand Gen
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
วิดีโอ Demand Gen
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

ข้อจำกัดที่อัปเดต

นอกจากคอลัมน์ที่ต้องระบุใหม่สําหรับรายการโฆษณาและโฆษณา Demand Gen บางรายการแล้ว คอลัมน์หลายคอลัมน์ในไฟล์รายการโฆษณา กลุ่มโฆษณา และโฆษณายังมีข้อจํากัดในการใช้งานใหม่ที่ใช้กับทรัพยากร Demand Gen

ข้อจํากัดเหล่านี้มีจํานวนมากและเจาะจงกับคอลัมน์ที่เป็นปัญหา ดังนั้นคู่มือนี้จึงไม่ได้ระบุรายการข้อจํากัดทั้งหมด เราขอแนะนําให้คุณอ่านเอกสารอ้างอิง v8 อย่างละเอียดสําหรับประเภทไฟล์รายการโฆษณา กลุ่มโฆษณา และโฆษณาก่อนสร้างหรืออัปเดตทรัพยากร Demand Gen โดยใช้การอัปโหลด SDF