ย้ายข้อมูลจากไฟล์การอ่านของเอนทิตี

ไฟล์การอ่านเอนทิตี (ERF) คือการแสดงไฟล์ JSON ของออบเจ็กต์แคมเปญของพาร์ทเนอร์ซึ่งสร้างขึ้นตามคำขอทุกวันและพร้อมใช้งานผ่าน Google Cloud Storage

ERF เลิกใช้งานแล้วในเดือนมิถุนายน 2021 ตั้งแต่วันที่ 31 ตุลาคม 2024 เป็นต้นไป ERF จะหยุดให้บริการอย่างเป็นทางการและจะไม่สร้างอีกต่อไป เราขอแนะนำให้ผู้ใช้ไฟล์การอ่านเอนทิตีที่มีอยู่ทั้งหมดเปลี่ยนไปใช้ Display & Video 360 API เพื่อเรียกข้อมูลทรัพยากร Display & Video 360 ต่อไป

คู่มือนี้อธิบายวิธีย้ายข้อมูลจาก Entity Read Files ไปยัง Display & Video 360 API โดย

  • นำเสนอภาพรวมความแตกต่างระหว่างอินเทอร์เฟซทั้งสอง
  • การเปรียบเทียบตาราง ERF กับบริการ API
  • ให้คำแนะนำเกี่ยวกับการดึงข้อมูลเอนทิตีผ่าน API
  • การรับรู้ช่องว่างของข้อมูลที่มีอยู่
  • การนำเสนอการแมปฟิลด์ ERF ทั้งหมดกับช่องแหล่งข้อมูล API ที่เปรียบเทียบกันได้

ภาพรวม

เมื่อย้ายข้อมูลจาก ERF ไปยัง Display & Video 360 API จะมีข้อแตกต่างสำคัญหลายประการที่ควรพิจารณา ได้แก่

  • ความใหม่ของข้อมูล ทั้งนี้ ระบบจะสร้าง ERF ขึ้นทุกวันพร้อมกันเป็นจำนวนมาก ในขณะที่ API จะดึงทรัพยากรเวอร์ชันล่าสุด
  • โครงสร้างทรัพยากร API ใช้โครงสร้าง JSON ที่แตกต่างจาก ERF เพื่อแสดงถึงทรัพยากรประเภทเดียวกัน ทรัพยากรบางอย่าง เช่น การตั้งค่าการกำหนดเป้าหมายสาธารณะ อาจใช้พื้นที่รหัสที่แตกต่างกัน
  • วิธีดึงข้อมูล Display & Video 360 API จะเปิดเฉพาะการดึงข้อมูลทรัพยากรทีละรายการ ในรายการที่แบ่งหน้า หรือผ่านการโอนข้อมูล BigQuery ซึ่งแตกต่างจากไฟล์ JSON แบบข้อมูลดิบที่ ERF มีให้
  • ขอบเขต ทรัพยากร API ส่วนใหญ่จะกำหนดขอบเขตด้วยรหัสผู้ลงโฆษณา ซึ่งตรงข้ามกับ ERF ซึ่งกำหนดขอบเขตด้วยรหัสพาร์ทเนอร์ ทรัพยากรที่รวมอยู่ในคำตอบจะจำกัด เฉพาะทรัพยากรภายในขอบเขตนั้นๆ

การนำเสนอข้อมูล ERF ใน API

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

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

ข้อมูลสาธารณะ

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

เมื่อใช้ Display & Video 360 API คุณจะเรียกดูข้อมูลอ้างอิงการกำหนดเป้าหมายผ่านบริการ targetingTypes.targetingOptions ได้ บริการนี้มีรหัสและรายละเอียดของตัวเลือกการกำหนดเป้าหมายสำหรับประเภทการกำหนดเป้าหมายเฉพาะ เช่นเดียวกับตารางสาธารณะ ดูหน้าตั้งค่าการกำหนดเป้าหมายที่มีอยู่เพื่อดูตัวอย่างโค้ดที่แสดงการดึงข้อมูลรหัสตัวเลือกการกำหนดเป้าหมาย

ตารางสาธารณะและ SDF

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

ตั้งแต่ v7 เป็นต้นไป พื้นที่รหัสที่ใช้โดยคอลัมน์ไฟล์ข้อมูลที่มีโครงสร้างบางส่วนจะได้รับการอัปเดตเพื่อแยก SDF จาก ERF และสอดคล้องกับ API ของ Display & Video 360 มากขึ้น ดูข้อมูลเพิ่มเติมในคำแนะนำในการย้ายข้อมูล v7 และเอกสารอ้างอิง

ทรัพยากรส่วนตัว

ตารางส่วนตัวของ ERF จะแสดงภาพรวมรายวันของการตั้งค่าปัจจุบันของทรัพยากรส่วนตัวที่พาร์ทเนอร์เป็นเจ้าของ เนื่องจากมีทรัพยากรมากมายที่สร้างขึ้นภายใต้พาร์ทเนอร์รายเดียวได้ ไฟล์เหล่านี้อาจมีขนาดใหญ่และยากต่อการดาวน์โหลดและประมวลผล

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

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

การดึงข้อมูลเอนทิตีใน API

ทรัพยากร Display & Video 360 จะดึงข้อมูลได้ผ่านคำขอ API โดยตรงหรือการนำเข้าโดยอัตโนมัติไปยัง BigQuery

คำขอ API โดยตรง

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

  • ขอบเขตที่จำเป็น ทรัพยากรส่วนใหญ่ใน API จะกำหนดขอบเขตโดยผู้ลงโฆษณา ซึ่งแตกต่างจาก ERF ที่กำหนดขอบเขตโดยพาร์ทเนอร์ การดึงทรัพยากรทุกประเภท เช่น รายการโฆษณา ภายใต้พาร์ทเนอร์รายหนึ่งอาจต้องส่งคำขอรายการทีละรายการสำหรับผู้ลงโฆษณารายย่อยแต่ละรายของพาร์ทเนอร์รายนั้น ข้อยกเว้นดังกล่าวรวมถึงรายการย่อยโดยตรงของพาร์ทเนอร์ เช่น ผู้ลงโฆษณาและช่องที่เป็นของพาร์ทเนอร์
  • การใส่เลขหน้า เมธอดรายการ API ใช้การแบ่งหน้าเพื่อรับประกันว่าการตอบกลับจะอยู่ในขนาดที่เหมาะสม โดยจํากัดการตอบกลับคำขอแต่ละรายการส่วนใหญ่ หรือหน้าหนึ่งๆ ให้มีทรัพยากรได้สูงสุด 100 รายการ หากจำนวนทรัพยากรที่เกี่ยวข้องมากกว่าขนาดหน้าเว็บ จะต้องมีการเรียกรายการติดต่อกันเพื่อดึงหน้าต่อๆ มาของการตอบกลับรายการทั้งหมด ตัวอย่างโค้ดของการแบ่งหน้ารายการตอบกลับอยู่ในส่วนหนึ่งของหน้าคู่มือการกำหนดเป้าหมายเกี่ยวกับการเรียกตัวเลือกการกำหนดเป้าหมายที่มีให้
  • ต้องมีคำขอเพิ่มเติมสําหรับการดึงข้อมูลการกำหนดเป้าหมาย การตั้งค่าการกำหนดเป้าหมายของทรัพยากรจะไม่รวมอยู่ในออบเจ็กต์ API JSON แต่เป็นทรัพยากรย่อยที่เรียกว่าตัวเลือกการกำหนดเป้าหมายที่กำหนดแทน โดยจะต้องดึงทรัพยากรย่อยเหล่านี้ผ่านคำขอแยกต่างหาก ตัวอย่างเช่น สำหรับรายการโฆษณาแต่ละรายการที่ดึงมาผ่านคำขอ advertisers.lineItems.list จะต้องมีคำขอ advertisers.lineItems.bulkListAssignedTargetingOptions แยกต่างหากเพื่อดึงข้อมูลการกำหนดเป้าหมายทั้งหมด

เพิ่มประสิทธิภาพการเรียกทรัพยากร

Display & Video 360 API อาจต้องใช้คำขอหลายรายการเพื่อดึงข้อมูลจำนวนเท่ากันที่มีในไฟล์อ่านเอนทิตีเดียว การเพิ่มประสิทธิภาพวิธีเรียกทรัพยากรจะช่วยให้เรียกข้อมูลที่คุณต้องการได้อย่างมีประสิทธิภาพมากขึ้น ดังนี้

  • ส่งคำขอไปยัง API พร้อมกัน Display & Video 360 API ปกป้องโครงสร้างพื้นฐานโดยใช้คำขอต่อผู้ลงโฆษณาต่อขีดจำกัดอัตราโปรเจ็กต์ โครงสร้างโควต้านี้ช่วยให้คุณนำโซลูชันแบบมัลติเทรดไปใช้กับผู้ลงโฆษณาหลายรายได้ ซึ่งจะลดเวลาที่ใช้ในการเรียกทรัพยากรที่จำเป็นทั้งหมด แม้ว่าการแบ่งหน้าจะกำหนดให้ทรัพยากรทั้งหมดประเภทหนึ่งภายในขอบเขตหนึ่งๆ ต้องถูกดึงผ่านการเรียกใช้ติดต่อกัน แต่การดึงข้อมูลทรัพยากรภายในขอบเขตอื่นหรือประเภทอื่นจะทำได้พร้อมกัน
  • ใช้ตัวกรองและเรียงลำดับตามพารามิเตอร์ในการเรียกใช้ลิสต์เพื่อดึงเฉพาะทรัพยากรที่เกี่ยวข้องเท่านั้น เช่น หากสนใจเฉพาะรายการโฆษณาที่มีการอัปเดตในวันที่ผ่านมา คุณจะใช้พารามิเตอร์ filter ของเมธอด advertisers.lineItems.list เพื่อแสดงรายการโฆษณาที่มี updateTime มากกว่าการประทับเวลาที่ระบุได้ ซึ่งจะช่วยลดจำนวนคำขอที่จำเป็นได้อย่างมาก
  • แคชรหัสที่ใช้เป็นประจำเพื่อหลีกเลี่ยงคำขอ API ที่ไม่จำเป็น ข้อมูลอ้างอิงบางอย่าง เช่น รหัสตัวเลือกการกำหนดเป้าหมายและรหัสกลุ่มเป้าหมายของ Google ค่อนข้างเสถียรและเก็บรักษาไว้อย่างปลอดภัยเพื่อหลีกเลี่ยงไม่ให้ต้องดึงข้อมูลทุกครั้งที่ใช้ อย่างไรก็ตาม คุณควรตรวจสอบค่าที่แคชไว้ทุกสัปดาห์เพื่อพิจารณาการเปลี่ยนแปลงหรือการเลิกใช้งานที่ไม่บ่อยนัก

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเข้าถึง API ของ Display & Video 360 อย่างมีประสิทธิภาพได้ในคู่มือการเพิ่มประสิทธิภาพโควต้า

นำเข้าไปยัง BigQuery

เครื่องมือเชื่อมต่อ BigQuery API ของ Display & Video 360 ช่วยให้คุณนำเข้าการกำหนดค่าทรัพยากร Display & Video 360 มายัง BigQuery โดยตรงโดยอัตโนมัติในแต่ละวันได้ ระบบจะจัดเก็บการกำหนดค่าไว้ใน BigQuery โดยใช้การออกแบบทรัพยากร API ของ Display & Video 360 ระบบรองรับทรัพยากร API บางส่วน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เครื่องมือเชื่อมต่อ BigQuery สำหรับ API ของ Display & Video 360 ได้ที่เอกสารประกอบเกี่ยวกับระบบคลาวด์ต่อไปนี้

ช่องว่างของข้อมูล API ที่รู้จัก

คุณอาจพบช่องว่างของข้อมูลที่สำคัญเมื่อย้ายข้อมูลจาก ERF ไปยัง Display & Video 360 API เช่น

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

ภาคผนวก: การจับคู่ฟิลด์ ERF กับ API

การแมปตารางสาธารณะ

ตารางด้านล่างแมปช่องของตารางสาธารณะ ERF กับช่องประเภทการกำหนดเป้าหมายและตัวเลือกการกำหนดเป้าหมายที่มีอยู่ใน Display & Video 360 API แม้ว่าค่าของช่องหนึ่งอาจจับคู่กับอีกช่องหนึ่ง แต่ไม่ได้รับประกันว่าช่องดังกล่าวจะใช้ข้อมูลประเภทเดิม ค่า Enum หรือพื้นที่รหัสเดียวกัน

คอลเล็กชันแอป

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_APP_CATEGORY

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId
ชื่อ TargetingOption.appCategoryDetails.displayName

เบราว์เซอร์

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_BROWSER

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId
is_mobile ไม่พร้อมใช้งาน
ชื่อ TargetingOption.browserDetails.displayName

DataPartner

ไม่มีทรัพยากรหรือฟิลด์ที่เทียบเท่าใน Display & Video 360 API

DeviceCriteria

เรียกข้อมูลได้ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_OPERATING_SYSTEM, TARGETING_TYPE_DEVICE_MAKE_MODEL และ TARGETING_TYPE_DEVICE_TYPE

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId หรือ DeviceType enum
is_mobile ไม่พร้อมใช้งาน
ชื่อ TargetingOption.operatingSystemDetails.displayName ช่อง TargetingOption.deviceMakeModelDetails.displayName หรือ DeviceType enum โดยขึ้นอยู่กับประเภทการกำหนดเป้าหมาย
criteria_type TargetingOption.targetingType
operating_system_id ไม่พร้อมใช้งาน
mobile_brand_name ไม่พร้อมใช้งาน
mobile_model_name ไม่พร้อมใช้งาน
mobile_make_model_id ไม่พร้อมใช้งาน
device_type DeviceType enum

GeoLocation

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_GEO_REGION

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId
canonical_name TargetingOption.geoRegionDetails.displayName
geo_name ไม่พร้อมใช้งาน
country_code ไม่พร้อมใช้งาน
region_code ไม่พร้อมใช้งาน
city_name ไม่พร้อมใช้งาน
postal_name ไม่พร้อมใช้งาน
dma_code ไม่พร้อมใช้งาน

Isp

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_CARRIER_AND_ISP

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId
is_mobile ไม่พร้อมใช้งาน
ชื่อ TargetingOption.carrierAndIspDetails.displayName
secondary_criteria_id TargetingOption.targetingOptionId

ภาษา

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_LANGUAGE

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id TargetingOption.targetingOptionId
ชื่อ ไม่พร้อมใช้งาน ดูชื่อที่แสดงแบบเต็มของภาษาได้ที่ช่อง TargetingOption.languageDetails.displayName

SiteToPlacementId

ไม่มีทรัพยากรหรือฟิลด์ที่เทียบเท่าใน Display & Video 360 API

SupportedExchange

เรียกข้อมูลได้ภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_EXCHANGE

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id Exchange enum
ชื่อ Exchange enum

UniversalSite

ไม่มีทรัพยากรหรือฟิลด์ที่เทียบเท่าใน Display & Video 360 API คุณสามารถกำหนดเป้าหมายเว็บไซต์และแอปแต่ละรายการได้โดยตรงภายใต้ประเภทการกำหนดเป้าหมาย TARGETING_TYPE_URL และ TARGETING_TYPE_APP ตามลำดับ ใน Display & Video 360 คุณจะกำหนดเป้าหมายแอปหรือ URL ได้ แต่จะไม่สามารถรายงานแอปหรือ URL บางรายการได้ หากต้องการนำแอปและ URL ที่รายงานไม่ได้ออกจากการใช้จ่าย ให้ทำตามวิธีการในศูนย์ช่วยเหลือ DV360

การแมปฟิลด์ตารางส่วนตัว

ตารางด้านล่างแมปช่องตารางส่วนตัวของ ERF กับช่องหรือบริการที่มีอยู่ใน Display & Video 360 API แม้ว่าค่าของช่องหนึ่งอาจจับคู่กับอีกช่องหนึ่ง แต่ไม่ได้รับประกันว่าช่องดังกล่าวจะใช้ประเภทข้อมูล ค่า Enum หรือพื้นที่รหัสเหมือนกัน

ผู้ลงโฆษณา

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id Advertiser.advertiserId
common_data.name Advertiser.displayName
common_data.active Advertiser.entityStatus
common_data.integration_code Advertiser.integrationDetails.integrationCode
partner_id Advertiser.partnerId
currency_code Advertiser.generalConfig.currencyCode
timezone_code Advertiser.generalConfig.timeZone
landing_page_url Advertiser.generalConfig.domainUrl
available_channel_ids ดึงข้อมูลได้ผ่านเมธอด advertisers.channels.list
blacklist_channel_id ดึงข้อมูลได้ผ่านเมธอด advertisers.targetingTypes.assignedtargetingOptions.list ในส่วนประเภทการกำหนดเป้าหมาย TARGETING_TYPE_CHANNEL หาก AssignedTargetingOption.channelDetails.negative เป็นจริง แสดงว่าช่องมีการกำหนดเป้าหมายเชิงลบ
dcm_configuration ไม่พร้อมใช้งาน
dcm_network_id Advertiser.adServerConfig.cmHybridConfig.cmAccountId
dcm_advertiser_id ช่อง Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds จะแสดงรหัสผู้ลงโฆษณา CM360 ที่แชร์การกำหนดค่า CM360 Floodlight
dcm_floodlight_group_id Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId
dcm_syncable_site_ids Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds
enable_oba_tags ไม่พร้อมใช้งาน

Campaign

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id Campaign.campaignId
common_data.name Campaign.displayName
common_data.active Campaign.entityStatus
common_data.integration_code ไม่พร้อมใช้งาน
advertiser_id Campaign.advertiserId
งบประมาณ Campaign.campaignFlight และ Campaign.campaignBudgets
frequency_cap Campaign.frequencyCap
default_target_list ดึงข้อมูลได้ผ่านเมธอด advertisers.campaigns.bulkListCampaignAssignedTargetingOptions
uses_video_creatives ไม่พร้อมใช้งาน
uses_display_creatives ไม่พร้อมใช้งาน
uses_audio_creatives ไม่พร้อมใช้งาน
วัตถุประสงค์ Campaign.campaignGoal.campaignGoalType
เมตริก Campaign.campaignGoal.performanceGoal.performanceGoalType
objective_description Campaign.campaignGoal.performanceGoal.performanceGoalString
metric_amount_micros Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros

ครีเอทีฟโฆษณา

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id Creative.creativeId
common_data.name Creative.displayName
common_data.active Creative.entityStatus
common_data.integration_code Creative.integrationCode
advertiser_id Creative.advertiserId
dcm_placement_id Creative.cmPlacementId
width_pixels Creative.dimensions.widthPixels
height_pixels Creative.dimensions.heightPixels
approval_status Creative.reviewStatus
expanding_direction Creative.expandingDirection
creative_type Creative.creativeType

CustomAffinity

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id CustomList.customListId
ชื่อ CustomList.displayName
คำอธิบาย ไม่พร้อมใช้งาน
advertiser_id ไม่พร้อมใช้งาน

FloodlightActivity

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id FloodlightActivity.floodlightActivityId
common_data.name FloodlightActivity.displayName
common_data.active FloodlightActivity.servingStatus
common_data.integration_code ไม่พร้อมใช้งาน
advertiser_id ช่อง FloodlightActivity.advertiserIds จะแสดงผู้ลงโฆษณาทั้งหมดที่มีสิทธิ์เข้าถึงกิจกรรม Floodlight ภายใต้พาร์ทเนอร์ที่ระบุ
partner_id ซึ่งผู้ใช้ระบุไว้เมื่อส่งคำขอไปยังบริการ floodlightGroups.floodlightActivities
remarketing_enabled ช่อง FloodlightActivity.remarketingConfigs จะแสดงการกำหนดค่านี้สำหรับผู้ลงโฆษณาแต่ละรายที่มีสิทธิ์เข้าถึงกิจกรรม Floodlight ภายใต้พาร์ทเนอร์ที่ระบุ
ssl_required FloodlightActivity.sslRequired

InsertionOrder

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id InsertionOrder.insertionOrderId
common_data.name InsertionOrder.displayName
common_data.active InsertionOrder.entityStatus
common_data.integration_code InsertionOrder.integrationDetails.integrationCode
advertiser_id InsertionOrder.advertiserId
campaign_id InsertionOrder.campaignId
overall_budget ไม่พร้อมใช้งาน คำนวณได้โดยใช้เนื้อหาของช่อง InsertionOrder.budget.budgetSegments
scheduled_segments InsertionOrder.budget.budgetSegments
frequency_cap InsertionOrder.frequencyCap
default_partner_costs InsertionOrder.partnerCosts
default_target_list ดึงข้อมูลได้ผ่านเมธอด advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions

InventorySource

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id InventorySource.inventorySourceId
ไม่ระบุประเภท ไม่พร้อมใช้งาน
inventory_name InventorySource.displayName
exchange_id InventorySource.exchange
accessing_advertisers InventorySource.readWriteAccessors และ InventorySource.readAdvertiserIds
external_id InventorySource.dealId
min_cpm_micros InventorySource.rateDetails.rate.nanos โดยขึ้นอยู่กับค่าของช่อง InventorySource.rateDetails.inventorySourceRateType
min_cpm_currency_code InventorySource.rateDetails.rate.currencyCode

LineItem

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id LineItem.lineItemId
common_data.name LineItem.displayName
common_data.active LineItem.entityStatus
common_data.integration_code LineItem.integrationDetails.integrationCode
line_item_type LineItem.lineItemType
insertion_order_id LineItem.insertionOrderId
creative_ids LineItem.creativeIds
max_cpm_advertiser_micros LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros หรือ LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros ขึ้นอยู่กับแผนกลยุทธ์ที่ใช้
performance_goal LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType หรือ LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType ขึ้นอยู่กับแผนกลยุทธ์ที่ใช้
goal_advertiser_micros LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros
partner_revenue_model LineItem.partnerRevenueModel
cost_tracking_pixels LineItem.conversionCounting.floodlightActivityConfigs
budget.start_time_usec LineItem.flight.dateRange.startDate
budget.end_time_usec LineItem.flight.dateRange.endDate
budget.max_impressions LineItem.budget.maxAmount หาก LineItem.budget.budgetUnit คือ BUDGET_UNIT_IMPRESSIONS
budget.max_spend_advertiser_micros LineItem.budget.maxAmount หาก LineItem.budget.budgetUnit คือ BUDGET_UNIT_CURRENCY
budget.pacing_type LineItem.pacing.pacingPeriod
budget.pacing_max_impressions LineItem.pacing.dailyMaxImpressions
budget.pacing_max_spend_advertiser_micros LineItem.pacing.dailyMaxMicros
budget.pacing_distribution LineItem.pacing.pacingType
frequency_cap LineItem.frequencyCap
partner_costs LineItem.partnerCosts
target_list ดึงข้อมูลได้ผ่านเมธอด advertisers.lineItems.bulkListLineItemAssignedTargetingOptions

NegativeKeywordList

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id NegativeKeywordList.negativeKeywordListId
ชื่อ NegativeKeywordList.displayName
advertiser_id NegativeKeywordList.advertiserId

พาร์ทเนอร์

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
common_data.id Partner.partnerId
common_data.name Partner.displayName
common_data.active Partner.entityStatus
common_data.integration_code ไม่พร้อมใช้งาน
currency_code Partner.generalConfig.currencyCode
exchange_settings Partner.exchangeConfig.enabledExchanges
default_partner_costs ไม่พร้อมใช้งาน
default_partner_revenue ไม่พร้อมใช้งาน
default_target_list ไม่พร้อมใช้งาน

Pixel

ไม่มีทรัพยากรหรือฟิลด์ที่เทียบเท่าใน Display & Video 360 API

UniversalChannel

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id Channel.channelId
ชื่อ Channel.displayName
site_ids เรียกข้อมูลได้ผ่านเมธอด advertisers.channels.sites.list และ partners.channels.sites.list โดยขึ้นอยู่กับประเภทของ owner
accessing_advertisers ไม่พร้อมใช้งาน
is_deleted ไม่พร้อมใช้งาน
is_brand_safe_channel ไม่พร้อมใช้งาน

UserList

ชื่อช่อง ERFความพร้อมใช้งานของ DV360 API
id FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId
ชื่อ FirstAndThirdPartyAudience.displayName
data_partner_id ไม่พร้อมใช้งาน
accessing_advertisers ไม่พร้อมใช้งาน
partner_pricing ไม่พร้อมใช้งาน
advertiser_pricings ไม่พร้อมใช้งาน