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