เปิดใช้การวัดผลแบบเปิด

เลือกแพลตฟอร์ม: HTML5 Android iOS

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

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

การทดสอบ

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

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

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

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

ดูตัวอย่างการวางซ้อนตัวควบคุมวิดีโอได้ในรูปภาพต่อไปนี้ใน ตัวควบคุมการแสดงผลของแอป YouTube:

รูปภาพตัวอย่างการวางซ้อนการวัดผลแบบเปิด

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

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

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

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

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

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

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

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

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}