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

อัปเดตล่าสุด: 18-10-2023

คู่มือนี้จะอธิบายขั้นตอนการย้ายข้อมูลไปยังไฟล์ Structured Data (SDF) v7 จากเวอร์ชันก่อนหน้า รวมถึงการเปลี่ยนแปลงทั้งที่จำเป็นและแนะนำที่คุณทําได้เพื่อเพิ่มประสิทธิภาพการผสานรวมให้ดียิ่งขึ้น

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

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

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

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

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

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

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

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

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

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

อัปเดตรหัสในคอลัมน์ที่ต้องกรอก

ใน v7 เราได้อัปเดตพื้นที่รหัสที่ใช้โดยคอลัมน์ชุดย่อยเพื่อแยกไฟล์ Structured Data ออกจากผลิตภัณฑ์ไฟล์การอ่านเอนทิตีที่เลิกใช้งานแล้ว และเพื่อปรับให้สอดคล้องกับเครื่องมือที่รองรับเพิ่มเติม เช่น Display & Video 360 API

ส่วนนี้จะแสดงทุกคอลัมน์ที่ใช้รหัสที่แตกต่างจาก v6 และวิธีการดึงข้อมูลอ้างอิงเกี่ยวกับค่าใหม่

ใบสั่งซื้อการใส่โฆษณา

วิธีการย้ายข้อมูลคอลัมน์ใน v7

การกําหนดเป้าหมายแอป - ยกเว้น

การกําหนดเป้าหมายแอป - รวม

คอลัมน์เหล่านี้ได้รับการอัปเดตให้ใช้ตัวระบุแอปตามรูปแบบ "App Platform:App ID" ตัวอย่างเช่น "APP:com.google.android.gm", "APP:422689480" และ "ANDROID_TV_APP:com.google.android.youtube.tvunplugged"

ระบบจะระบุแพลตฟอร์มแอปด้วยค่าสตริง รหัสแอปคือรหัสที่แพลตฟอร์มที่เกี่ยวข้องระบุ เช่น รหัส App Bundle จาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple

การกำหนดเป้าหมายเบราว์เซอร์ - ยกเว้น

การกำหนดเป้าหมายเบราว์เซอร์ - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล TargetingOption targetingOptionId ใน Display & Video 360 API ในส่วนการกำหนดเป้าหมาย TARGETING_TYPE_BROWSER

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

การกำหนดเป้าหมายจากผู้ให้บริการ - ยกเว้น

การกำหนดเป้าหมายจากผู้ให้บริการ - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล TargetingOption targetingOptionId ใน Display & Video 360 API ในส่วนการกำหนดเป้าหมาย TARGETING_TYPE_CARRIER_AND_ISP

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

การกำหนดเป้าหมายช่องทาง - ยกเว้น

การกำหนดเป้าหมายช่องทาง - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Channel channelId ใน Display & Video 360 API

เรียกข้อมูลแหล่งข้อมูล Channel ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ advertisers.channels และ partners.channels

การกำหนดอุปกรณ์เป้าหมาย - ยกเว้น

การกำหนดอุปกรณ์เป้าหมาย - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Display & Video 360 API TargetingOption ประเภทการกำหนดเป้าหมายต่อไปนี้ targetingOptionId

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

วัดช่อง DAR

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Channel channelId ใน Display & Video 360 API

เรียกข้อมูลแหล่งข้อมูล Channel ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ advertisers.channels และ partners.channels

การกำหนดเป้าหมายเว็บไซต์ - ยกเว้น

การกำหนดเป้าหมายเว็บไซต์ - รวม

 คอลัมน์นี้ได้รับการอัปเดตเพื่อระบุเว็บไซต์ผ่านสตริง URL

รายการโฆษณา

วิธีการย้ายข้อมูลคอลัมน์ใน v7

การกําหนดเป้าหมายแอป - ยกเว้น

การกําหนดเป้าหมายแอป - รวม

คอลัมน์เหล่านี้ได้รับการอัปเดตให้ใช้ตัวระบุแอปตามรูปแบบ "App Platform:App ID" ตัวอย่างเช่น "APP:com.google.android.gm", "APP:422689480" และ "ANDROID_TV_APP:com.google.android.youtube.tvunplugged"

ระบบจะระบุแพลตฟอร์มแอปด้วยค่าสตริง รหัสแอปคือรหัสที่แพลตฟอร์มที่เกี่ยวข้องระบุ เช่น รหัส App Bundle จาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple

ตัวคูณราคาเสนอ

คอลัมน์นี้ได้รับการอัปเดตให้ใช้รหัสเกณฑ์ใหม่สำหรับประเภทแถวแอปและเว็บไซต์

อัปเดตประเภทแถว app ให้ใช้ค่าสตริงที่ต่อเชื่อมกันของแพลตฟอร์มแอปและรหัสแพลตฟอร์มแอป โดยคั่นด้วยโคลอนสำหรับรหัสเกณฑ์ ระบบจะระบุแพลตฟอร์มแอปด้วยค่าสตริง รหัสแอปคือรหัสที่แพลตฟอร์มที่เกี่ยวข้องระบุ เช่น รหัส App Bundle จาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple

อัปเดตประเภทแถว site ให้ใช้สตริง URL เป็นรหัสเกณฑ์

การกำหนดเป้าหมายเบราว์เซอร์ - ยกเว้น

การกำหนดเป้าหมายเบราว์เซอร์ - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล TargetingOption targetingOptionId ใน Display & Video 360 API ในส่วนการกำหนดเป้าหมาย TARGETING_TYPE_BROWSER

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

การกำหนดเป้าหมายจากผู้ให้บริการ - ยกเว้น

การกำหนดเป้าหมายจากผู้ให้บริการ - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล TargetingOption targetingOptionId ใน Display & Video 360 API ในส่วนการกำหนดเป้าหมาย TARGETING_TYPE_CARRIER_AND_ISP

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

การกำหนดเป้าหมายช่องทาง - ยกเว้น

การกำหนดเป้าหมายช่องทาง - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Channel channelId ใน Display & Video 360 API

เรียกข้อมูลแหล่งข้อมูล Channel ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ advertisers.channels และ partners.channels

การกำหนดอุปกรณ์เป้าหมาย - ยกเว้น

การกำหนดอุปกรณ์เป้าหมาย - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Display & Video 360 API TargetingOption ประเภทการกำหนดเป้าหมายต่อไปนี้ targetingOptionId

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

การกำหนดเป้าหมายเว็บไซต์ - ยกเว้น

การกำหนดเป้าหมายเว็บไซต์ - รวม

 คอลัมน์นี้ได้รับการอัปเดตเพื่อระบุเว็บไซต์ผ่านสตริง URL

ผลิตภัณฑ์สื่อ

วิธีการย้ายข้อมูลคอลัมน์ใน v7

การกำหนดเป้าหมายช่องทาง - ยกเว้น

การกำหนดเป้าหมายช่องทาง - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Channel channelId ใน Display & Video 360 API

เรียกข้อมูลแหล่งข้อมูล Channel ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ advertisers.channels และ partners.channels

การกำหนดอุปกรณ์เป้าหมาย - รวม

คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่าของแหล่งข้อมูล Display & Video 360 API TargetingOption ประเภทการกำหนดเป้าหมายต่อไปนี้ targetingOptionId

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

เรียกข้อมูลแหล่งข้อมูล TargetingOption ทีละรายการหรือเป็นรายการแบบแบ่งหน้าโดยใช้บริการ targetingTypes.targetingOptions

เพิ่มการผสานรวมกับคอลัมน์ที่เพิ่มตั้งแต่เวอร์ชัน 6

หากจะย้ายข้อมูลจาก v6 ไปยัง v7 คุณต้องเพิ่มคอลัมน์ต่อไปนี้ลงในไฟล์ที่เกี่ยวข้อง

ประเภทไฟล์ คอลัมน์
รายการโฆษณา จํานวนความถี่เป้าหมาย TrueView
รายการโฆษณา กรอบเวลาความถี่เป้าหมาย TrueView
กลุ่มโฆษณา YouTube การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ

หากคุณจะย้ายข้อมูลจากไฟล์ Structured Data เวอร์ชันก่อนหน้า โปรดดูข้อมูลเกี่ยวกับคอลัมน์เพิ่มเติมที่เพิ่มระหว่างเวอร์ชันปัจจุบันกับ SDF v6 ในหมายเหตุเกี่ยวกับรุ่นของไฟล์ Structured Data

การเปลี่ยนแปลงเพิ่มเติม

ใน v7 เราได้ทําการเปลี่ยนแปลงบางอย่างที่มองเห็นได้ซึ่งจะช่วยให้คุณผสานรวมได้ง่ายขึ้นและเลิกใช้ไฟล์อ่านเอนทิตีที่เลิกใช้งานแล้วเพื่อใช้อ้างอิง

การจัดเรียงรายการใหม่สำหรับชุดย่อยของคอลัมน์

SDF v7 รับประกันการจัดเรียงคอลัมน์รายการบางคอลัมน์อย่างเสถียรเมื่อสร้างไฟล์ ซึ่งส่งผลให้ลักษณะการทํางานสอดคล้องกันมากขึ้นและการตรวจสอบง่ายขึ้น ระบบจะไม่บังคับใช้การจัดเรียงนี้เมื่ออัปโหลดไฟล์ แต่จะบังคับใช้เมื่อสร้างไฟล์ที่อัปเดตแล้วในภายหลัง

อ่านบันทึกประจำรุ่น v7 เพื่อดูรายการคอลัมน์ทั้งหมดที่สร้างขึ้นตามลําดับตัวเลขหรือตัวอักษรจากน้อยไปมาก

คำแนะนำใหม่เกี่ยวกับข้อมูลอ้างอิงสำหรับบัตรประจำตัว

เราได้อัปเดตคำจำกัดความของคอลัมน์หลายคอลัมน์เพื่อนำการอ้างอิงถึงไฟล์การอ่านเอนทิตีที่เลิกใช้งานออก และขอแนะนำให้ใช้วิธีอื่นในการค้นหารหัสแทน

ค่าที่แสดงผลโดยคอลัมน์ต่อไปนี้จะไม่แตกต่างจากใน SDF v6 แต่เราขอแนะนำให้คุณอัปเดตการผสานรวมเพื่อดึงข้อมูลรหัสโดยใช้วิธีการใหม่ที่แนะนำ ซึ่งดูได้ในคำอธิบายคอลัมน์ v7

ประเภทไฟล์และคอลัมน์ของไฟล์
Campaign
การกำหนดเป้าหมายตามภูมิศาสตร์ - ยกเว้น
การกำหนดเป้าหมายตามภูมิศาสตร์ - รวม
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - ยกเว้น
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - รวม
การกำหนดภาษาเป้าหมาย - ยกเว้น
การกำหนดภาษาเป้าหมาย - รวม
ใบสั่งซื้อการใส่โฆษณา
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - ยกเว้น
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - รวม
การกำหนดเป้าหมายคอลเล็กชันแอป - ยกเว้น
การกำหนดเป้าหมายคอลเล็กชันแอป - รวม
การกำหนดกลุ่มเป้าหมาย - ยกเว้น
การกำหนดกลุ่มเป้าหมาย - รวม
การกำหนดเป้าหมายตามหมวดหมู่ - ยกเว้น
การกำหนดเป้าหมายตามหมวดเนื้อหา - รวม
การกำหนดเป้าหมายตามประเภทเนื้อหา - ยกเว้น
การกําหนดเป้าหมายตามประเภทเนื้อหา - รวม
การกำหนดเป้าหมายรายการที่กำหนดเอง
การกำหนดเป้าหมายตามภูมิศาสตร์ - ยกเว้น
การกำหนดเป้าหมายตามภูมิศาสตร์ - รวม
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - ยกเว้น
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - รวม
การกำหนดเป้าหมายจากรายการคีย์เวิร์ด - ยกเว้น
การกำหนดภาษาเป้าหมาย - ยกเว้น
การกำหนดภาษาเป้าหมาย - รวม
รายการโฆษณา
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - ยกเว้น
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - รวม
การกำหนดเป้าหมายคอลเล็กชันแอป - ยกเว้น
การกำหนดเป้าหมายคอลเล็กชันแอป - รวม
การกำหนดกลุ่มเป้าหมาย - ยกเว้น
การกำหนดกลุ่มเป้าหมาย - รวม
การกำหนดเป้าหมายตามหมวดหมู่ - ยกเว้น
การกำหนดเป้าหมายตามหมวดเนื้อหา - รวม
การกำหนดกลุ่มเป้าหมายแบบรวม
การกำหนดเป้าหมายตามประเภทเนื้อหา - ยกเว้น
การกําหนดเป้าหมายตามประเภทเนื้อหา - รวม
รหัสกิจกรรม Floodlight ของ Conversion
การมอบหมายครีเอทีฟโฆษณา
การกำหนดเป้าหมายรายการที่กำหนดเอง
การกำหนดเป้าหมายตามภูมิศาสตร์ - ยกเว้น
การกำหนดเป้าหมายตามภูมิศาสตร์ - รวม
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - ยกเว้น
การกำหนดเป้าหมายแหล่งที่มาของพื้นที่โฆษณา - รวม
การกำหนดเป้าหมายจากรายการคีย์เวิร์ด - ยกเว้น
การกำหนดภาษาเป้าหมาย - ยกเว้น
การกำหนดภาษาเป้าหมาย - รวม
ผลิตภัณฑ์สื่อ
การกำหนดกลุ่มเป้าหมาย - ยกเว้น
การกำหนดกลุ่มเป้าหมาย - รวม
การกำหนดเป้าหมายตามหมวดหมู่ - ยกเว้น
การกำหนดเป้าหมายตามหมวดเนื้อหา - รวม
การกำหนดเป้าหมายตามภูมิศาสตร์ - รวม
การกำหนดภาษาเป้าหมาย - ยกเว้น
การกำหนดภาษาเป้าหมาย - รวม
กลุ่มโฆษณา YouTube
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - ยกเว้น
การกำหนดเป้าหมายตามผู้สนใจและการกำหนดเป้าหมายที่มีแผนจะซื้อ - รวม
การกำหนดกลุ่มเป้าหมาย - ยกเว้น
การกำหนดกลุ่มเป้าหมาย - รวม
การกำหนดเป้าหมายตามหมวดหมู่ - ยกเว้น
การกำหนดเป้าหมายตามหมวดเนื้อหา - รวม
การกำหนดเป้าหมายรายการที่กำหนดเอง