เรียกข้อมูลบรรทัดรายการ YouTube & Partners

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

หน้านี้อธิบายวิธีใช้ Display & Video 360 API เพื่อระบุแหล่งข้อมูลของ YouTube และพาร์ทเนอร์ รวมถึงดึงข้อมูลการกําหนดเป้าหมายที่เกี่ยวข้อง และวิธีสร้างและอัปเดตแหล่งข้อมูลของ YouTube และพาร์ทเนอร์หลายรายการพร้อมกันโดยใช้ไฟล์ Structured Data (SDF) ใน UI

ระบุแหล่งข้อมูลของ YouTube และพาร์ทเนอร์

แหล่งข้อมูลของ YouTube และพาร์ทเนอร์ประกอบด้วยรายการโฆษณาบางประเภท กลุ่มโฆษณา และโฆษณา

รายการโฆษณา

รายการโฆษณาที่มีค่า LineItemType ต่อไปนี้คือรายการโฆษณา YouTube และพาร์ทเนอร์ และสร้างหรืออัปเดตไม่ได้

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

คุณสามารถเรียกข้อมูลการตั้งค่าเฉพาะสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์ได้จากช่อง youtubeAndPartnersSettings ของแหล่งข้อมูล LineItem

กลุ่มโฆษณาและโฆษณา YouTube

กลุ่มโฆษณาและโฆษณา YouTube เป็นทรัพยากรย่อยภายใต้รายการโฆษณา YouTube และพาร์ทเนอร์ที่อนุญาตให้ระบุรายละเอียดเพิ่มเติมได้

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

เรียกข้อมูลการกำหนดเป้าหมาย

การกำหนดเป้าหมายที่ใช้เพื่อแสดงโฆษณา YouTube และพาร์ทเนอร์จะกำหนดที่ระดับผู้ลงโฆษณา ระดับรายการโฆษณา และระดับกลุ่มโฆษณา

การกำหนดเป้าหมาย YouTube และพาร์ทเนอร์ที่รับค่าจากทรัพยากรหลักจะไม่แสดงในการตั้งค่าการกำหนดเป้าหมายของทรัพยากรย่อยตามมาตรฐานสำหรับทรัพยากรที่ไม่ใช่ของ YouTube และพาร์ทเนอร์

หากต้องการเรียกข้อมูลการกำหนดเป้าหมายทั้งหมดที่เกี่ยวข้องกับการแสดงโฆษณา YouTube และพาร์ทเนอร์ คุณต้องดำเนินการดังนี้

• เรียกข้อมูลการกำหนดเป้าหมายที่กำหนดให้กับผู้ลงโฆษณาหลักโดยใช้ advertisers.listAssignedTargetingOptions
• เรียกข้อมูลการกำหนดเป้าหมายที่กำหนดให้กับรายการโฆษณาหลักโดยใช้ advertisers.lineItems.bulkListAssignedTargetingOptions
• และดึงข้อมูลการกำหนดเป้าหมายที่กำหนดให้กับกลุ่มโฆษณาหลักโดยใช้ advertisers.adGroups.bulkListAssignedTargetingOptions

พยายามแก้ไขการกำหนดเป้าหมายบน YouTube

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

• การกําหนดเป้าหมายที่กําหนดไว้ที่ระดับใดก็ได้ของประเภทการกําหนดเป้าหมายต่อไปนี้ TARGETING_TYPE_SESSION_POSITION, TARGETING_TYPE_YOUTUBE_CHANNEL และ TARGETING_TYPE_YOUTUBE_VIDEO
• การกำหนดเป้าหมายที่กำหนดให้กับแหล่งข้อมูลรายการโฆษณา YouTube และพาร์ทเนอร์
• การกำหนดเป้าหมายที่กำหนดให้กับทรัพยากร AdGroup

สร้างและอัปเดตโดยใช้การอัปโหลด UI SDF

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

แหล่งข้อมูลเหล่านี้แสดงใน SDF ผ่านรูปแบบไฟล์รายการโฆษณา กลุ่มโฆษณา YouTube และโฆษณา YouTube

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