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

Dynamic Ad Insertion 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 ใหม่

การวัดผลแบบเปิด

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

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

เมธอด
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/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_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

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

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

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

custom_asset_key string

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

pod_identifier

ระบบรองรับรูปแบบต่อไปนี้

pod/{integer}

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

ad_break_id/{string}

ตัวระบุสตริงของช่วงพักโฆษณาปัจจุบัน
profile_name string

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

segment_number integer

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

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

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

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

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

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

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

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

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

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

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

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

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

เชิงอรรถ

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

ตัวอย่าง

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

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

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

วิธีการ: ไฟล์ Manifest ของพ็อด HLS

ดึงไฟล์ Manifest ของพ็อดโฆษณา HLS ของสตรีมแบบสดที่พร้อมให้โปรแกรมเล่นวิดีโอของไคลเอ็นต์โหลดและเล่น

เมธอด
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/pod/{pod_id}.m3u8;

API เพื่อเรียกข้อมูลเพลย์ลิสต์เวอร์ชันแปรผันหลายตัวแปร HLS สำหรับพ็อดโฆษณา

คำขอ HTTP

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}.m3u8?stream_id={stream_id}&pd={pod_duration}

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

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

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

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

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

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

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

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

ระยะเวลาของพ็อดโฆษณาเป็นมิลลิวินาที
scte35 ไม่บังคับ string

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

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

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

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

หากสำเร็จ เนื้อหาการตอบกลับจะเป็นเพลย์ลิสต์เวอร์ชันแปรผันหลายตัวแปรของ HLS

วิธีการ: ไฟล์ Manifest ของพ็อด DASH

ดึงข้อมูลไฟล์ Manifest ของพ็อดโฆษณา MPEG-DASH ของสตรีมแบบสดที่พร้อมให้วิดีโอเพลเยอร์ฝั่งไคลเอ็นต์โหลดและเล่น

เมธอด
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

API ดึงข้อมูลเพลย์ลิสต์ mpd ของ MPEG-DASH สําหรับพ็อดโฆษณา

คำขอ HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

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

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

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

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

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

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

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

พารามิเตอร์
pd จำเป็น integer

ระยะเวลาของพ็อดโฆษณาเป็นมิลลิวินาที
scte35 ไม่บังคับ string

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

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะเป็นเพลย์ลิสต์ mpd ของ MPEG-DASH

วิธีการ: เทมเพลตระยะเวลาของพ็อด 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 เป็นแบบ idempotent

เมธอด
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

ปลายทางข้อมูลเมตาที่ 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

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

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

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

ความถี่ในการสำรวจ (หน่วยเป็นวินาที) เมื่อขอmetadata_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 ซึ่งอาจเป็น Dash หรือ 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

TagSegment มีการอ้างอิงถึงโฆษณา ช่วงพักโฆษณา และประเภทเหตุการณ์ ไม่ควรส่ง Ping ไปยังปลายทางการยืนยันสื่อโฆษณาสำหรับ TagSegment ที่มี type="progress"
การแสดง 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

จํานวนโฆษณาในช่วงพักโฆษณา
Ad อธิบายโฆษณาในสตรีม
การแสดง 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

การยืนยัน

การยืนยันมีข้อมูลสําหรับการวัดผลแบบเปิด ซึ่งช่วยในการวัดความสามารถในการแสดงตัวโฆษณาและการยืนยันของบุคคลที่สาม ปัจจุบันรองรับเฉพาะทรัพยากร 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

สตริงทึบแสงที่ส่งไปยังรหัสยืนยันการเริ่มต้นระบบ

JavaScriptResource

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

URI ไปยังเพย์โหลด 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