SDK โฆษณาสื่ออินเทอร์แอกทีฟ (IMA) ของ Google สำหรับ HTML5 รองรับ Secure Interactive Media Interface Definition (SIMID) เวอร์ชัน 1.1 คู่มือนี้ครอบคลุมฟีเจอร์และข้อความ SIMID ที่เฉพาะเจาะจงซึ่ง IMA SDK รองรับ
ทำความเข้าใจข้อความจากครีเอทีฟโฆษณาถึงโปรแกรมเล่น
ตารางต่อไปนี้แสดงข้อความที่ครีเอทีฟโฆษณา SIMID สามารถส่งไปยัง IMA SDK ได้
| ข้อความ | คำอธิบาย |
|---|---|
clickThru |
จัดการการคลิกโฆษณาตาม URI ที่ครีเอทีฟโฆษณาระบุ |
fatalError |
สิ้นสุดเซสชันโฆษณาและรายงานข้อผิดพลาดร้ายแรงจากครีเอทีฟโฆษณา |
getMediaState |
แสดงสถานะปัจจุบันของมีเดียเพลเยอร์ ซึ่งรวมถึง URI, currentTime, duration, volume และ muted status |
log |
ส่งต่อข้อความในบันทึกของครีเอทีฟโฆษณาไปยัง IMA SDK เพื่อแก้ไขข้อบกพร่อง |
reportTracking |
ขอให้ IMA SDK ทำการ ping URL ติดตามในนามของครีเอทีฟโฆษณา |
requestChangeAdDuration |
คำขอให้แก้ไขระยะเวลารวมของเซสชันโฆษณา |
requestNavigation |
ขอการนําทางไปยัง URI ภายนอก |
requestPause |
ส่งคำขอให้ IMA SDK หยุดเล่นสื่อชั่วคราว |
requestPlay |
ขอให้ IMA SDK เล่นต่อหรือเล่นมีเดียเพลเยอร์ |
requestResize |
คำขอปรับขนาดวิดีโอเพลเยอร์ หากโปรแกรมเล่นอนุญาตให้ปรับขนาด IMA SDK จะปรับขนาดโปรแกรมเล่น |
requestSkip |
ขอให้ SDK ข้ามโฆษณาปัจจุบัน |
requestStop |
ส่งคำขอให้ SDK หยุดเซสชันโฆษณา |
handleSkipShown |
แจ้ง IMA SDK ว่าครีเอทีฟโฆษณาได้แสดง UI การข้ามโฆษณาแล้ว |
requestFocus |
ขอโฟกัสสำหรับ iframe ของครีเอทีฟโฆษณา |
ตรวจสอบข้อความ "ครีเอทีฟโฆษณาไม่รองรับโปรแกรมเล่น"
IMA SDK ไม่รองรับประเภท CreativeMessage ต่อไปนี้
requestChangeVolumerequestFullscreenrequestExitFullscreen
ทำความเข้าใจข้อความจากผู้เล่นถึงข้อความครีเอทีฟโฆษณา
ตารางต่อไปนี้แสดงข้อความที่ IMA SDK รองรับการส่งไปยังครีเอทีฟโฆษณา SIMID
| ข้อความ | คำอธิบาย |
|---|---|
init |
ส่งระหว่างการตั้งค่าเซสชันพร้อมข้อมูลสภาพแวดล้อมและพารามิเตอร์โฆษณา |
startCreative |
แจ้งให้ครีเอทีฟโฆษณาเริ่มต้นและแสดง iframe ของครีเอทีฟโฆษณา |
adStopped |
แจ้งว่าเซสชันโฆษณาสิ้นสุดแล้ว พร้อมระบุรหัสเหตุผล |
adSkipped |
แจ้งครีเอทีฟโฆษณาว่าผู้ใช้หรือ IMA SDK ข้ามโฆษณา |
resize |
แจ้งครีเอทีฟโฆษณาเกี่ยวกับการเปลี่ยนแปลงขนาดเพลเยอร์หรือวิดีโอ |
appBackgrounded |
แจ้งครีเอทีฟโฆษณาว่าแอปพลิเคชันเข้าสู่เบื้องหลังแล้ว |
appForegrounded |
แจ้งครีเอทีฟโฆษณาว่าแอปพลิเคชันกลับมาทำงานในเบื้องหน้าแล้ว |
fatalError |
แจ้งครีเอทีฟโฆษณาเกี่ยวกับข้อผิดพลาดฝั่งโปรแกรมเล่น |
log |
ส่งข้อความในบันทึกจากเพลเยอร์ไปยังครีเอทีฟโฆษณา |
focusIn |
แจ้งว่าครีเอทีฟโฆษณาได้รับโฟกัสแล้ว |
ตรวจสอบการอัปเดตสถานะสื่อ
IMA SDK จะส่งข้อความ mediaStateUpdate ไปยังครีเอทีฟโฆษณาสำหรับเหตุการณ์ต่อไปนี้
playpausestalled(กำลังบัฟเฟอร์)seekingseekedendeddurationchangetimeupdateเป็นระยะๆvolumechangeรวมถึงสถานะการปิดเสียง