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

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

หน้านี้อธิบายวิธีใช้ Display & Video 360 API เพื่อระบุแหล่งข้อมูลของ YouTube และพาร์ทเนอร์ และดึงข้อมูลการกำหนดเป้าหมายที่เกี่ยวข้อง รวมถึงวิธีสร้างและอัปเดตแหล่งข้อมูลของ YouTube และพาร์ทเนอร์แบบเป็นกลุ่มโดยใช้ไฟล์ข้อมูลที่มีโครงสร้าง (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 และพาร์ทเนอร์ได้ทีละหลายรายการโดยใช้การอัปโหลดไฟล์ข้อมูลที่มีโครงสร้าง (SDF) ผ่าน UI ของ Display & Video 360

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

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