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

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

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

ดูบันทึกประจำรุ่นเพื่อดูรายการความแตกต่างระหว่าง v6 และ v7 โดยละเอียด

ย้ายเวอร์ชันของไฟล์ข้อมูลที่มีโครงสร้าง

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

อัปเดตเวอร์ชันไฟล์ข้อมูลที่มีโครงสร้าง

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

อัปเดตการตั้งค่าทรัพยากรระดับบนสุด

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

ตั้งค่าในอินเทอร์เฟซ

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

ไปที่พาร์ทเนอร์ที่ต้องการ ไปที่หน้ารายละเอียดพื้นฐานใต้เมนูการตั้งค่าพาร์ทเนอร์ในการนำทางด้านซ้าย อัปเดตการกำหนดค่าเวอร์ชัน SDF ในส่วนไฟล์ข้อมูลที่มีโครงสร้างเป็น v7

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

ไปที่ผู้ลงโฆษณาที่ต้องการ ไปที่หน้ารายละเอียดพื้นฐานใต้เมนูการตั้งค่าผู้ลงโฆษณาในการนำทางด้านซ้าย อัปเดตการกำหนดค่าเวอร์ชัน SDF ในส่วนไฟล์ข้อมูลที่มีโครงสร้างเป็น 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

อัปเดตรหัสในคอลัมน์ที่จำเป็น

ในเวอร์ชัน 7 มีการอัปเดตพื้นที่รหัสที่ใช้โดยส่วนย่อยของคอลัมน์เพื่อแยกไฟล์ข้อมูลที่มีโครงสร้างออกจากผลิตภัณฑ์ไฟล์การอ่านเอนทิตีที่เลิกใช้งานแล้ว แล้วปรับให้สอดคล้องกับเครื่องมือที่รองรับ เช่น 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" แพลตฟอร์มแอปจะระบุโดยค่าสตริง รหัสแอปคือรหัสที่ได้รับจากแพลตฟอร์มที่เกี่ยวข้อง เช่น รหัสชุดจาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple
การกำหนดเป้าหมายเบราว์เซอร์ - ยกเว้น การกำหนดเป้าหมายเบราว์เซอร์ - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_BROWSER แล้ว เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
การกำหนดเป้าหมายจากผู้ให้บริการ - ยกเว้น การกำหนดเป้าหมายจากผู้ให้บริการ - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_CARRIER_AND_ISP แล้ว เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
การกำหนดเป้าหมายแชแนล - ยกเว้น การกำหนดเป้าหมายแชแนล - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า channelId ของทรัพยากร Display & Video 360 API Channel แล้ว เรียกข้อมูลทรัพยากร Channel ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ advertisers.channels และ partners.channels
การกำหนดอุปกรณ์เป้าหมาย - ยกเว้น การกำหนดอุปกรณ์เป้าหมาย - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ภายใต้ประเภทการกำหนดเป้าหมายต่อไปนี้ TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
วัดช่อง DAR	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า channelId ของทรัพยากร Display & Video 360 API Channel แล้ว เรียกข้อมูลทรัพยากร 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" แพลตฟอร์มแอปจะระบุโดยค่าสตริง รหัสแอปคือรหัสที่ได้รับจากแพลตฟอร์มที่เกี่ยวข้อง เช่น รหัสชุดจาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple
ตัวคูณราคาเสนอ	คอลัมน์นี้ได้รับการอัปเดตให้ใช้รหัสเกณฑ์ใหม่สำหรับประเภทแถวแอปและเว็บไซต์ ประเภทแถวแอปได้รับการอัปเดตให้ใช้ค่าสตริงที่เชื่อมต่อของแพลตฟอร์มแอปและรหัสแพลตฟอร์มแอป โดยคั่นด้วยโคลอนสำหรับรหัสเกณฑ์ แพลตฟอร์มแอปจะระบุโดยค่าสตริง รหัสแอปคือรหัสที่ได้รับจากแพลตฟอร์มที่เกี่ยวข้อง เช่น รหัสชุดจาก Play Store ของ Android หรือรหัสแอปจาก App Store ของ Apple อัปเดตประเภทแถวเว็บไซต์เพื่อใช้สตริง URL เป็นรหัสเกณฑ์แล้ว
การกำหนดเป้าหมายเบราว์เซอร์ - ยกเว้น การกำหนดเป้าหมายเบราว์เซอร์ - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_BROWSER แล้ว เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
การกำหนดเป้าหมายจากผู้ให้บริการ - ยกเว้น การกำหนดเป้าหมายจากผู้ให้บริการ - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_CARRIER_AND_ISP แล้ว เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
การกำหนดเป้าหมายแชแนล - ยกเว้น การกำหนดเป้าหมายแชแนล - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า channelId ของทรัพยากร Display & Video 360 API Channel แล้ว เรียกข้อมูลทรัพยากร Channel ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ advertisers.channels และ partners.channels
การกำหนดอุปกรณ์เป้าหมาย - ยกเว้น การกำหนดอุปกรณ์เป้าหมาย - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ภายใต้ประเภทการกำหนดเป้าหมายต่อไปนี้ TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions
การกำหนดไซต์เป้าหมาย - ยกเว้น การกำหนดเป้าหมายเว็บไซต์ - รวม	คอลัมน์นี้ได้รับการอัปเดตเพื่อระบุเว็บไซต์ผ่านสตริง URL

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

วิธีการย้ายข้อมูล v7 สำหรับคอลัมน์
การกำหนดเป้าหมายแชแนล - ยกเว้น การกำหนดเป้าหมายแชแนล - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า channelId ของทรัพยากร Display & Video 360 API Channel แล้ว เรียกข้อมูลทรัพยากร Channel ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ advertisers.channels และ partners.channels
การกำหนดอุปกรณ์เป้าหมาย - รวม	คอลัมน์นี้ได้รับการอัปเดตให้ใช้ค่า targetingOptionId ของทรัพยากร API ของ Display & Video 360 TargetingOption ภายใต้ประเภทการกำหนดเป้าหมายต่อไปนี้ TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM เรียกข้อมูลทรัพยากร TargetingOption ทีละรายการหรือในรายการที่ใส่เลขหน้าโดยใช้บริการ targetingTypes.targetingOptions

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

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

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

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

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

นอกจากนี้ ในเวอร์ชัน 7 เรายังได้ทำการเปลี่ยนแปลงผิวเผินด้วย ซึ่งอาจช่วยให้คุณผสานรวมได้ง่ายขึ้นและเลิกใช้ Entity Read Files ที่เลิกใช้งานแล้วเพื่ออ้างอิง

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

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

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

คำแนะนำข้อมูลอ้างอิงรหัสใหม่

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

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

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