配置广告预取计划
Download
聚焦模式
字号
前提条件
管理预取计划
1. 对于已创建好的广告插入配置，在操作栏单击详情，进入配置详情页面。
2. 在详情页面中，对于这个广告插入配置，可以看到预取计划的标签页。在此标签页内，可以查看预取计划、添加预取计划、删除预取计划。
添加预取计划
1. 登录 StreamPackage 控制台，在广告插入配置详情的预取计划页面，单击添加预取计划，对预取计划进行配置。
2. 配置信息如下：
配置 | 描述 |
名称 | 请输入预取计划的名称，支持输入1-512个字符的数字、字母、下划线、中划线。在此广告插入配置关联的所有预取计划中，该名称必须唯一。 |
预取计划类型 | 单次：如果某个活动的广告投放时间是确定的，请使用单次预取计划。在单次预取计划中，将定义一次广告投放中使用的广告。 周期性：如果某个活动的广告投放时间是不可预测的，请使用周期性预取计划。在周期性预取计划中，在检测到广告投放点之前，系统将自动创建预取计划并预取广告。这样，您不需要为每次广告投放都创建一次预取计划。但是相比于单次预取，您也会失去更精细的时间控制。 |
单次预取和周期性预取的配置内容有所区别。
对于单次预取，配置内容为：
配置 | 描述 |
广告预取窗口 | 指定 StreamPackage 开始和停止预取广告的时间窗口。对于开始时间，StreamPackage 会为客户端在该时间或之后发起的清单请求预取广告。对于结束时间，StreamPackage 会为在该时间或之前发生的清单请求预取广告。该窗口必须为未来时间，且时长必须小于24小时。 可以设置为绝对时间窗口，或者相对时间窗口。 |
流量整形类型 | 如果选择按时间窗口拉取，需要填写流量整形窗口时长。流量整形窗口时长支持设置为30-1800秒，StreamPackage 会在该时间窗口内分散发送预取请求。 如果选择 TPS，需要填写峰值 TPS、峰值并发用户数。峰值 TPS，即广告决策服务器（ADS）每秒可处理的最大请求数。峰值并发用户数，即预期的峰值并发观看人数。StreamPackage 会结合峰值 TPS 和峰值并发用户数，来确定如何在可用容量范围内分布预取请求，同时不超过 ADS 限制。 |
对于周期性预取，配置内容为：
配置 | 描述 |
周期性预取窗口 | StreamPackage 会为广告预取窗口内的每个广告位进行广告预取。周期性预取窗口，即 StreamPackage 将执行广告预取和广告插入的时间窗口。该窗口必须为未来时间，且时长必须小于24小时。 |
广告机会结束后的延迟 | 在一个广告机会结束后，StreamPackage 等待多少秒再为下一个广告机会预取广告。 |
流量整形类型 | 如果选择按时间窗口拉取，需要填写流量整形窗口时长。流量整形窗口时长支持设置为30-1800秒，StreamPackage 会在该时间窗口内分散发送预取请求。 如果选择 TPS，需要填写峰值 TPS、峰值并发用户数。峰值 TPS，即广告决策服务器（ADS）每秒可处理的最大请求数。峰值并发用户数，即预期的峰值并发观看人数。StreamPackage 会结合峰值 TPS 和峰值并发用户数，来确定如何在可用容量范围内分布预取请求，同时不超过 ADS 限制。 |
预取动态变量
可以添加、查看、删除预取动态变量。如果您设置了动态变量，StreamPackage 会根据您在预取时设置的动态变量来进行判断。只有在满足匹配的情况下，才会将预取的广告进行插播。
配置 | 描述 |
键 | 请输入动态变量键，例如 session.id。你可以使用 StreamPackage 支持的任意会话变量或播放器变量。键最多可包含 32 个字符，支持字母、数字、下划线（_）和连字符（-）。 |
值 | 请输入动态变量值，例如 AnExampleValue。值最多可包含 32 个字符，支持字母、数字、下划线（_）和连字符（-）。 |
对于单次预取和周期性预取，配置内容有所区别。
对于单次预取，配置内容为：
配置 | 描述 |
广告投放窗口 | 指定 StreamPackage 开始和停止将预取广告放入广告插播的时间窗口。结束时间必须晚于开始时间，且距当前时间小于一天。在广告投放窗口内，StreamPackage 会将预取的广告放入符合条件的广告插播中。 可以设置为绝对时间窗口，或者相对时间窗口。 |
对于周期性预取，配置内容为：
配置 | 描述 |
预取广告到期时间 | 对于周期性预取计划，在周期性预取窗口内，StreamPackage 会将预取的广告插入到符合条件的广告位中。广告被预取后，在此时间范围内是有效的，可以用于广告插入使用。 |
广告投放匹配条件
配置 | 描述 |
动态变量键 | 如果设置了广告机会匹配条件，只有当广告插播（广告机会）满足动态变量定义的条件时，StreamPackage 才会将预取广告放入该广告插播。 |
文档反馈