IMA SDK 中的 Open Measurement

适用于 iOS 的 IMA SDK 包含 Open Measurement (OM) SDK，这是由互动广告联盟 (IAB) 开发的业界标准，可实现第三方可见度和验证衡量。使用 IMA SDK for iOS 时，随附的 OM SDK 会自动解析 VAST 广告代码中的 <AdVerifications> 代码，并通过 OMID API 将可见度数据发送给指定的衡量服务供应商。IMA SDK 支持 OM SDK v1.4、VAST 2 及更高版本上的 GAM AdVerifications 扩展，以及 VAST 4 及更高版本上的 AdVerifications 节点。若要利用 Open Measurement，请注意以下几点：

  • 如需使用 Open Measurement，您必须使用 iOS 版 IMA SDK 3.9.0 或更高版本。

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

  • 请勿使用任何叠加层（透明或不透明）遮盖 AdDisplayContainer，因为这些叠加层会被 OMSDK 标记为遮挡物，从而降低可见度。

前提条件

测试

要使用 IMA SDK 测试 Open Measurement，请使用上述 SDK 的某个版本以及测试广告代码。

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

注册视频控件叠加层遮挡元素

视频控件（例如暂停按钮或进度条）可向用户提供重要的播放信息和操作。在移动设备上，由于点按不精确且用户有此预期，因此通常会在媒体元素上呈现大尺寸、触控友好的控件。这些控件通常会在用户点按时淡入淡出，并且在播放的大部分时间都不会显示。

以下是 YouTube 应用呈现的视频控件的示例：

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

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

Open Measurement SDK 提供了相应规定，将视频控件视为对用户体验至关重要的“友好”遮挡元素。注册为友好广告控制功能后，这些功能将从广告可见度衡量范围中排除。

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

立即注册 请勿注册
  • 用于捕获用户点按的透明叠加层
  • 瞬时按钮
    • 暂停
    • 播放
    • 全屏
    • 投放/AirPlay
    • 收起
    • 进度/跳转
    • 与播放相关的其他操作
  • 水印
  • 弹出式窗口
  • 对话框
  • 非瞬时按钮
  • 其他遮挡视图

以下示例代码演示了如何在广告展示容器上注册视频控件叠加层： 

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"This is the video player pause button"];

[displayContainer registerFriendlyObstruction:overlayObstruction];
[displayContainer registerFriendlyObstruction:pauseButtonObstruction];

当您用完这些障碍物后，可以通过调用以下方法移除这些障碍物： 

[displayContainer unregisterAllFriendlyObstructions];