ความเข้ากันได้

หน้านี้ให้ข้อมูลทั่วไปเกี่ยวกับการรองรับ 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

อ่าน หลักเกณฑ์ของ IAB สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการแสดงโฆษณา VAST

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

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

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

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

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

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

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

แพลตฟอร์ม เวอร์ชัน
HTML5 เดสก์ท็อป: Chrome, Firefox, Safari, Edge, Opera
อุปกรณ์เคลื่อนที่: เบราว์เซอร์ Chrome/Android (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 แดชบอร์ด
HTML5 เครื่องหมายถูก เครื่องหมายถูก
iOS เครื่องหมายถูก แดง-X
Android เครื่องหมายถูก เครื่องหมายถูก
Google Cast เครื่องหมายถูก เครื่องหมายถูก
tvOS เครื่องหมายถูก แดง-X
Roku เครื่องหมายถูก เครื่องหมายถูก

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

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

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