启用开放式衡量

选择平台： HTML5 Android iOS

适用于 HTML5 的 IMA SDK 包含 Open Measurement (OM) SDK， 后者是由 美国互动广告局 (IAB) 开发的行业标准，用于实现第三方 可见度和验证衡量。使用适用于 HTML5 的 IMA SDK 时，所包含的 OM SDK 会自动解析 VAST 广告代码中的 <AdVerifications> 标记，并使用 OMID API 将可见度数据发送给指定的衡量供应商。您可以选择为每个请求设置访问模式规则，以控制验证脚本可以访问哪些内容。

IMA SDK 支持 OM SDK v1.4。

前提条件

  • 如果使用 VAST 4.1 或更高版本，则必须将广告配置为使用 <AdVerifications> 提供验证 。如果使用之前的 VAST 版本，则广告必须使用 <Extension type="AdVerifications">。

  • 如果您的广告是通过 Ad Manager 投放的，请为您的 Ad Manager 广告资源网配置可见度提供商，并将该可见度提供商分配给您的订单项。如需了解详情，请参阅 为您的 Ad Manager 广告资源网配置可见度提供商。

访问模式

OM SDK 支持在四种不同的访问模式下运行验证脚本，这些模式控制着验证脚本可以访问的内容量：

  • FULL：验证脚本可以直接访问广告素材和发布商网页。

  • CREATIVE：验证脚本和广告素材与发布商网页隔离。不过，该脚本可以直接访问广告素材。

  • LIMITED：验证脚本被隔离，无法访问广告素材或发布商网页，也无法直接确认它所在的发布商网域。

某些可见度提供商可能不支持所有访问模式。请与您的可见度提供商联系，以验证支持哪些模式。以前，IMA 支持 DOMAIN 访问模式，现在默认使用 LIMITED 模式。

为请求设置访问模式规则

必须在 StreamRequest 级别设置访问模式规则。如需为不同的验证脚本 提供商设置不同的访问模式，请传递一个字典，将每个 OmidVerificationVendor 映射到上述访问模式之一。OmidVerificationVendor.OTHER 字段用于为字典中未明确包含的所有供应商设置默认访问模式。如果未指定任何访问模式规则，则验证脚本将以 LIMITED 访问模式为供应商运行。

请参阅以下示例，该示例将 GOOGLE 设置为 google.ima.dai.api.OmidAccessMode.FULL。所有其他提供商（包括 在 OmidVerificationVendor中列出的提供商）都默认使用 OmidVerificationVendor.OTHER 的设置。

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.GOOGLE]
    = google.ima.dai.api.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.OTHER]
    = google.ima.dai.api.OmidAccessMode.LIMITED;

如需实现 CREATIVE 访问模式，您必须执行以下两个步骤：

  1. 将视频播放器沙盒化到安全的 iframe 中，使其与网站的其余部分隔离。

  2. 将可见度衡量合作伙伴的 OmidAccessMode 设置为 FULL。