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

หน้านี้ให้ข้อมูลทั่วไปเกี่ยวกับการรองรับและความเข้ากันได้ของ 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 14 ขึ้นไป
Roku อุปกรณ์ทั้งหมดที่ยังคงได้รับการอัปเดตซอฟต์แวร์จาก Roku

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

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

แพลตฟอร์ม IMA SDK HLS DASH
HTML5 เครื่องหมายถูก เครื่องหมายถูก
iOS เครื่องหมายถูก Red-X
Android เครื่องหมายถูก เครื่องหมายถูก
Google Cast เครื่องหมายถูก เครื่องหมายถูก
tvOS เครื่องหมายถูก Red-X
Roku เครื่องหมายถูก เครื่องหมายถูก

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

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

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

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

  • VAST 4.2
  • VAST 4.0
    • AdID
    • ไฟล์ Mezzanine
    • รหัสข้อผิดพลาด VAST ใหม่
    • มาโคร VAST ใหม่
    • ทีมสนับสนุนของ AdVerifications

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

  • แยกหน้าจอประชุม adSlotId
  • ตัวเลือกการแสดงโฆษณาร่วม
  • ไอคอน

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

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

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

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

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

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

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

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

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

การรองรับ Apple AirPlay

IMA SDK ไม่รองรับ Apple AirPlay ปิดใช้ AirPlay หรือปิดใช้คำขอโฆษณาเมื่อตรวจพบ AirPlay