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

หน้านี้ให้ข้อมูลทั่วไปเกี่ยวกับการรองรับและการทำงานร่วมกันของ 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 (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 Video Suite การสนับสนุน
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 ต่อไปนี้

  • Companion 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) เท่านั้น

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

8 Why This Ad? กําหนดให้ต้องส่งพารามิเตอร์ 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