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 ใน VAST 2 ขึ้นไป และโหนดการตรวจสอบโฆษณาใน VAST 4 ขึ้นไป หากต้องการใช้ประโยชน์จากการวัดผลแบบเปิด โปรดคำนึงถึงประเด็นต่อไปนี้
หากต้องการใช้ 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
ด้วยภาพซ้อนทับใดๆ (โปร่งใสหรือทึบแสง) เนื่องจาก OM SDK จะแจ้งว่าสิ่งเหล่านี้เป็นการบดบังและลดการมองเห็นโฆษณา
ข้อกำหนดเบื้องต้น
- หากโฆษณาของคุณแสดงผ่าน Ad Manager ให้กำหนดค่าผู้ให้บริการด้านการมองเห็นโฆษณาสำหรับเครือข่าย Ad Manager และมอบหมายผู้ให้บริการด้านการมองเห็นโฆษณาดังกล่าวให้แก่รายการโฆษณา
การทดสอบ
หากต้องการทดสอบ Open Measurement โดยใช้ IMA SDK ให้ใช้ SDK เวอร์ชันใดเวอร์ชันหนึ่งที่จำเป็น ด้านบน พร้อมกับแท็กโฆษณาทดสอบ
คุณควรเห็น <AdVerifications>
แสดงในการตอบกลับด้วย VAST
ลงทะเบียนสิ่งกีดขวางการวางซ้อนตัวควบคุมวิดีโอ
การควบคุมวิดีโอ เช่น ปุ่มหยุดชั่วคราวหรือแถบความคืบหน้า จะให้ข้อมูลและการดำเนินการที่จำเป็นต่อการเล่นแก่ผู้ใช้ บนอุปกรณ์เคลื่อนที่ การแตะที่ไม่แม่นยำและความคาดหวังของผู้ใช้ทำให้การแสดงผลการควบคุมขนาดใหญ่ที่เหมาะกับการสัมผัสเหนือองค์ประกอบสื่อกลายเป็นแนวทางปฏิบัติทั่วไป โดยปกติแล้ว ตัวควบคุมเหล่านี้จะค่อยๆ ปรากฏและหายไปเมื่อผู้ใช้แตะ และจะไม่ปรากฏในเวลาเล่นส่วนใหญ่
ด้านล่างนี้คือตัวอย่างการควบคุมวิดีโอที่แอป YouTube แสดง
เมื่อใช้ IMA SDK ผู้เผยแพร่โฆษณาส่วนใหญ่จะใช้การควบคุมเหล่านี้โดยการเพิ่ม มุมมองเหนือคอนเทนเนอร์ที่แสดงโฆษณาซึ่งส่วนใหญ่โปร่งใส โดยปกติแล้ว การควบคุมจะเป็นองค์ประกอบย่อยของมุมมองนี้ ซึ่งจะบดบังวิดีโอเพลเยอร์ที่อยู่ด้านล่างอย่างสมบูรณ์ โดยจะใช้การซ้อนทับแบบโปร่งใสนี้เพื่อบันทึกเหตุการณ์การแตะ แล้ว แสดงผลตัวควบคุมต่อผู้ใช้เมื่อมีการแตะ
เมื่อคำนวณการมองเห็นโฆษณาผ่าน Open Measurement SDK ระบบจะถือว่ามุมมองทั้งหมดที่ซ้อนทับองค์ประกอบสื่อเป็นสิ่งกีดขวางและลดอัตราการมองเห็นโฆษณา ในกรณีที่การซ้อนทับการแตะแบบโปร่งใสอยู่เหนือ คอนเทนเนอร์การแสดงโฆษณาทั้งหมด ระบบอาจประกาศว่าพื้นที่โฆษณา มองไม่เห็นเลย
Open Measurement SDK มีข้อกำหนดสำหรับตัวควบคุมวิดีโอเพื่อให้ถือเป็นสิ่งกีดขวางที่ "เป็นมิตร" ซึ่งจำเป็นต่อประสบการณ์ของผู้ใช้ เมื่อลงทะเบียนเป็นมิตรแล้ว ระบบจะไม่รวมการควบคุมเหล่านี้ในการวัด การมองเห็นโฆษณา
IMA SDK ได้เปิดตัว API สำหรับลงทะเบียนภาพซ้อนทับเหล่านี้กับ Open Measurement SDK โดยได้รับการสนับสนุนจาก IAB และ MRC การควบคุมเหล่านี้ต้องเป็นภาพซ้อนทับที่โปร่งใสโดยสมบูรณ์ หรือปุ่มขนาดเล็ก ระบบจะไม่บันทึกการดูอื่นๆ ที่ไม่เกี่ยวข้องกับการควบคุมวิดีโอ
สิ่งที่ควรทำ | อย่าลงทะเบียน |
---|---|
|
|
โค้ดตัวอย่างต่อไปนี้แสดงวิธีลงทะเบียนภาพซ้อนทับของตัวควบคุมวิดีโอ ในคอนเทนเนอร์ที่แสดงโฆษณา
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();