API แบบสดสำหรับพ็อดการแทรกโฆษณาแบบไดนามิก

API การแทรกโฆษณาแบบไดนามิกช่วยให้คุณขอและติดตามสตรีมแบบสดของ DAI ได้

บริการ: dai.google.com

URI ทั้งหมดสัมพันธ์กับ https://dai.google.com

วิธีการ: สตรีม

เมธอด
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

ลงทะเบียนพ็อด DAI DAI ที่แสดงเซสชันสตรีมแบบสด

คำขอ HTTP

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

พารามิเตอร์เส้นทาง

พารามิเตอร์
network_code string

รหัสเครือข่าย Google Ad Manager ของผู้เผยแพร่โฆษณา

custom_asset_key string

ตัวระบุที่กำหนดเองที่เชื่อมโยงกับเหตุการณ์นี้ใน Google Ad Manager

เนื้อหาของคำขอ

เนื้อหาของคำขอเป็นประเภท application/x-www-form-urlencoded และมี พารามิเตอร์ต่อไปนี้

พารามิเตอร์
พารามิเตอร์การกำหนดเป้าหมายของ DFP ไม่บังคับ พารามิเตอร์การกำหนดเป้าหมายเพิ่มเติม
ลบล้างพารามิเตอร์ของสตรีม ไม่บังคับ ลบล้างค่าเริ่มต้นของพารามิเตอร์การสร้างสตรีม
การตรวจสอบสิทธิ์ HMAC ไม่บังคับ ตรวจสอบสิทธิ์โดยใช้โทเค็นที่ใช้ HMAC

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีออบเจ็กต์ Stream ใหม่

Open Measurement

DAI API มีข้อมูลสำหรับการยืนยัน Open Measurement ในองค์ประกอบ Verifications ช่องนี้มีอย่างน้อย 1 ช่อง องค์ประกอบ Verification ที่แสดงทรัพยากรและข้อมูลเมตาที่จำเป็นต่อการดำเนินการ โค้ดการวัดของบุคคลที่สามเพื่อยืนยันการเล่นครีเอทีฟโฆษณา เฉพาะ รองรับ JavaScriptResource สำหรับข้อมูลเพิ่มเติม โปรดดู IAB Tech Lab และ ข้อกำหนดของ VAST 4.1

วิธีการ: กลุ่มพ็อด

เมธอด
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}/profile/{profile_name}/{segment_number}.{segment_format}

สร้างสตรีม DAI สำหรับรหัสเหตุการณ์ที่ระบุ

คำขอ HTTP

GET https://dai.google.com//linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}/profile/{profile_name}/{segment_number}.{segment_format}

พารามิเตอร์เส้นทาง

พารามิเตอร์
network_code string

รหัสเครือข่าย Google Ad Manager ของผู้เผยแพร่โฆษณา

custom_asset_key string

ตัวระบุที่กำหนดเองที่เชื่อมโยงกับเหตุการณ์นี้ใน Google Ad Manager

pod_id integer

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

ชื่อ จาก ที่ขอ โปรไฟล์การเข้ารหัส DAI ของ Google Ad Manager โปรไฟล์การเข้ารหัสต้องเป็นหนึ่งในโปรไฟล์การเข้ารหัสที่กำหนดค่าไว้สำหรับ เหตุการณ์ที่เลือก

segment_number integer

ดัชนีของกลุ่มที่ขอภายในพ็อดโฆษณาปัจจุบัน โดยเริ่มต้น ที่ศูนย์
segment_format string

นามสกุลไฟล์ที่เชื่อมโยงกับรูปแบบกลุ่มที่ขอ ส่วนขยายที่ยอมรับ ได้แก่ ts, mp4 vtt, aac, ac3 หรือ eac3

พารามิเตอร์การค้นหา

พารามิเตอร์
stream_id จำเป็น string

รหัสสตรีมสำหรับเซสชันของผู้ใช้ปัจจุบัน ค่านี้ส่งคืนโดย คำขอที่ส่งไปยังปลายทาง stream ได้สำเร็จ
sd required1 integer

ระยะเวลาของกลุ่มที่ขอ หน่วยเป็นมิลลิวินาที
so ไม่บังคับ

ออฟเซ็ตของกลุ่มที่ขอภายในพ็อดโฆษณาเป็นมิลลิวินาที หากคุณไม่ใส่พารามิเตอร์ so พารามิเตอร์ดังกล่าวจะคำนวณโดย คูณระยะเวลาของกลุ่มด้วยหมายเลขกลุ่ม
pd ต้องระบุ2 integer

ระยะเวลาของพ็อดโฆษณาเป็นมิลลิวินาที
auth-token จำเป็น string

ข้อความที่เข้ารหัสและเข้ารหัส URL โทเค็น HMAC สำหรับพ็อดโฆษณาปัจจุบัน
last ไม่บังคับ boolean

ระบุกลุ่มสุดท้ายในช่วงพักโฆษณา ละเว้นพารามิเตอร์นี้สำหรับ กลุ่มอื่นๆ
scte35 ไม่บังคับ string

สัญญาณ SCTE-35 ที่เข้ารหัสฐาน 64 สำหรับช่วงพักโฆษณานี้
cust_params ไม่บังคับ string

ชุดคู่คีย์-ค่าที่ใช้สำหรับการกำหนดเป้าหมายแคมเปญ Ad Manager เหล่านี้ ต้องแสดงเป็นสตริงคำค้นหาที่เข้ารหัส URL

ตัวอย่างเช่น
พารามิเตอร์
  • ส่วน = sports
  • หน้า = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

เชิงอรรถ

  1. ไม่จำเป็นต้องใช้ sd สำหรับกลุ่มการเริ่มต้น ↩
  2. ไม่จำเป็นต้องระบุ pd สำหรับเหตุการณ์ที่มีโฆษณาแบบไม่มีระยะเวลา เปิดใช้ช่วงพักโฆษณาแล้ว ↩

เนื้อหาการตอบกลับ

หากสำเร็จ เนื้อหาการตอบสนองจะเป็นกลุ่มสตรีมที่เล่นได้ซึ่งตรงกับ และพารามิเตอร์ที่ระบุในคำขอ

วิธีการ: เทมเพลตระยะเวลาพ็อด DASH

เมธอด
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

ขอเทมเพลตระยะเวลา DASH จาก Google Ad Manager เทมเพลตนี้ มีมาโครที่คุณต้องป้อนข้อมูลด้วยพารามิเตอร์สตรีม ครั้งเดียว จะมีการป้อนข้อมูลมาโครเหล่านี้ เทมเพลตจะกลายเป็นช่วงช่วงพักโฆษณา สามารถต่อเข้ากับไฟล์ Manifest DASH ได้

คำขอ HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

พารามิเตอร์เส้นทาง

พารามิเตอร์
network_code string

รหัสเครือข่าย Google Ad Manager ของผู้เผยแพร่โฆษณา

custom_asset_key string

ตัวระบุที่กำหนดเองที่เชื่อมโยงกับเหตุการณ์นี้ใน Google Ad Manager

พารามิเตอร์การค้นหา

พารามิเตอร์
stream_id จำเป็น string

รหัสสตรีมสำหรับเซสชันของผู้ใช้ปัจจุบัน ค่านี้ส่งคืนโดย คำขอที่ส่งไปยังปลายทาง stream ได้สำเร็จ

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีพารามิเตอร์ PodTemplateResponse

วิธีการ: การยืนยันสื่อ

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

คำขอที่ส่งไปยังปลายทาง media verification เป็นนิจพล

เมธอด
media verification GET /{media_verification_url}/{ad_media_id}

แจ้งเตือน API ของเหตุการณ์การยืนยันสื่อ

คำขอ HTTP

GET https://{media-verification-url}/{ad-media-id}

เนื้อหาการตอบกลับ

media verification จะแสดงการตอบกลับต่อไปนี้

  • HTTP/1.1 204 No Content หากการยืนยันสื่อสำเร็จและคำสั่ง ping ทั้งหมด ที่คุณส่งไป
  • HTTP/1.1 404 Not Found หากคำขอไม่สามารถยืนยันสื่อเนื่องจาก การจัดรูปแบบ URL ที่ไม่ถูกต้องหรือการหมดอายุ
  • HTTP/1.1 404 Not Found หากเคยส่งคำขอการยืนยันสำหรับบัตรประจำตัวนี้มาก่อนหน้านี้ สำเร็จ
  • HTTP/1.1 409 Conflict หากคำขออื่นส่งคําสั่ง ping ที่นี้แล้ว

รหัสสื่อโฆษณา

ตัวระบุสื่อโฆษณาจะเข้ารหัสในแทร็กข้อมูลเมตาแยกต่างหาก — โดยมีการกำหนดเวลา ข้อมูลเมตาสำหรับสตรีมการรับส่ง HLS หรือ emsg สำหรับไฟล์ mp4 ตัวระบุสื่อโฆษณา จะเริ่มต้นด้วยสตริง google_ เสมอ

ควรเติมเนื้อหาข้อความทั้งหมดของรายการข้อมูลเมตาต่อท้ายโฆษณา URL การยืนยันก่อนที่จะส่งคำขอการยืนยันโฆษณาแต่ละคำขอ

วิธีการ: ข้อมูลเมตา

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

เมธอด
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

เรียกข้อมูลข้อมูลเมตาของโฆษณา

คำขอ HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

เนื้อหาการตอบกลับ

หากสำเร็จ การตอบกลับจะแสดงอินสแตนซ์ PodMetadata

การแยกวิเคราะห์ข้อมูลเมตา

ข้อมูลเมตามี 3 ส่วนแยกกัน ได้แก่ tags, ads และโฆษณา breaks รายการ ชี้ไปที่ข้อมูลคือส่วน tags แล้วทำซ้ำผ่านแท็ก และค้นหารายการแรกที่มีชื่อเป็นคำนำหน้าสำหรับ รหัสสื่อโฆษณาในสตรีมวิดีโอ ตัวอย่างเช่น คุณสามารถ อาจมีรหัสสื่อโฆษณาที่มีลักษณะดังนี้

google_1234567890

จากนั้นคุณจะเห็นออบเจ็กต์แท็กที่ชื่อ google_12345 ในกรณีนี้ ตรงกับ รหัสสื่อโฆษณา เมื่อคุณพบออบเจ็กต์คำนำหน้าของสื่อโฆษณาที่ถูกต้องแล้ว รหัสโฆษณา รหัสช่วงพักโฆษณา และประเภทเหตุการณ์ จากนั้นจะมีการใช้รหัสโฆษณาเพื่อจัดทำดัชนี ใช้ออบเจ็กต์ ads รายการและรหัสช่วงพักโฆษณาในการจัดทำดัชนีออบเจ็กต์ breaks

ข้อมูลการตอบกลับ

สตรีม

สตรีมใช้เพื่อแสดงรายการทรัพยากรสำหรับสตรีมที่สร้างขึ้นใหม่ใน JSON
การแสดง JSON
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
ช่อง
stream_id string

ตัวระบุสตรีม GAM
media_verification_url string

URL การยืนยันสื่อที่ใช้เป็นปลายทางฐานสำหรับการติดตามเหตุการณ์การเล่น
metadata_url string

URL ของข้อมูลเมตาที่ใช้ในการสำรวจข้อมูลเป็นระยะเกี่ยวกับเหตุการณ์โฆษณาสตรีมที่กำลังจะมาถึง
session_update_url string

URL อัปเดตของเซสชันที่ใช้อัปเดตพารามิเตอร์การกำหนดเป้าหมายสำหรับสตรีมนี้ ระบบจะบันทึกค่าเดิมสำหรับพารามิเตอร์การกำหนดเป้าหมายระหว่างคำขอสร้างสตรีมเริ่มต้น
heartbeat_url string

URL ฮาร์ตบีต ซึ่งใช้เพื่อให้สตรีมการบีคอนฝั่งเซิร์ฟเวอร์ยังคงใช้งานได้ และต้องใช้คำสั่ง ping ทุก {PollingFrequency} วินาที ป้อนข้อมูลสําหรับสตรีมการบีคอนฝั่งเซิร์ฟเวอร์
polling_frequency number

ความถี่ในการสำรวจ (หน่วยเป็นวินาที) เมื่อขอmetadata_url หรือ cardbeat_url
pod_manifest_url string

เทมเพลต URL ไฟล์ Manifest ของพ็อดจะใช้ในการสร้าง URL เพื่อเรียกไฟล์ Manifest ของพ็อดของสตรีม สอดคล้องกับ URL ของเพลย์ลิสต์เวอร์ชันแปรผันหลายตัวแปรใน HLS หรือ MPD ใน DASH ป้อนข้อมูลสําหรับเหตุการณ์สตรีมแบบสดของประเภทการแทรกโฆษณาแบบไดนามิก POD_SERVING_MANIFEST https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

ไฟล์ Manifest คือรูปแบบของไฟล์ Manifest ที่ดึงมาจาก pod_manifest_url ขีดกลางหรือ hls ก็ได้

PodMetadata

PodMetadata มีข้อมูลเมตาในโฆษณา ช่วงพักโฆษณา และแท็กรหัสสื่อ
การแสดง JSON
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
ช่อง
tags map[string, object(TagSegment)]

แผนที่แสดงส่วนแท็กที่จัดทำดัชนีโดยคำนำหน้าแท็ก
ads map[string, object(Ad)]

แผนที่โฆษณาที่จัดทำดัชนีตามรหัสโฆษณา
ad_breaks map[string, object(AdBreak)]

แผนที่ช่วงพักโฆษณาซึ่งจัดทำดัชนีตามรหัสช่วงพักโฆษณา

TagSegment

กลุ่มแท็กมีการอ้างอิงถึงโฆษณา ช่วงพักโฆษณา และประเภทเหตุการณ์ กลุ่มแท็กที่มี type="progress" ไม่ควรใช้คำสั่ง ping ไปยังสื่อโฆษณา ปลายทางการยืนยัน
การแสดง JSON
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
ช่อง
ad string

รหัสโฆษณาของแท็กนี้
ad_break_id string

รหัสช่วงพักโฆษณาของแท็กนี้
type string

ประเภทเหตุการณ์ของแท็กนี้

AdBreak

AdBreak อธิบายช่วงพักโฆษณาเดียวในสตรีม โดยประกอบด้วยระยะเวลา ประเภท (ช่วงกลาง/ก่อน/หลัง) และจำนวนโฆษณา
การแสดง JSON
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
ช่อง
type string

ประเภทช่วงพักโฆษณาที่ใช้ได้ ได้แก่ ตอนต้น ตอนกลาง และตอนท้าย
duration number

ระยะเวลาโฆษณาทั้งหมดของช่วงพักโฆษณานี้เป็นวินาที
expected_duration number

ระยะเวลาที่คาดไว้ของช่วงพักโฆษณา (เป็นวินาที) รวมถึงโฆษณาทั้งหมดและแถบสเลททั้งหมด
ads number

จำนวนโฆษณาในช่วงพักโฆษณา
โฆษณาอธิบายโฆษณาในสตรีม
การแสดง JSON
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
ช่อง
ad_break_id string

รหัสช่วงพักโฆษณาของโฆษณานี้
position number

ตำแหน่งของโฆษณานี้ในช่วงพักโฆษณา โดยเริ่มที่ 1
duration number

ระยะเวลาของโฆษณา หน่วยเป็นวินาที
title string

ชื่อที่ไม่บังคับของโฆษณา
description string

คำอธิบายเพิ่มเติมของโฆษณา
advertiser string

ตัวระบุผู้ลงโฆษณาที่ไม่บังคับ
ad_system string

ระบบโฆษณาที่ไม่บังคับ
ad_id string

รหัสโฆษณาที่ไม่บังคับ
creative_id string

รหัสครีเอทีฟโฆษณาที่ไม่บังคับ
creative_ad_id string

รหัสโฆษณาครีเอทีฟโฆษณาที่ไม่บังคับ
deal_id string

รหัสดีลที่ไม่บังคับ
clickthrough_url string

URL การคลิกผ่านที่ไม่บังคับ
click_tracking_urls string

URL ติดตามการคลิกที่ไม่บังคับ
verifications [object(Verification)]

รายการการยืนยัน Open Measurement ที่ไม่บังคับซึ่งจะแสดงรายการทรัพยากร และข้อมูลเมตาที่จำเป็นสำหรับการเรียกใช้โค้ดการวัดของบุคคลที่สามเพื่อยืนยัน ในการเล่นครีเอทีฟโฆษณา
slate boolean

บูลีนที่ไม่บังคับที่ระบุว่ารายการปัจจุบันคือแถบสเลท
icons [object(Icon)]

รายการไอคอน ละเว้นหากว่างเปล่า
wrappers [object(Wrapper)]

รายการ Wrapper หากว่างเปล่า
universal_ad_id object(UniversalAdID)

รหัสโฆษณาสากล (ไม่บังคับ)
extensions string

รายการที่ไม่บังคับของ <Extension> ทั้งหมด ใน VAST
companions [object(Companion)]

โฆษณาที่แสดงร่วมกัน (ไม่บังคับ) ที่อาจแสดงพร้อมกับโฆษณานี้
interactive_file object(InteractiveFile)

ครีเอทีฟโฆษณาแบบอินเทอร์แอกทีฟ (SIMID) ที่ไม่บังคับซึ่งควรแสดงระหว่างการเล่นโฆษณา

PodTemplateResponse

PodTemplateResponse แสดงเพย์โหลด JSON ที่ส่งไปยัง VTP สำหรับการต่อพ็อด
การแสดง JSON
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
ช่อง
dash_period_template string

DashPeriodTemplate คือเทมเพลต XML สำหรับระยะเวลาที่จะกรอกข้อมูลที่เหมาะสมก่อนต่อ
segment_duration_ms int64

SegmentDurationMS คือระยะเวลาของกลุ่มระยะเวลาในหน่วยมิลลิวินาที

Icon

ไอคอนมีข้อมูลเกี่ยวกับไอคอน VAST
การแสดง JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
ช่อง
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData มีข้อมูลเกี่ยวกับการคลิกผ่านไอคอน
การแสดง JSON
{
  "url": string,
}
ช่อง
url string

FallbackImage

FallbackImage มีข้อมูลเกี่ยวกับรูปภาพทางเลือก VAST
การแสดง JSON
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
ช่อง
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Wrapper มีข้อมูลเกี่ยวกับโฆษณา Wrapper และไม่มี รหัสดีล หากมี
การแสดง JSON
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
ช่อง
system string

ตัวระบุระบบโฆษณา
ad_id string

รหัสโฆษณาที่ใช้สำหรับโฆษณา Wrapper
creative_id string

รหัสครีเอทีฟโฆษณาที่ใช้สำหรับโฆษณา Wrapper
creative_ad_id string

รหัสโฆษณาที่ใช้สำหรับโฆษณา Wrapper
deal_id string

รหัสดีลที่ไม่บังคับสำหรับโฆษณา Wrapper

การยืนยัน

การยืนยันมีข้อมูลสำหรับ Open Measurement ซึ่งช่วยให้ การวัดการมองเห็นโฆษณาและการยืนยันโดยบุคคลที่สาม ปัจจุบันรองรับเฉพาะทรัพยากร JavaScript เท่านั้น ดู https://iabtechlab.com/standards/open-measurement-sdk/
การแสดง JSON
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
ช่อง
vendor string

ผู้ให้บริการตรวจสอบ
java_script_resources [object(JavaScriptResource)]

รายการทรัพยากร JavaScript สำหรับการยืนยัน
tracking_events [object(TrackingEvent)]

รายการเหตุการณ์การติดตามสำหรับการยืนยัน
parameters string

สตริงที่คลุมเครือที่ส่งไปยังรหัสยืนยัน Bootstrap

JavaScriptResource

JavaScriptResource มีข้อมูลสำหรับการยืนยันผ่าน JavaScript
การแสดง JSON
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
ช่อง
script_url string

URL ไปยังเพย์โหลด JavaScript
api_framework string

APIFramework คือชื่อของเฟรมเวิร์กวิดีโอที่ใช้องค์ประกอบ รหัสยืนยัน
browser_optional boolean

สามารถเรียกใช้สคริปต์นี้ภายนอก เบราว์เซอร์

TrackingEvent

TrackingEvent มี URL ที่ไคลเอ็นต์ควรใช้คำสั่ง ping ใน เท่านั้น
การแสดง JSON
{
  "event": string,
  "uri": string,
}
ช่อง
event string

ประเภทของเหตุการณ์การติดตาม
uri string

เหตุการณ์การติดตามที่จะใช้คำสั่ง ping

UniversalAdID

UniversalAdID ใช้เพื่อจัดเตรียมตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกัน และดูแลได้ทั่วทั้งระบบโฆษณา
การแสดง JSON
{
  "id_value": string,
  "id_registry": string,
}
ช่อง
id_value string

รหัสโฆษณาสากลของครีเอทีฟโฆษณาที่เลือกสำหรับโฆษณานั้น
id_registry string

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

Companion

โฆษณาที่แสดงร่วมมีข้อมูลสำหรับโฆษณาที่แสดงร่วมซึ่งอาจแสดงอยู่ พร้อมกับโฆษณา
การแสดง JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
ช่อง
click_data object(ClickData)

ข้อมูลการคลิกสำหรับโฆษณาที่แสดงร่วมนี้
creative_type string

แอตทริบิวต์ CreativeType ใน <StaticResource> ใน VAST หาก นี่เป็นการแสดงร่วมของประเภทคงที่
height int32

ความสูงเป็นพิกเซลของโฆษณาที่แสดงร่วมนี้
width int32

ความกว้างเป็นพิกเซลของโฆษณาที่แสดงร่วมนี้
resource string

สำหรับการแสดงร่วมแบบคงที่และ iframe นี่คือ URL ที่จะโหลดและ แสดงอยู่ สำหรับการแสดงร่วม HTML นี่คือข้อมูลโค้ด HTML ที่ควร แสดงเป็นโฆษณาที่แสดงร่วม
type string

ประเภทของการแสดงร่วมนี้ ซึ่งอาจเป็นแบบคงที่, iframe หรือ HTML
ad_slot_id string

รหัสช่องโฆษณาสำหรับโฆษณาที่แสดงร่วมนี้
api_framework string

เฟรมเวิร์ก API สำหรับโฆษณาที่แสดงร่วมนี้
tracking_events [object(TrackingEvent)]

รายการเหตุการณ์การติดตามสำหรับโฆษณาที่แสดงร่วมนี้

InteractiveFile

InteractiveFile มีข้อมูลสำหรับครีเอทีฟโฆษณาแบบอินเทอร์แอกทีฟ (เช่น SIMID) ซึ่งควรแสดงระหว่างการเล่นโฆษณา
การแสดง JSON
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
ช่อง
resource string

URL ไปยังครีเอทีฟโฆษณาแบบอินเทอร์แอกทีฟ
type string

ประเภท MIME ของไฟล์ที่ระบุเป็นทรัพยากร
variable_duration boolean

ครีเอทีฟโฆษณานี้อาจขอให้ขยายระยะเวลาออกไปหรือไม่
ad_parameters string

ค่าของ <AdParameters> ใน VAST