Open Measurement

适用于 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。