启用开放式衡量

适用于 HTML5 的互动式媒体广告 (IMA) SDK。

IMA HTML5 SDK 包含 Open Measurement (OM) SDK，这是由 Interactive Advertising Bureau (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 模式。

为请求设置访问模式规则

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

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

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

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

  1. 在安全的 iframe 中对视频播放器进行沙盒处理，使其与网站的其余部分隔离开。

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