ตรวจสอบการรองรับและความเข้ากันได้ของ SDK

หน้านี้ให้ข้อมูลทั่วไปเกี่ยวกับการรองรับฝั่งไคลเอ็นต์ของ HTML5 IMA และความเข้ากันได้สำหรับเบราว์เซอร์ รูปแบบวิดีโอ และแพลตฟอร์ม

รูปแบบวิดีโอและเบราว์เซอร์ที่รองรับ

การรองรับฟีเจอร์ต่างๆ จะแตกต่างกันไปตามเบราว์เซอร์ และไม่มีรูปแบบวิดีโอเริ่มต้นเพียงรูปแบบเดียวที่เบราว์เซอร์หลักทั้งหมดรองรับ รูปแบบวิดีโอหลัก 3 รูปแบบที่ใช้ในเบราว์เซอร์ส่วนใหญ่คือ H.264, WebM และ Ogg Theora

วิดีโอเพลเยอร์ที่รองรับ

ฟีเจอร์ IMA ส่วนใหญ่รองรับโดยวิดีโอเพลเยอร์ HTML5 ทั่วไป รวมถึงแท็ก 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 ไม่ควรย้ายเมื่อสร้างอินสแตนซ์แล้ว

แพลตฟอร์มวิดีโอเพลเยอร์ที่รองรับ

Google IMA SDK รองรับแพลตฟอร์มต่อไปนี้

แพลตฟอร์ม	เวอร์ชัน	ประเภทโฆษณา
HTML5	เดสก์ท็อป: Chrome, Firefox, Safari, Edge, Opera อุปกรณ์เคลื่อนที่: เบราว์เซอร์ Chrome/Android (Android สำหรับโทรศัพท์และแท็บเล็ต), Safari และ Chrome (iOS)	วิดีโอเชิงเส้น, Display เชิงเส้น, โฆษณาที่ไม่ใช่เชิงเส้นและโฆษณาที่แสดงร่วม, โซลูชันวิดีโอของ 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 15 ขึ้นไป	โฆษณาเชิงเส้น, วิดีโอ Ad Manager และวิดีโอ Ad Exchange

ฟีเจอร์วิดีโอและเวอร์ชัน SDK

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ต่อไปนี้ได้ที่ภาพรวมการโฆษณาวิดีโอ

	HTML5 v3	iOS v3	Android v3	tvOS
IAB Video Suite
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
โฆษณาเชิงเส้น
โฆษณา Display เชิงเส้น
ชิ้นงานที่โฮสต์ใน YouTube	4
โฆษณาที่ไม่ใช่เชิงเส้น (โฆษณาซ้อนทับ)	5
การแสดงร่วม
แหล่งข้อมูลโฆษณาที่แสดงร่วมทางเลือกของ VAST 3
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ
โฆษณาเสียง
การเปลี่ยนเส้นทาง VAST
โฆษณาทดแทนที่แสดงร่วมกับคำขอ Display
ความเข้ากันได้ของแท็กผู้เผยแพร่โฆษณาผ่าน Google (GPT)
การรับรู้เนื้อหา
กฎของโฆษณา	3
ช่วงพักโฆษณาแบบกำหนดเองในกฎโฆษณา
6 ความถี่สูงสุด
การยกเว้นโฆษณาของคู่แข่ง (สตรีม)
การยกเว้นโฆษณาของคู่แข่ง (พ็อด)
การยกเว้นโฆษณาของคู่แข่ง (ทั้งหน้า)
การจัดกลุ่มแบบไดนามิก	3
บัมเปอร์
การรายงานเกี่ยวกับการติดตามหลายเหตุการณ์ (MET)
การจัดสรรแบบไดนามิก (AdSense for Video, Ad Manager Ad Exchange)
แบบข้ามได้ (ไม่ใช่ TrueView) 8	5
InStream Select
การโหลดชิ้นงานล่วงหน้า	7
ฟีเจอร์ของ AdSense for Video
TrueView InStream	5
InStream Select
ในสตรีมแบบมาตรฐาน
แบบเต็มช่อง
การแสดงร่วม
โฆษณาทดแทนที่แสดงร่วมกัน
การวางซ้อน	5
การโหลดชิ้นงานล่วงหน้า	7
ฟีเจอร์ Ad Exchange ของ Ad Manager
TrueView InStream	5
InStream Select
ในสตรีมแบบมาตรฐาน
แบบเต็มช่อง
การแสดงร่วม
โฆษณาทดแทนที่แสดงร่วมกัน
การวางซ้อน	5
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ
การโหลดชิ้นงานล่วงหน้า	7
ทำไมจึงแสดงโฆษณานี้

¹ SDK ที่ไม่ใช่ HTML5 ยังไม่รองรับฟีเจอร์ VAST 3.0 ต่อไปนี้

• adSlotIdที่แสดงร่วม
• ตัวเลือกการแสดงโฆษณาร่วม
• ไอคอน

² ระบบยังไม่รองรับฟีเจอร์ VMAP ต่อไปนี้

• เหตุการณ์การติดตามเฉพาะ VMAP
• รหัสข้อผิดพลาดเฉพาะ VMAP
• โฆษณาซ้อนทับ
• ออฟเซ็ตเวลาอื่นนอกเหนือจาก hh:mm:ss หรือ "start" และ "end"
• แอตทริบิวต์ display breakType
• แอตทริบิวต์ repeatAfter รายการ

³ การรองรับ VMAP และกฎโฆษณาใน iPhone ต้องใช้การเล่นโฆษณาที่กำหนดเอง

⁴ ครีเอทีฟโฆษณาที่โฮสต์บน YouTube ได้รับการรองรับบนเดสก์ท็อป แต่ไม่รองรับบนเว็บบนมือถือ

⁵ โฆษณาแบบไม่เชิงเส้น (โฆษณาซ้อนทับ), โฆษณาแบบข้ามได้ (ไม่ใช่ TrueView) และโฆษณา TrueView ในสตรีมใช้ได้ในเว็บบนมือถือ HTML5 บน iOS 10 ขึ้นไปเมื่อใช้ playsinline

⁶ ความถี่สูงสุดของกฎโฆษณาและการยกเว้นโฆษณาของคู่แข่งต้องใช้คุกกี้หรือ PPID

⁷ การโหลดชิ้นงานเนทีฟล่วงหน้าใช้ไม่ได้กับรายการต่อไปนี้

• เว็บบนมือถือในอุปกรณ์ iOS
• เว็บบนมือถือใน Android เวอร์ชันก่อน 4.0
• โฆษณาที่โฮสต์บน YouTube รวมถึงรูปแบบ TrueView
• ฟีเจอร์การเล่นช่วงพักโฆษณาด้วยตนเองของ IMA (การใช้งานที่อาศัยเหตุการณ์ AD_BREAK_READY)

⁸ SDK ไม่รองรับโฆษณาแบบข้ามได้ที่มีความยาวน้อยกว่า 8 วินาที เมื่อเล่นโฆษณาที่สั้นกว่าความยาวขั้นต่ำ ปุ่มข้ามจะไม่แสดง

⁹ จากฟีเจอร์ VAST 4 ที่ Google Ad Manager รองรับ IMA รองรับฟีเจอร์ต่อไปนี้

• VAST 4.2
  • การรองรับ Secure Interactive Media Interface Definition (SIMID)
  • การอนุญาตโหนด UniversalAdID หลายรายการ
• VAST 4.0
  • AdID
  • ไฟล์ Mezzanine
  • รหัสข้อผิดพลาด VAST ใหม่
  • ทีมสนับสนุนของ AdVerifications

SDK ที่เลิกใช้งานแล้ว

	Flash v2	HTML5 v1	iOS v1	Android เวอร์ชัน 1	Google Cast v2
ฟีเจอร์วิดีโอของ Ad Manager
โฆษณาเชิงเส้น
โฆษณาที่ไม่ใช่เชิงเส้น
โฆษณาแบบอินเทอร์แอกทีฟ (VPAID 1.0)
การเปลี่ยนเส้นทาง (VAST 2.0)
โฆษณาทดแทนที่แสดงร่วม (AdSense for Video, Ad Manager Ad Exchange)
โฆษณาเสียง
ความเข้ากันได้ของแท็กผู้เผยแพร่โฆษณาผ่าน Google (GPT)
ความถี่สูงสุด
การยกเว้นโฆษณาของคู่แข่ง (สตรีม)
การยกเว้นโฆษณาของคู่แข่ง (พ็อด)
การยกเว้นโฆษณาของคู่แข่ง (ทั้งหน้า)
การรับรู้เนื้อหา
กฎโฆษณาและช่วงพักโฆษณาแบบกำหนดเองในกฎโฆษณา
การจัดกลุ่มแบบไดนามิก
บัมเปอร์
การติดตามหลายเหตุการณ์ (MET) สำหรับการรายงาน
การจัดสรรแบบไดนามิก
ข้ามได้
InStream Select
ฟีเจอร์ของ AdSense for Video
โฆษณาแบบข้อความ
AdSense VAST ในสตรีม
โฆษณาซ้อนทับของ AdSense
ข้ามได้
InStream Select
ตัวเลือกของผู้ใช้ (YouTube)
โฆษณา F2F ใน Ad Manager
ฟีเจอร์ Ad Exchange ของ Ad Manager
โฆษณาเชิงเส้น