准备您的客户端应用与 Google Ad Manager 搭配使用

收集客户端应用所需的信息

对于 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 帐号中执行以下步骤:

  1. 添加新的广告单元
  2. 启用广告规则
  3. 创建新的广告规则。 执行此步骤后,请在 Ad Manager 中找到定位条件 > 广告资源部分。选择上一步中的新广告单元。

  4. 按照生成视频和音频广告代码中的步骤创建有效的广告代码,并进行以下修改:

    • 对于“播放器 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 令牌,请按以下步骤操作:

  1. PATH_TO_YOUR_SERVICE_KEY 替换为您下载到本地机器的 JSON 文件的路径。
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
    
  2. 从服务帐号检索 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 令牌(包括客户端库代码示例),请参阅创建短期访问令牌