Google Dynamic Ad Insertion (DAI) SDK สำหรับ HTML5 รองรับ Secure Interactive Media Interface Definition (SIMID) เวอร์ชัน 1.1 คู่มือนี้ครอบคลุมฟีเจอร์และข้อความ SIMID ที่เฉพาะเจาะจงซึ่ง DAI SDK รองรับ
ทำความเข้าใจข้อความจากครีเอทีฟโฆษณาถึงเพลเยอร์
ตารางต่อไปนี้แสดงรายการข้อความที่ครีเอทีฟโฆษณา SIMID ส่งไปยัง IMA DAI ได้
| ข้อความ | คำอธิบาย |
|---|---|
clickThru |
DAI SDK จะส่ง Ping ไปยัง URL การติดตามการคลิกผ่านที่กำหนดค่าไว้ในแท็กโฆษณา DAI DAI SDK จะไม่สนใจ URI หรือตัวเลือกการนำทางที่กำหนดเองซึ่งครีเอทีฟโฆษณาให้มา |
getMediaState |
แสดงสถานะปัจจุบันของมีเดียเพลเยอร์ ซึ่งรวมถึงพร็อพเพอร์ตี้ currentTime, duration, volume, muted, paused และ fullscreen พร็อพเพอร์ตี้ currentSrc จะแสดงผล null เสมอเนื่องจาก DAI ใช้สตรีมที่ผสานฝั่งเซิร์ฟเวอร์ |
log |
ส่งต่อข้อความบันทึกของครีเอทีฟโฆษณาไปยังการบันทึกคอนโซลดีบักของ DAI SDK เพื่อใช้ในการแก้ปัญหา |
reportTracking |
ขอให้ DAI SDK ส่ง Ping ไปยัง URL การติดตามสำหรับครีเอทีฟโฆษณา |
requestPause |
ขอให้ DAI SDK หยุดมีเดียเพลเยอร์ไว้ชั่วคราว |
requestPlay |
ขอให้ DAI SDK เล่นมีเดียเพลเยอร์ต่อ |
requestSkip |
ขอให้ DAI SDK ข้ามโฆษณาปัจจุบัน รองรับเฉพาะสตรีม VOD ปฏิเสธหากครีเอทีฟโฆษณาส่งข้อความนี้สำหรับไลฟ์สด |
ตรวจสอบข้อความจากครีเอทีฟโฆษณาถึงเพลเยอร์ที่ไม่รองรับ
DAI SDK ไม่จัดการ CreativeMessage ประเภทต่อไปนี้
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: ปฏิเสธเสมอ เพลเยอร์คาดหวังให้ครีเอทีฟโฆษณาจัดการการนำทางrequestResize: ปฏิเสธเสมอ DAI SDK ไม่รองรับการปรับขนาดครีเอทีฟโฆษณาrequestStop: ปฏิเสธเสมอ ประเภทนี้มีไว้สำหรับกรณีการใช้งานที่มีระยะเวลานานขึ้น ซึ่ง DAI ไม่รองรับrequestChangeVolume: DAI SDK แก้ไขเหตุการณ์นี้ได้สำเร็จ แต่ไม่ได้ทำการเปลี่ยนแปลงระดับเสียงสำหรับครีเอทีฟโฆษณา
ทำความเข้าใจข้อความจากเพลเยอร์ถึงครีเอทีฟโฆษณา
ตารางต่อไปนี้แสดงรายการข้อความที่ DAI SDK รองรับการส่งไปยังครีเอทีฟโฆษณา SIMID
| ข้อความ | คำอธิบาย |
|---|---|
init |
ส่งระหว่างการตั้งค่าเซสชันพร้อมข้อมูลสภาพแวดล้อมและพารามิเตอร์โฆษณา |
startCreative |
แจ้งให้ครีเอทีฟโฆษณาเริ่มต้นและแสดง iframe ของครีเอทีฟโฆษณา |
adStopped |
แจ้งว่าเซสชันโฆษณาสิ้นสุดลงแล้ว ซึ่งรวมถึงรหัสเหตุผล |
adSkipped |
แจ้งให้ครีเอทีฟโฆษณาทราบว่าผู้ใช้หรือ DAI SDK ข้ามโฆษณา รองรับเฉพาะสตรีม VOD |
ตรวจสอบข้อความจากเพลเยอร์ถึงครีเอทีฟโฆษณาที่ไม่รองรับ
DAI SDK ไม่รองรับหรือส่งข้อความต่อไปนี้ไปยังครีเอทีฟโฆษณา
resizeappBackgroundedappForegroundedlog
ตรวจสอบการอัปเดตสถานะสื่อ
DAI SDK จะส่งข้อความ mediaStateUpdate ไปยังครีเอทีฟโฆษณาสำหรับเหตุการณ์ต่อไปนี้
playpausestalled(กำลังเก็บบัฟเฟอร์)seekingseekedtimeupdate(เป็นระยะ)volumechange(รวมถึงสถานะการปิดเสียง)
DAI SDK ไม่รองรับเหตุการณ์ต่อไปนี้และจะไม่ส่งการอัปเดตสถานะสื่อเมื่อเกิดเหตุการณ์ขึ้น
endeddurationchangeerror