适用于 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
访问模式,您必须执行以下两个步骤:
将视频播放器沙盒化到安全的 iframe 中,与网站的其余部分隔离。
将可见度合作伙伴的
OmidAccessMode
设置为FULL
。