Open Measurement ใน IMA SDK

IMA SDK สําหรับ Android มี Open Measurement (OM) SDK ซึ่งเป็นมาตรฐานอุตสาหกรรมที่พัฒนาโดย Interactive Advertising Bureau (IAB) เพื่อเปิดใช้การวัดการมองเห็นและการยืนยันของบุคคลที่สาม เมื่อใช้ IMA SDK สำหรับ Android OM SDK ที่รวมอยู่จะแยกวิเคราะห์แท็ก <AdVerifications> ภายในแท็กโฆษณา VAST โดยอัตโนมัติ และส่งข้อมูลการมองเห็นโฆษณาไปยังผู้ให้บริการการวัดผลที่ระบุผ่าน OMID API โดย IMA SDK รองรับส่วนขยาย OM SDK เวอร์ชัน 1.4, GAM Ad Verifications ใน VAST 2 ขึ้นไป และโหนด AdConfirms ใน VAST 4 ขึ้นไป หากต้องการใช้ประโยชน์จาก Open Measurement โปรดคํานึงถึงประเด็นต่อไปนี้

  • หากต้องการใช้ Open Measurement คุณต้องมี IMA SDK สําหรับ Android เวอร์ชัน 3.11.0 ขึ้นไป อย่างไรก็ตาม ตัวอย่างในคู่มือนี้ออกแบบมาสำหรับ SDK เวอร์ชันล่าสุดและรวม API ที่เปิดตัวในเวอร์ชัน 3.16.5

  • โฆษณาต้องได้รับการกําหนดค่าให้ใช้ <AdVerifications> ใน VAST ตามข้อกําหนดของ VAST 4.1 หากใช้ VAST 4.1 ขึ้นไป หรือควรใช้ <Extension type="AdVerifications">

  • หลีกเลี่ยงการปิดบัง AdDisplayContainer ด้วยการวางซ้อน (โปร่งใสหรือทึบ) เนื่องจาก OMSDK จะแจ้งว่าสิ่งเหล่านี้เป็นสิ่งกีดขวางและลดการมองเห็นโฆษณา

ข้อกำหนดเบื้องต้น

การทดสอบ

หากต้องการทดสอบ Open Measurement โดยใช้ IMA SDK ให้ใช้ SDK เวอร์ชันใดเวอร์ชันหนึ่งข้างต้นที่ต้องใช้ พร้อมกับแท็กโฆษณาทดสอบ

คุณควรเห็น <AdVerifications> แสดงในการตอบกลับ VAST

ลงทะเบียนสิ่งกีดขวางการควบคุมวิดีโอที่วางซ้อน

การควบคุมวิดีโอ เช่น ปุ่มหยุดชั่วคราวหรือแถบความคืบหน้า จะให้ข้อมูลและการดำเนินการที่จำเป็นสำหรับการเล่นแก่ผู้ใช้ บนอุปกรณ์เคลื่อนที่ การแตะที่ไม่สม่ำเสมอและความคาดหวังของผู้ใช้ทำให้เป็นแนวทางปฏิบัติทั่วไปในการแสดงผลการควบคุมขนาดใหญ่และเหมาะกับการแตะบนองค์ประกอบสื่อ ตัวควบคุมเหล่านี้มักจะค่อยๆ เลือนหายไปเมื่อผู้ใช้แตะ และมองไม่เห็นเมื่อเล่นโดยส่วนใหญ่

ด้านล่างนี้คือตัวอย่างการควบคุมวิดีโอที่แอป YouTube แสดงผล

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

เมื่อคํานวณการมองเห็นโฆษณาผ่าน Open Measurement SDK มุมมองทั้งหมดที่วางซ้อนองค์ประกอบสื่อจะถือว่าบดบังและลดอัตราการมองเห็นโฆษณา ในกรณีที่การซ้อนทับการแตะแบบโปร่งใสอยู่เหนือคอนเทนเนอร์การแสดงโฆษณาทั้งหมด ระบบอาจประกาศพื้นที่โฆษณาว่าไม่สามารถดูได้

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

IMA SDK รองรับ IAB และ MRC จึงเปิดตัว API สำหรับการลงทะเบียนการวางซ้อนเหล่านี้กับ Open Measurement SDK การควบคุมเหล่านี้ต้องเป็นการวางซ้อนหรือปุ่มขนาดเล็กที่โปร่งใสทั้งหมด คุณต้องไม่ลงทะเบียนมุมมองอื่นๆ ที่ไม่เกี่ยวข้องกับการควบคุมวิดีโอ

ลงทะเบียน DO อย่าลงทะเบียน
  • การวางซ้อนแบบโปร่งใสเพื่อบันทึกการแตะของผู้ใช้
  • ปุ่มชั่วคราว
    • หยุดชั่วคราว
    • เล่น
    • เต็มหน้าจอ
    • Cast/AirPlay
    • ยุบ
    • ความคืบหน้า/การกรอ
    • การดำเนินการอื่นๆ ที่เกี่ยวข้องกับการเล่น
  • ลายน้ำ
  • ป๊อปอัป
  • กล่องโต้ตอบ
  • ปุ่มถาวร
  • มุมมองอื่นๆ ที่บดบัง

โค้ดตัวอย่างต่อไปนี้แสดงวิธีลงทะเบียนการวางซ้อนตัวควบคุมวิดีโอในคอนเทนเนอร์การแสดงโฆษณา 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

เมื่อใช้เสร็จแล้ว คุณสามารถนำสิ่งกีดขวางเหล่านี้ออกได้โดยเรียกใช้เมธอดต่อไปนี้ 

displayContainer.unregisterAllFriendlyObstructions();