收集客户端应用所需的信息
对于 Google Ad Manager 创建 VOD 资产会话,您应具备以下信息:
字段 | 说明 |
---|---|
projectNumber | 用于创建已启用 Ad Manager 的会话的 Google Cloud 项目编号;或者,您也可以使用项目 ID。 |
region |
您希望 IMA SDK 用于创建 VOD 会话的区域。 |
sourceUri | 要拼接广告的 VOD 资产的 URI。 |
adTagUri | 用于标记应拼接多少广告及拼接时间的广告代码。请参阅为 VOD 会话创建广告代码。 |
networkCode | 您的 Ad Manager 广告资源网的数字标识符。 |
OAuth token | 具有 Video Stitcher User 角色的服务帐号的短期有效的 OAuth 令牌。请参阅生成短期有效的 OAuth 令牌。 |
表 1:已启用 Ad Manager 的 VOD 资产会话的必需信息
为 VOD 会话创建广告代码
在您的 Ad Manager 帐号中执行以下步骤:
- 添加新的广告单元。
- 启用广告规则。
创建新的广告规则。 执行此步骤后,请在 Ad Manager 中找到定位条件 > 广告资源部分。选择上一步中的新广告单元。
按照生成视频和音频广告代码中的步骤创建有效的广告代码,并进行以下修改:
- 对于“播放器 SDK”类型,选择 Google IMA SDK。
- 将参数
ad_rule=1
添加到代码中(例如,在末尾添加&ad_rule=1
)。 - 将参数
vid_d=<vod_asset_duration_in_secs>
添加到代码中(例如,对于时长为 30 分钟的 VOD 资产,请在末尾添加&vid_d=1800
)。 - 将参数
output=vast
修改为output=xml_vmap1
。视频多广告播放列表 (VMAP) 规范是唯一受支持的输出类型。
生成用于测试的短期有效的 OAuth 令牌
如需生成与具有 Video Stitcher User 角色的服务帐号关联的短期 OAuth 令牌,请按以下步骤操作:
- 将 PATH_TO_YOUR_SERVICE_KEY 替换为您下载到本地机器的 JSON 文件的路径。
gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- 从服务帐号检索 OAuth 2.0 不记名令牌:
gcloud auth print-access-token
由于这是一个短期令牌,因此您需要使用 gcloud auth print-access-token
命令定期重新生成该令牌,并将新令牌发送到您的客户端应用。如需详细了解如何构建生产服务以提供短期令牌,请参阅以下部分。
创建服务以向客户端应用提供信息
创建能够提供要传递给客户端的所需信息的服务。当应用向服务请求有关如何播放 VOD 资产的信息时,服务应返回表 1 中所述的信息。
具体而言,该服务必须能够以安全的方式向客户端应用提供 OAuth 令牌。请使用两个服务帐号来模拟另一个帐号来配置此服务。一个服务帐号具有 Service Token Creator 角色,并为具有 Video Stitcher User 角色的服务帐号创建 OAuth 令牌。例如:
- 服务帐号 1:这是调用方服务帐号。此帐号对服务帐号 2 具有 Service Token Creator 权限,可将服务帐号 2 模拟为客户端应用。
- 服务帐号 2:这是具有权限的服务帐号,具有 Video Stitcher User 角色以创建会话。
如需了解如何从服务提供 OAuth 令牌(包括客户端库代码示例),请参阅创建短期访问令牌。