# Open Measurement

> 实现 IAB Open Measurement SDK 以支持应用内广告的第三方可视性和验证。

Unity 支持为您的视频广告使用 Open Measurement (OM) 第三方验证码。如需了解更多信息，请参阅 IAB 的 [OM 规范](https://iabtechlab.com/blog/vast-4-1-open-measurement-the-long-awaited-video-verification-solution/)。

## VAST 标签##vast-tag

要在 VAST 标签中实现 OM 代码，请完成以下步骤：

1. 包含 `<AdVerifications>` 节点。如需了解更多信息，请参阅 [VAST 指南](https://www.iab.com/wp-content/uploads/2016/04/VAST4.0_Updated_April_2016.pdf)的**第 3.16 节**。

> **Note:**
>
> 如果您使用的是 VAST 2.X 或 3.X，请包含 `<AdVerifications>` as an `<Extension>` under `<Extensions>`。

2. 在 `<Verification>` 标签中包含您的供应商密钥（以识别您是否有需要发送到验证脚本的额外参数）。
3. 在 [`<JavaScriptResource>`](#javascript-resource) 标签中包含验证脚本。

```xml
<AdVerifications>
	<Verification vendor="company.com-omid">
		<JavaScriptResource apiFramework="omid" browserOptional="true">
			<![CDATA[https://verification.com/omid_verification.js]]>
		</JavaScriptResource>
		<VerificationParameters>
			<![CDATA[verification params key/value pairs]]>
		</VerificationParameters>
	</Verifications>
</AdVerifications>
```

> **Note:**
>
> 校验参数为可选字段、非必填。

### JavaScript 资源##javascript-resource

在 `<JavaScriptResource>` 标签中包含一个验证脚本，该脚本用于立即注册会话观察者、视频事件和广告事件，以便简化事件管理并确保按顺序调用所有事件。

> **Note:**
>
> 注册会话观察者时，应始终在 `<Verifications>` 节点中包含一个与 `vendor='key'` 属性匹配的供应商键。

以下列表详细介绍了 Unity 支持的宏（如果跟踪 URL 中提供了这些宏）：

* `%OM_ENABLED%`
  * 默认为 `false`。
  * 如果 VAST 支持 OM，则设为 `true`。
* `%OM_VENDORS%`
  * OM SDK 集成的标识符。
  * 这与 `OMIDPartner` 对象的 `name` 和 `versionString` 参数相同。

[简单验证脚本示例](https://github.com/InteractiveAdvertisingBureau/Open-Measurement-JSClients/blob/master/src/validation-verification-script/validation-verification-client.js)

## OMID 故障排除##omid-troubleshooting

如果发生错误，追踪链接的 `[REASON]` 宏可能会返回以下原因：

* `VERIFICATION_RESOURCE_REJECTED`
* `VERIFICATION_NOT_SUPPORTED`
* `ERROR_RESOURCE_LOADING`