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

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

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

ดูความแตกต่างอย่างละเอียดระหว่างเวอร์ชัน 6 และ 7 ได้ที่บันทึกประจำรุ่น

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

การย้ายข้อมูลไปยังไฟล์ข้อมูลที่มีโครงสร้าง 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 โดยใช้ API ของ Display & Video 360 ให้ตั้งค่าช่อง version ของเนื้อหาคำขอเป็น SDF_VERSION_7

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

ในเวอร์ชัน 7 อัปเดตพื้นที่รหัสที่บางคอลัมน์ใช้อยู่ให้แยกไฟล์ข้อมูลที่มีโครงสร้างออกจากผลิตภัณฑ์ Entity Read Files ที่เลิกใช้งานแล้วและปรับให้สอดคล้องกับเครื่องมือที่รองรับ เช่น 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 ของแหล่งข้อมูล API ของ Display & Video 360 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 ของแหล่งข้อมูล API ของ Display & Video 360 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 ของแหล่งข้อมูล API ของ Display & Video 360 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 ของแหล่งข้อมูล API ของ Display & Video 360 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 เรายังได้เริ่มต้นการเปลี่ยนแปลงแบบผิวเผิน ซึ่งน่าจะช่วยให้คุณผสานรวมได้ง่ายขึ้นและเลิกใช้ไฟล์อ่านเอนทิตีที่เลิกใช้งานแล้วสำหรับการอ้างอิง

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

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

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

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

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

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

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