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

เลือกแพลตฟอร์ม: 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 รองรับ OM SDK เวอร์ชัน 1.6, ส่วนขยาย 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 จะตั้งค่าสถานะโอเวอร์เลย์เหล่านี้เป็นการบดบังและลดความสามารถในการแสดงตัวโฆษณา

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

การทดสอบ

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

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

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

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

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

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

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

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

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

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

สิ่งที่ควรลงทะเบียน สิ่งที่ไม่ควรลงทะเบียน
  • โอเวอร์เลย์โปร่งใสเพื่อบันทึกการแตะของผู้ใช้
  • ปุ่มชั่วคราว
    • หยุดชั่วคราว
    • Google Play
    • เต็มหน้าจอ
    • แคสต์/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();
}