开放式衡量

适用于 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:验证脚本和广告素材已从发布商页面进行了沙盒化处理。不过,此脚本可直接访问广告素材。

  • 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.DOMAIN;

如需实现 CREATIVE 访问模式,您必须执行以下两项步骤:

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

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