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

Entity Read Files (ERF) คือการแสดงแทน JSON ของออบเจ็กต์แคมเปญของพาร์ทเนอร์ที่พร้อมใช้งานผ่าน Google Cloud Storage

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

คู่มือนี้จะอธิบายวิธีย้ายข้อมูลจากไฟล์การอ่านเอนทิตีไปยัง Display & Video 360 API โดยทำดังนี้

  • อธิบายภาพรวมของความแตกต่างระหว่างอินเทอร์เฟซ 2 รูปแบบ
  • การเปรียบเทียบตาราง 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

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

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

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

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

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

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

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

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

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

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

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

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

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

คุณสามารถเรียกข้อมูล Display & Video 360 ผ่านคําขอ API โดยตรง หรือนําเข้าไปยัง BigQuery โดยอัตโนมัติก็ได้

คําขอ API โดยตรง

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

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

เพิ่มประสิทธิภาพการดึงข้อมูลทรัพยากร

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

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

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

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

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

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

ช่องโหว่ของข้อมูล 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 is BUDGET_UNIT_IMPRESSIONS
budget.max_spend_advertiser_micros LineItem.budget.maxAmount ฟิลด์หาก LineItem.budget.budgetUnit is 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 ไม่พร้อมใช้งาน