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

ไฟล์การอ่านเอนทิตี (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

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

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

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

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

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

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

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

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

• ขอบเขตที่จําเป็น ต่างจาก 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

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

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

• บริการโอนข้อมูล BigQuery คืออะไร
• กำหนดเวลาการโอน Display & Video 360
• การเปลี่ยนรูปแบบข้อมูล 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	ไม่พร้อมใช้งาน
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	ไม่พร้อมใช้งาน

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.bulkListAssignedTargetingOptions

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	FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId
ชื่อ	FirstPartyAndPartnerAudience.displayName
data_partner_id	ไม่พร้อมใช้งาน
accessing_advertisers	ไม่พร้อมใช้งาน
partner_pricing	ไม่พร้อมใช้งาน
advertiser_pricings	ไม่พร้อมใช้งาน