在 IMA SDK 中打开 Open Measurement

适用于 Android 的 IMA SDK 包含 Open Measurement (OM) SDK,这是互动广告局 (IAB) 制定的行业标准,用于支持第三方可见度和验证衡量。使用适用于Android的 IMA SDK 时,包含的 OM SDK 会自动解析 VAST 广告代码内的 <AdVerifications> 代码,并通过 OMID API 向指定的衡量服务供应商发送可见度数据。IMA SDK 支持 OM SDK v1.3、VAST 2+ 上的 GAM AdVerifications 扩展程序以及 VAST 4+ 上的 AdVerifications 节点。若要利用 Open Measurement,请注意以下几点:

  • 如需使用 Open Measurement,您必须具备版本3.11.0 或更高版本的 IMA SDK for Android。 但是,本指南中的示例是针对最新版本的 SDK 设计的,包含 3.16.5 版中引入的 API。

  • 如果使用 VAST 4.1 及更高版本,必须根据 VAST 4.1 规范将广告配置为在其 VAST 中投放 <AdVerifications>;否则,应使用 <Extension type="AdVerifications">

  • 请勿使用任何叠加层(透明或不透明)覆盖 AdDisplayContainer,因为这些叠加层会被 OM SDK 标记为障碍,并降低可见度。

前提条件

测试

若要使用 IMA SDK 测试开放式衡量,请使用上述 SDK 的某个所需版本以及测试广告代码

您应该会在 VAST 响应中看到返回的 <AdVerifications>

注册视频控件叠加遮挡

视频控件(例如暂停按钮或进度条)可为用户提供基本的播放信息和操作。在移动设备上,不精确的点按和用户期望成为一种常见的做法,那就是对媒体元素渲染方便触摸的大型控件。这些控件通常会在用户点按时淡入和淡出,在绝大部分播放时间内不可见。

下面是一个由 YouTube 应用呈现的视频控件示例:

在使用 IMA SDK 时,大多数发布商都会在广告显示容器上方添加一个基本透明的视图,用来实现这些控件。控件通常是此视图的子元素,会完全遮挡底层视频播放器。此透明叠加层用于捕获点按事件,然后在用户点按时将其呈现给用户。

通过 Open Measurement SDK 计算广告可见度时,叠加在媒体元素上的所有视图均被视为遮挡,会降低可见率。如果透明的点按叠加层位于整个广告显示容器之上,则广告资源可能会被声明完全不可见。

Open Measurement SDK 规定,视频控件应被视为对用户体验至关重要的“友好”障碍。一旦注册为友好型,这些控件便不会计入广告可见度衡量。

在 IAB 和 MRC 的支持下,IMA SDK 引入了一个 API,用于在 Open Measurement SDK 中注册这些叠加层。这些控件必须是完全透明的叠加层或小按钮。不得注册与视频控件无关的任何其他视图。

DO 注册 请勿注册
  • 透明叠加层,以捕获用户点按
  • 瞬态按钮
    • 暂停
    • 播放
    • Fullscreen
    • 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();