开放式衡量

适用于 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：验证脚本已经过沙盒化处理，无法访问广告素材或发布商页面，也无法直接确认其所在的发布商网域。

某些可见度供应商可能不支持所有访问模式。请与您的可见度提供商联系，确认系统支持哪些模式。

为请求设置访问模式规则

访问模式规则必须在 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.DOMAIN;

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

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

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