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

เลือกแพลตฟอร์ม: HTML5 Android iOS tvOS Cast Roku

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

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

HTML5 ยังคงเป็นมาตรฐานใหม่ที่กำลังพัฒนา ด้วยเหตุนี้ การรองรับฟีเจอร์ต่างๆ จึงแตกต่างกันไปในแต่ละเบราว์เซอร์ และไม่มีรูปแบบวิดีโอเริ่มต้น รูปแบบเดียวที่เบราว์เซอร์หลักทั้งหมดรองรับ รูปแบบวิดีโอหลัก 3 รูปแบบที่ใช้ในเบราว์เซอร์ส่วนใหญ่คือ H.264, HLS และ Dash

ความเข้ากันได้ของเหตุการณ์ VAST

ส่วนนี้แสดงเหตุการณ์ VAST ที่รายงานไปยังเซิร์ฟเวอร์โดยอัตโนมัติ ตามข้อมูลที่แสดงผลในการตอบกลับ VAST

รองรับโดยสมบูรณ์

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (ทริกเกอร์เมื่อมีการกรอถอยหลังอย่างมีนัยสำคัญ), start, thirdQuartile

รองรับบางส่วน

• click

  ระบบจะส่งเหตุการณ์ Click สำหรับโฆษณาวิดีโอเท่านั้น ระบบจะบันทึกการคลิกในเพลเยอร์แบบเต็มหน้าจอเนทีฟบน Android, iOS หรือเดสก์ท็อปไม่ได้ แต่ยังคงบันทึกการคลิกได้ด้วยองค์ประกอบการติดตามการคลิกในหน้าเว็บเมื่อปิดวิดีโอ อย่างไรก็ตาม หากองค์ประกอบวิดีโอใช้ตัวควบคุมดั้งเดิมใน iPad ระบบจะบันทึกการคลิกไม่ได้

• fullscreen
  

  IMA รองรับโหมดจำลองเต็มหน้าจอ ซึ่งวิดีโอจะแสดงเต็มหน้าต่างเบราว์เซอร์ IMA ถือว่าวิดีโออยู่ในโหมดเต็มหน้าจอ เมื่อ 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

เหตุการณ์โฆษณาเมื่อดูช่วงพักโฆษณาย้อนหลัง

IMA จะไม่ทริกเกอร์เหตุการณ์โฆษณาเมื่อดูโฆษณาซ้ำเนื่องจากสาเหตุต่อไปนี้

• URL ของเหตุการณ์ควรทริกเกอร์เพียงครั้งเดียว ไม่เช่นนั้นระบบอาจตีความว่าเป็นการกระทำที่ดูเป็นสแปม
• ซึ่งจะช่วยให้ผู้ใช้สามารถกรอไปข้างหน้าและข้างหลังช่วงพักโฆษณาที่เคยดูไปแล้ว จึงสร้างประสบการณ์การกรอที่ดีขึ้น

เหตุการณ์ต่อไปนี้เป็นเหตุการณ์เดียวที่จะทริกเกอร์เมื่อดูช่วงพักโฆษณาย้อนหลัง

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

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

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

แพลตฟอร์ม	เวอร์ชัน
HTML5	เดสก์ท็อป: Chrome, Firefox, Safari, Edge, Opera อุปกรณ์เคลื่อนที่: Chrome/Android Browser (Android สำหรับโทรศัพท์และแท็บเล็ต), Safari และ Chrome (iOS)
iOS	iOS 10.0 ขึ้นไป
Android	Android 4.4 ขึ้นไป
Google Cast	อุปกรณ์แคสต์ทั้งหมด
tvOS	tvOS 15 ขึ้นไป
Roku	อุปกรณ์ทั้งหมดที่ยังคงได้รับการอัปเดตซอฟต์แวร์จาก Roku

การรองรับรูปแบบสตรีมวิดีโอ

IMA รองรับทั้ง HLS และ DASH ใน SDK ดูตารางนี้เพื่อรับการสนับสนุน ในแพลตฟอร์ม SDK ที่เฉพาะเจาะจง หากต้องการเล่นสตรีมอย่างถูกต้อง วิดีโอเพลเยอร์ ต้องรองรับประเภทสตรีมที่ใช้

แพลตฟอร์ม IMA SDK	HLS	DASH
HTML5
iOS
Android
Google Cast
tvOS
Roku

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

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

ชุดวิดีโอของ IAB	การสนับสนุน
VAST 4	1
VAST 3	2
VAST 2
VPAID 2
VMAP 1.0.1	3
ฟีเจอร์วิดีโอของ Ad Manager	การสนับสนุน
โฆษณาเชิงเส้น
โฆษณาที่ไม่ใช่เชิงเส้น (โฆษณาซ้อนทับ)
การแสดงร่วม	4
แหล่งข้อมูลโฆษณาที่แสดงร่วมสำรองของ VAST 3
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ
การเปลี่ยนเส้นทาง VAST
การทดแทนที่แสดงร่วมกับคำขอ Display
ความเข้ากันได้ของแท็กผู้เผยแพร่โฆษณาผ่าน Google (GPT)
การรับรู้เกี่ยวกับเนื้อหา
กฎของโฆษณา
การจัดกลุ่มแบบไดนามิก
บัมเปอร์
การรายงานเกี่ยวกับการติดตามแบบหลายเหตุการณ์ (MET)
ข้ามได้ (การจอง / ไม่ใช่ TrueView)	5
ฟีเจอร์ AdSense for Video 7	การสนับสนุน
TrueView InStream	6
InStream Select
ในสตรีมมาตรฐาน
เต็มสล็อต
การแสดงร่วม	4
การทดแทนโฆษณาที่แสดงร่วม
การวางซ้อน
ฟีเจอร์ Ad Exchange ของ Ad Manager	การสนับสนุน
TrueView InStream	6
InStream Select
ในสตรีมมาตรฐาน
เต็มสล็อต
การแสดงร่วม	4
การทดแทนโฆษณาที่แสดงร่วม
การวางซ้อน
การมองเห็นโฆษณาของมุมมองแอ็กทีฟ
ทำไมจึงแสดงโฆษณานี้	8

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

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

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

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

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

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

⁴ รองรับเฉพาะโฆษณาที่แสดงร่วมแบบรูปภาพ โฆษณาเสริมแบบรูปภาพ ต้องมีการติดตั้งใช้งานที่กำหนดเองเพื่อแสดงโฆษณา tvOS ไม่รองรับโฆษณาที่แสดงร่วม

⁵ โฆษณาที่ข้ามได้แบบดั้งเดิมรองรับเฉพาะใน IMA DAI SDK สำหรับ HTML5, iOS, tvOS, Roku และ Android (รวมถึง Android TV) เมื่อใช้ Cast SDK คุณต้องประกาศความสามารถในการข้ามด้วย StreamRequest.senderCanSkip เพื่อรองรับโฆษณาที่ข้ามได้แบบเดิม

⁶ โฆษณา TrueView แบบข้ามได้รองรับใน IMA DAI SDK สำหรับ HTML5, iOS, tvOS, Roku และ Android (รวมถึง Android TV)

⁷ Cast SDK ไม่รองรับฟีเจอร์ AdSense

⁸ ทำไมจึงแสดงโฆษณานี้กำหนดให้ต้องส่งพารามิเตอร์ adUiElement เมื่อสร้าง StreamManager Cast SDK ไม่รองรับทำไมจึงแสดงโฆษณานี้

สำคัญ: การใช้ HTML5 IMA DAI SDK กับโฆษณาที่ข้ามได้หรือทำไมจึงแสดงโฆษณานี้ต้อง ส่งพารามิเตอร์ adUiElement เมื่อสร้าง StreamManager

ข้อควรระวังสำหรับเฟรมเวิร์ก JavaScript

มีข้อควรพิจารณาบางประการเมื่อใช้เฟรมเวิร์ก JavaScript เช่น React หรือ AngularJS กับ IMA HTML5 SDK เฟรมเวิร์กเหล่านี้มักจะย้ายองค์ประกอบ ของ DOM ซึ่งอาจทำให้ IMA SDK ทำงานไม่ได้เนื่องจาก SDK คาดหวังว่า DOM จะ คงที่เมื่อเริ่มต้น IMA SDK รองรับเฟรมเวิร์ก JavaScript หากเริ่มต้น SDK หลังจากที่เฟรมเวิร์กย้ายองค์ประกอบ DOM เสร็จแล้ว กล่าวอย่างเจาะจงคือ องค์ประกอบ HTML5 ที่ส่งเป็นอาร์กิวเมนต์ adUiElement เมื่อสร้าง StreamManager ไม่ควรย้ายเมื่อสร้างอินสแตนซ์แล้ว