Open Measurement ใน IMA SDK

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