หน้านี้ให้ข้อมูลทั่วไปเกี่ยวกับการสนับสนุนฝั่งไคลเอ็นต์ของ HTML5 IMA และความเข้ากันได้สำหรับเบราว์เซอร์ รูปแบบวิดีโอ และแพลตฟอร์ม
รูปแบบวิดีโอและเบราว์เซอร์ที่รองรับ
การรองรับฟีเจอร์ต่างๆ จะแตกต่างกันไปในแต่ละเบราว์เซอร์ และไม่มีรูปแบบวิดีโอเริ่มต้นรายการเดียวที่เบราว์เซอร์หลักทั้งหมดรองรับ รูปแบบวิดีโอหลัก 3 รูปแบบที่ใช้ในเบราว์เซอร์ส่วนใหญ่ ได้แก่ H.264, WebM และ Ogg Theora
โปรแกรมเล่นวิดีโอที่รองรับ
โปรแกรมเล่นวิดีโอ HTML5 ทั่วไปรองรับฟีเจอร์ IMA ส่วนใหญ่ รวมถึงแท็ก HTML <video>
ไปที่โปรแกรมพาร์ทเนอร์เทคโนโลยีวิดีโอสำหรับรายชื่อโปรแกรมเล่นวิดีโอที่รู้จักที่รองรับ IMA SDK
ความเข้ากันได้ของเหตุการณ์ VAST
ส่วนนี้แสดงรายการเหตุการณ์ VAST ที่รายงานไปยังเซิร์ฟเวอร์โดยอัตโนมัติ โดยอิงตามข้อมูลที่แสดงในการตอบกลับด้วย VAST
รองรับโดยสมบูรณ์
complete
, creativeView
,
firstQuartile
, impression
, midpoint
,
pause
, resume
, rewind
(เริ่มทำงานเมื่อมี
การค้นหาที่มีนัยสำคัญในทิศทางย้อนหลัง), start
,
thirdQuartile
รองรับบางส่วน
click
ระบบจะส่งเหตุการณ์
Click
สําหรับโฆษณาวิดีโอเท่านั้น ระบบไม่สามารถบันทึกการคลิกในโปรแกรมเล่นวิดีโอเต็มหน้าจอแบบเนทีฟใน Android, iOS หรือเดสก์ท็อป แต่จะยังบันทึกการคลิกโดยองค์ประกอบการติดตามการคลิกในหน้าเว็บได้เมื่อปิดวิดีโอ แต่หากองค์ประกอบวิดีโอใช้การควบคุมแบบเนทีฟใน iPad จะไม่สามารถบันทึกการคลิกได้fullscreen
IMA SDK สนับสนุนโหมดเต็มหน้าจอจำลอง ซึ่งวิดีโอจะแสดงเต็มหน้าต่างเบราว์เซอร์ทั้งหน้า เราจะถือว่าวิดีโออยู่ในโหมดเต็มหน้าจอเมื่อ
offsetWidth
และoffsetHeight
มีขนาดเท่ากับเนื้อหาเอกสารเป็นอย่างน้อย โหมดนี้ใช้ได้ในทุกเบราว์เซอร์ ดูตัวอย่างแบบเต็มหน้าจอที่จำลองขึ้นได้โดยดาวน์โหลดตัวอย่างบนแพลตฟอร์ม iPhone และ Android ก่อนรุ่น 3.0 วิดีโอจะเล่นในโหมดเต็มหน้าจอเสมอ
mute
unmute
iOS และ Android จะมีเฉพาะการควบคุมระดับเสียงในตัวเท่านั้น ดังนั้น IMA SDK จึงไม่สามารถ กำหนดระดับเสียงหรือสถานะปิดเสียง และเราก็จะไม่ได้รับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงเช่นกัน ด้านล่างนี้เป็นรายการเวอร์ชันของเบราว์เซอร์ที่รองรับและไม่รองรับ
mute
,unmute
- รองรับ: Firefox 3.5 ขึ้นไป, Chrome 8 ขึ้นไป, Safari 4 ขึ้นไป
- ไม่รองรับ: iOS, Android
โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการแสดงโฆษณา VAST ในหลักเกณฑ์ของ IAB
ข้อควรระวังเกี่ยวกับเฟรมเวิร์ก JavaScript
มีข้อควรพิจารณาบางอย่างเมื่อใช้เฟรมเวิร์ก JavaScript เช่น React หรือ AngularJS กับ IMA HTML5 SDK เฟรมเวิร์กเหล่านี้มักย้ายองค์ประกอบต่างๆ ของ DOM ซึ่งอาจทําให้ฟังก์ชันการทำงานของ IMA เสียหาย เนื่องจาก IMA คาดไว้ว่า DOM จะไม่ทํางานเมื่อเริ่มต้น SDK IMA รองรับเฟรมเวิร์ก JavaScript ตราบใดที่ IMA เริ่มทำงานหลังจากเฟรมเวิร์กย้ายองค์ประกอบ DOM เสร็จแล้ว กล่าวอย่างเจาะจงคือ คุณไม่ควรย้ายองค์ประกอบ HTML5 ที่ส่งผ่านเป็นอาร์กิวเมนต์ ContainerElement เมื่อสร้าง AdDisplayContainer
เมื่อสร้างอินสแตนซ์แล้ว
รองรับ Apple AirPlay
ปัจจุบัน IMA SDK ยังไม่รองรับ Apple AirPlay ปิดใช้ AirPlay หรือปิดใช้คำขอโฆษณาเมื่อตรวจพบ AirPlay
แพลตฟอร์มโปรแกรมเล่นวิดีโอที่รองรับ
Google IMA SDK ใช้งานได้ในแพลตฟอร์มต่อไปนี้
แพลตฟอร์ม | เวอร์ชัน | ประเภทโฆษณา |
---|---|---|
HTML5 | เดสก์ท็อป: Chrome, Firefox, Safari, Edge, Opera อุปกรณ์เคลื่อนที่: เบราว์เซอร์ Chrome/Android (Android สำหรับโทรศัพท์และแท็บเล็ต), Safari และ Chrome (iOS) |
โฆษณาที่ปรากฏร่วมกับเนื้อหา โฆษณาที่ปรากฏร่วมกับวิดีโอ และโฆษณาที่แสดงร่วม, โซลูชันวิดีโอของ Ad Manager, โฆษณาวิดีโอของ Ad Exchange และโฆษณา AFV |
iOS | iOS 10.0 ขึ้นไป | โฆษณาที่ไม่ปรากฏร่วมกับวิดีโอและโฆษณาที่แสดงร่วม, วิดีโอ Ad Manager, วิดีโอ Ad Exchange และโฆษณา AFV |
Android | Android 4.4 ขึ้นไป | โฆษณาที่ไม่ปรากฏร่วมกับวิดีโอและโฆษณาที่แสดงร่วม, วิดีโอ Ad Manager, วิดีโอ Ad Exchange และโฆษณา AFV |
tvOS | tvOS 14 ขึ้นไป | โฆษณาเชิงเส้น, วิดีโอ Ad Manager และวิดีโอ Ad Exchange |
ฟีเจอร์วิดีโอและเวอร์ชัน SDK
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ต่อไปนี้ ให้อ่านภาพรวมการโฆษณาทางวิดีโอ
HTML5 V3 | iOS เวอร์ชัน 3 | Android เวอร์ชัน 3 | tvOS | |
---|---|---|---|---|
ชุดวิดีโอของ IAB | ||||
VAST 4 | 9 | 9 | 9 | 9 |
VAST 3 | 1 | 1 | 1 | |
VAST 2 | ||||
SIMID 1.0 | ||||
VPAID 2 (HTML5) | ||||
VMAP 1.0.1 | 2 3 | 2 | 2 | 2 |
OM SDK 1.3 | ||||
ฟีเจอร์วิดีโอของ Ad Manager | ||||
โฆษณาที่ไม่ปรากฏร่วมกับวิดีโอ | ||||
เนื้อหาที่โฮสต์บน YouTube | 4 | |||
โฆษณาที่ปรากฏร่วมกับเนื้อหา (โฆษณาซ้อนทับ) | 5 | |||
การแสดงร่วม | ||||
ทรัพยากรโฆษณาที่แสดงร่วมสำรองของ VAST 3 | ||||
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ | ||||
โฆษณาแบบเสียง | ||||
การเปลี่ยนเส้นทาง VAST | ||||
โฆษณาทดแทนร่วมที่มีคำขอโฆษณาแบบดิสเพลย์ | ||||
ความเข้ากันได้ของแท็กผู้เผยแพร่โฆษณาผ่าน Google (GPT) | ||||
การรับรู้ถึงเนื้อหา | ||||
กฎของโฆษณา | 3 | |||
ช่วงพักโฆษณาในกฎโฆษณาที่กำหนดเอง | ||||
ความถี่สูงสุด 6 | ||||
การยกเว้นโฆษณาของคู่แข่ง (สตรีม) | ||||
การยกเว้นโฆษณาของคู่แข่ง (พ็อด) | ||||
การยกเว้นโฆษณาของคู่แข่ง (ทั้งหน้า) | ||||
พ็อดดิ้ง | 3 | |||
บัมเปอร์ | ||||
การรายงานการติดตามหลายเหตุการณ์ (MET) | ||||
การจัดสรรแบบไดนามิก (AdSense for Video, Ad Manager Ad Exchange) | ||||
โฆษณาแบบข้ามได้ (ไม่ใช่ TrueView) 8 | 5 | |||
ในสตรีมแบบพิเศษ | ||||
การโหลดเนื้อหาล่วงหน้า | 7 | |||
ฟีเจอร์ของ AdSense for Video | ||||
TrueView InStream | 5 | |||
ในสตรีมแบบพิเศษ | ||||
ในสตรีมมาตรฐาน | ||||
เต็มช่อง | ||||
การแสดงร่วม | ||||
โฆษณาทดแทนร่วม | ||||
การวางซ้อน | 5 | |||
การโหลดเนื้อหาล่วงหน้า | 7 | |||
ฟีเจอร์ของ Ad Exchange ใน Ad Exchange | ||||
TrueView InStream | 5 | |||
ในสตรีมแบบพิเศษ | ||||
ในสตรีมมาตรฐาน | ||||
เต็มช่อง | ||||
การแสดงร่วม | ||||
โฆษณาทดแทนร่วม | ||||
การวางซ้อน | 5 | |||
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ | ||||
การโหลดเนื้อหาล่วงหน้า | 7 | |||
ทำไมจึงแสดงโฆษณานี้ |
1 SDK ที่ไม่ใช่ HTML5 ยังไม่รองรับฟีเจอร์ VAST 3.0 ต่อไปนี้
- โฆษณาที่แสดงร่วมขนาด
adSlotId
- ตัวเลือกการแสดงโฆษณาร่วม
- ไอคอน
2 ระบบยังไม่รองรับฟีเจอร์ VMAP ต่อไปนี้
- เหตุการณ์การติดตามเฉพาะ VMAP
- รหัสข้อผิดพลาดเกี่ยวกับ VMAP โดยเฉพาะ
- โฆษณาซ้อนทับ
- การชดเชยเวลาอื่นที่ไม่ใช่ hh:mm:ss หรือ "start" และ "end"
- แสดงแอตทริบิวต์
breakType
- แอตทริบิวต์
repeatAfter
รายการ
3 การรองรับ VMAP และกฎโฆษณาใน iPhone กำหนดให้ต้องมีการเล่นโฆษณาที่กำหนดเอง
4 เดสก์ท็อปจะรองรับครีเอทีฟโฆษณาที่ YouTube โฮสต์ แต่ใช้ไม่ได้กับเว็บบนอุปกรณ์เคลื่อนที่
5 รองรับโฆษณาที่ไม่ใช่เชิงเส้น (โฆษณาซ้อนทับ) โฆษณาแบบข้ามได้ (ไม่ใช่ TrueView) และ TrueView ในสตรีมบนเว็บบนอุปกรณ์เคลื่อนที่ HTML5 บน iOS 10 ขึ้นไป เมื่อใช้
playsinline
6 ความถี่สูงสุดของกฎโฆษณาและการยกเว้นโฆษณาของคู่แข่งต้องใช้คุกกี้หรือ PPID
7 การโหลดเนื้อหาเนทีฟล่วงหน้าใช้ไม่ได้กับรายการต่อไปนี้
- เว็บบนอุปกรณ์เคลื่อนที่บนอุปกรณ์ iOS
- เว็บบนอุปกรณ์เคลื่อนที่ใน Android เวอร์ชันก่อน 4.0
- โฆษณาที่โฮสต์บน YouTube รวมถึงรูปแบบ TrueView
-
ฟีเจอร์การเล่นช่วงพักโฆษณาด้วยตนเองของ IMA (การติดตั้งใช้งานที่อาศัยเหตุการณ์
AD_BREAK_READY
)
8 SDK ไม่รองรับโฆษณาแบบข้ามได้ที่มีความยาวน้อยกว่า 8 วินาที เมื่อโฆษณาเล่นสั้นกว่าความยาวขั้นต่ำ ปุ่มข้ามจะไม่แสดง
9 จากฟีเจอร์ VAST 4 ที่ Google Ad Manager รองรับ IMA รองรับฟีเจอร์ต่อไปนี้
- VAST 4.2
- การรองรับ Secure Interactive Media Interface Definition (SIMID)
- การอนุญาตโหนด
UniversalAdID
หลายรายการ
- VAST 4.0
- AdID
- ไฟล์ Mezzanine
- รหัสข้อผิดพลาด VAST ใหม่
- ทีมสนับสนุนของ
AdVerifications