本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 预取广告
在直播中使用 AWS Elemental MediaTailor 广告预取，以帮助减少广告决策服务器 (ADS) 的峰值负载，并减少每次广告时段开始时的清单投放延迟。在定义预取时间表时，请 MediaTailor 按照时间表从广告中检索广告，并在广告插播需要之前为广告插入做好准备。在直播期间，预取可以帮助缓解广告填充率下降以及由于广告请求和转码超时或其他渠道延迟而错失的获利机会。
**注意**
广告预取不适用于服务器引导式广告插入 (SGAI) 方法，包括传统的服务器引导式广告插播和 HLS 插页式广告。SGAI 方法不需要预取，因为玩家只能获取他们要播放的广告，并且可以在 CDNs 不 MediaTailor看到单个会话请求的情况下提供清单。
要设置广告预取，您需要根据播放配置创建一个或多个*预取计划*。预取时间表告诉您 MediaTailor 如何以及何时检索和准备即将到来的广告时段的广告。
+ 如果某个活动的广告投放时间表是可预测的，请使用*单一的预取*计划。每个预取计划都定义了一组 MediaTailor 要在单个广告中投放的广告。要在使用单个预提时间表时为多个广告预取广告，您必须创建与每个广告投放相关的多个预取计划（最多 24 小时前）。
+ 如果某个活动的广告投放时间表不在可预测的时间表上，请使用*重复的预提*计划。重复的预取计划会自动创建时间表并在活动中的每个广告中断之前预取广告。定期预取计划会在规定的时间段内（最长在活动结束前 24 小时）检索每个广告可用的广告。您无需为每个广告创建时间表，但是您确实会失去单次预取所提供的一些时间控制。
以下主题详细介绍了广告预取。
**Topics**
+ [预取的工作原理](understanding-prefetching.md)
+ [创建预取计划](creating-prefetch-schedules.md)
+ [基于 TPS 的流量整形](tps-traffic-shaping.md)
+ [删除预回迁计划](deleting-prefetch-schedules.md)
# 预取的工作原理
当您的客户端向发出清单请求时 MediaTailor，该服务会评估与播放配置关联的所有预取计划。如果找 MediaTailor 不到匹配的预取时间表，该服务将恢复为正常的广告插入，并且不会预取广告。
如果 MediaTailor 找到匹配的预取计划，该服务将根据两个组成部分来评估该计划：检索和消费。每个组件的配置因单个预取计划和重复的预取计划而异，如以下各节所述。
## 单一预取计划流程
**检索**
这定义了*检索窗口*，即从 ADS 中 MediaTailor 预取广告的时间范围。请务必将此时段安排在广告中断之前的时间。下文概述了如何 MediaTailor 处理单个预回迁计划。
有关在控制台中创建单一预回迁计划的步骤，请参阅[创建预取计划](creating-prefetch-schedules.md)。有关 API 的说明，请参阅《*AWS Elemental MediaTailor API 参考*》[PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)中的。
在指定的*检索*时段内， MediaTailor 向 ADS 发送请求，要求其检索和准备广告，以便日后在播放会话中插入。
+ MediaTailor （可选）使用流量整形来限制一次向 ADS 发出的请求数量。您可以在两种方法之间进行选择：
*时间窗口流量整形*-将请求 MediaTailor 分布在指定的秒数内，而不是一次性发送所有会话的请求。这种分散的流量分布有助于防止广告不堪重负，从而导致超时和低广告填充率。
*基于 TPS 的流量整形*-根据每秒交易量 (TPS) 和并发用户 MediaTailor 限制请求。此方法可根据您的 ADS 容量限制提供更直观的配置。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 如果您设置了*动态变量*，请在 MediaTailor 向 ADS 发出的请求中包含这些变量。 MediaTailor 使用这些变量将广告投放量与消费窗口期间的预提时间表进行匹配。有关更多信息，请参阅以下 “*消费*” 部分。
**Example**
直播活动从上午 7:45 持续到上午 10 点，广告中断时间为上午 8:15。您配置 MediaTailor为从上午 7:45 到上午 8 点检索广告，流量调整窗口为 60 秒。如果有 500,000 个并发用户，则 MediaTailor 分发 ADS 请求以在 60 秒内实现每秒大约 8,333 笔交易的平均速率（500,000 个用户/60 秒=每秒 8,333 个请求），而不是同时发送所有请求。
检索配置包括动态变量键`scte.event`和值`1234`。 MediaTailor 在向 ADS 发出的请求中包含此变量，然后可使用该变量将特定广告商定位到事件 ID 1234。
**消费**
当在消费窗口中 MediaTailor 遇到 SCTE-35 广告插播标记时，它会将预取的广告放置在广告插播时间中。
+ 如果您未设置可用性匹配标准，则会在消费窗口的第一个空白处 MediaTailor 插入广告。
+ 如果您确实为*可用*性*匹配**条件*设置了*动态变量键*，则会根据您在检索窗口中设置的动态变量来 MediaTailor 评估这些条件。只有在满足广告匹配条件的情况下，广告插播才有资格进行预取广告插入。 MediaTailor 在符合条件的第一个广告时段插入广告。
有关支持的可用性匹配条件的列表，请参阅上表中的 “*可用于广告预取*” 列。[MediaTailor ADS 请求的会话变量](variables-session.md)
**Example 持续**
您将消费的开始时间设置为上午 8:15，将结束时间设置为上午 8:17。您将密钥包含`scte.event_id`在可用性匹配标准中。
对于从上午 8:15 MediaTailor 到上午 8:17 出现的每个广告时段，它都会评估每个广告时段SCTE的事件 ID。在每个播放会话中， MediaTailor 将预先提取的广告插入事件 ID 为 1234（如检索动态变量中所定义）的第一个广告插播中。对于不包含正确事件 ID 的广告插播时间，将 MediaTailor执行标准广告插入。
## 重复的预取计划流程
**检索**
这定义了*重复检索窗口*，即为直播活动 MediaTailor 预取和插入广告的时间范围（最长 24 小时）。下文概述了如何 MediaTailor 处理重复的预取计划。
有关在控制台中创建重复预取计划的步骤，请参阅[创建预取计划](creating-prefetch-schedules.md)。有关 API 的说明，请参阅《*AWS Elemental MediaTailor API 参考*》[PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)中的。
在指定的周期性预取窗口内， MediaTailor 检索和插入最长 24 小时的直播活动的广告。在窗口中每次广告插播后， MediaTailor 都会自动检索下一个广告时段的广告。
+ 如果您将*延迟设置为有效期结束后*，则会 MediaTailor 等待指定的时间，然后再检索下一组广告以备下一个广告时段。
+ MediaTailor （可选）使用流量整形来限制一次向 ADS 发出的请求数量。您可以在两种方法之间进行选择：
*时间窗口流量整形*-将请求 MediaTailor 分布在指定的秒数内，而不是一次性发送所有会话的请求。这种分散的流量分布有助于防止广告不堪重负，从而导致超时和低广告填充率。
*基于 TPS 的流量整形*-根据每秒交易量 (TPS) 和并发用户 MediaTailor 限制请求。此方法可根据您的 ADS 容量限制提供更直观的配置。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 如果您设置了*动态变量*，请在 MediaTailor 向 ADS 发出的请求中包含这些变量。 MediaTailor 使用这些变量将广告投放量与消费窗口期间的预提时间表进行匹配。有关更多信息，请参阅以下 “*消费*” 部分。
**Example**
直播活动从晚上 7 点持续到晚上 8:45，在此期间有四次广告中断。广告中断的时间表不可预测。您可以将周期性预取配置为从晚上 7 点到晚上 8:45，延迟时间为 10 分钟，流量调整窗口为 60 秒。每次成功后，都会 MediaTailor 检索下一个广告时段的广告。有效期结束十分钟后， MediaTailor 开始向 ADS 发送检索请求。凭借 60 秒的流量整形窗口和 500,000 个并发用户， MediaTailor 分发 ADS 请求以在 60 秒内实现每秒大约 8,333 笔交易的平均速率（500,000 个用户/60 秒=每秒 8,333 个请求），而不是同时发送所有请求。
检索配置包括动态变量键`scte.event`和值`1234`。 MediaTailor 在向 ADS 发出的请求中包含此变量，然后可使用该变量将特定广告商定位到事件 ID 1234。
**消费**
MediaTailor 遇到 SCTE-35 广告插播标记时，它会将预取的广告放置在广告插播时间点中。
+ 如果您设置了*检索到的广告过期时间*，则在指定的到期日之前，预取的广告可以被插入。
+ 如果您未设置可用性匹配标准，则会在消费窗口的第一个空白处 MediaTailor 插入广告。
+ 如果您确实为*可用*性*匹配**条件*设置了*动态变量键*，则会根据您在检索窗口中设置的动态变量来 MediaTailor 评估这些条件。只有在满足广告匹配条件的情况下，广告插播才有资格进行预取广告插入。 MediaTailor 在符合条件的第一个广告时段插入广告。
有关支持的可用性匹配条件的列表，请参阅上表中的 “*可用于广告预取*” 列。[MediaTailor ADS 请求的会话变量](variables-session.md)
**Example 持续**
在消费中，您将密钥包含`scte.event_id`在可用性匹配标准中。
对于 MediaTailor 遇到的每个广告插播时间，它都会评估每个广告插播时间SCTE的事件 ID。在每个播放会话中， MediaTailor 将预先提取的广告插入事件 ID 为 1234（如检索动态变量中所定义）的每个广告插播时间。对于不包含正确事件 ID 的广告插播时间，将 MediaTailor 执行标准广告插入。
您将广告过期时间设置为 2700 秒，因此检索到的广告在 45 分钟内可供插入。
下图说明了该示例，小方块代表广告插播时间。重复的预取计划设置在事件时间轴上进行了说明。
![\[直播活动的图形插图，包括重复的预取计划配置。\]](http://docs.aws.amazon.com/zh_cn/mediatailor/latest/ug/images/recurring_prefetch_timeline.png)
## 了解预取成本
提出广告检索请求不收取任何费用。但是，对于预取广告，您需要按照标准转码费率对预取的转码广告收费。 MediaTailor 对于预取广告的消费，对于在广告插播时间段中放 MediaTailor 置的预取广告，将按标准费率向您收取广告插播费用。有关转码和广告插入费用的信息，请参阅[AWS Elemental MediaTailor 定价](https://aws.amazon.com/mediatailor/pricing/)。
# 创建预取计划
以下过程说明如何使用 MediaTailor控制台创建预回迁时间表。*有关使用 API 以编程方式创建和管理预取计划的信息，请参阅 MediaTailor API 参考[PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)中的AWS Elemental MediaTailor 。*
**注意**
在中配置预取计划时 MediaTailor，了解不同类型的变量是如何处理的，这一点很重要。
**可用匹配标准**
如果要在计划中使用可用匹配条件，请务必先使用[动态会话变量](variables-session.md)配置播放配置的 ADS 网址模板，否则可用性匹配条件将不会生效。有关使用动态会话变量的信息，请参阅 MediaTailor广告插入入门主题[步骤 3：配置 ADS 请求网址和查询参数](getting-started-ad-insertion.md#getting-started-configure-request)中的。
**预取时间表中的玩家变量**
创建预取计划时，不要在预取配置中将玩家变量定义为动态变量。取而代之的是，像往常一样在会话开始时传递玩家变量。 MediaTailor 如果这些变量映射在 ADS 模板网址中，则这些变量会自动包含在预取广告请求中。
**使用控制台创建新的预回迁时间表**
1. 打开 MediaTailor 控制台，网址为[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)。
1. 在导航窗格中，选择**配置**。选择要为其创建预回迁计划的播放配置。
1. 在 “**预回迁计划**” 选项卡上，选择 “**添加预回迁**计划”。
1. 在 “**预回迁计划详细信息**” 窗格下，执行以下操作：
+ 在 “**名称**” 中，输入预回迁计划的标识符，例如**my-prefetch-schedule**。
+ 对于**直播 ID**，可以选择输入唯一的 ID。如果您的来源包含多个播放流，则可以使用此 ID MediaTailor 来指示在特定直播中投放广告。例如，如果您的播放配置包含体育直播和电视节目直播，则可以使用直播 ID 创建预取时间表，以插入针对体育直播的广告。您可以在客户端的会话初始化或清单请求 MediaTailor 中将流 ID 值传递给。有关更多信息，请参阅以下示例。
+ 要进行*服务器端跟踪*，请在客户端对 MediaTailor 终端节点的`GET HTTP`请求中包含`?aws.streamId`查询参数和值。有关服务器端跟踪的一般信息，请参阅[MediaTailor 服务器端广告跟踪和报告](ad-reporting-server-side.md)。向包含直播 ID 的 HLS 终端节点发出的清单请求如下所示，其中`myStreamId`是您的直播 ID 的名称：
```
GET /v1/master///?aws.streamId=myStreamId
```
+ 要进行*客户端跟踪*，请在客户端的`POST HTTP`会话初始化请求正文中包含`streamId`密钥和值**MediaTailor/v1/session**。有关客户端跟踪的一般信息，请参阅[客户端广告跟踪](ad-reporting-client-side.md)。包含直播 ID 的会话初始化请求如下所示，其中`myStreamId`是您的直播 ID 的名称：
```
POST /v1/session///
{
'streamId': 'myStreamId',
'reportingMode': 'client'
}
```
1. 对于 **Prefetch 类型**，请进行选择并选择相应的部分，以获得有关其他字段的帮助：
+ 如果您要为活动中的一个广告时段创建一个预取时间表，请选择 “**单**个”。
+ 如果您要创建的时间表，以便在活动中的每个广告中断之前自动预取广告，请选择 “重**复**”。
## 单次预取时间表
创建一个时间表，在活动中投放一个广告之前预先获取广告。
1. 在 “**检索**” 窗格上，指定要使用的检索设置。这些设置决定何时从 ADS MediaTailor 中预取广告。它们还会决定在 ADS 请求中包含哪些动态会话变量（如果有）。
+ 在 “**开始时间**” 中，输入 MediaTailor 可以开始检索此广告时段的预取时间。 MediaTailor 将尝试针对您的客户在此时间或之后提出的清单请求预取广告。默认值为当前时间。如果您未指定值，则该服务会尽快开始预取检索。
+ 在 “**结束时间**” 中，输入您希望停止 MediaTailor 为此广告时段预取广告的时间。 MediaTailor 将尝试预取在此时间或之前出现的清单请求的广告。检索窗口可以与消费窗口重叠。
+ （可选）配置流量整形以限制一次向 ADS 发出的请求数量。选择以下方法之一：
*时间窗口方法*：对于**流量调整窗口持续时间**，请输入 MediaTailor 应将请求分发到 ADS 的秒数。有关更多信息，请参阅[单一预回迁时间表检索说明](understanding-prefetching.md#avail-matching-criteria-retr)。
*基于 TPS 的方法*：配置**峰值 TPS** 和**峰值并发用户**，以根据每秒交易量和并发用户数限制请求。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 在 “[**动态变量**](variables.md)” 部分，输入多达 100 个动态会话变量。 MediaTailor 在发送给 ADS 的预取请求中使用这些变量进行替换。如果您未输入任何动态会话变量， MediaTailor 请尽力插值 [AD](configurations-create.md#configurations-create-main) S 网址中包含的动态变量的值。
+ 选择 “**添加动态变量**”。
+ 对于 **Key**，输入动态会话变量密钥，例如`scte.event_id`。您可以使用任何 MediaTailor 支持的动态变量。有关动态会话变量的信息，请参见[MediaTailor ADS 请求的会话变量](variables-session.md)。
+ 在 “**值**” 中，输入动态变量值，例如*my-event*。
+ 要添加其他动态变量，请选择选择**添加动态变量**。
1. 在 “**消费**” 窗格上，指定要用于消费窗口的设置。这些设置决定了何时将广告放 MediaTailor 置在广告插播中。它们还会确定您要使用的任何可用性匹配标准。
+ 在 “**开始时间**” 中，输入您想要 MediaTailor 开始将预取广告放置到广告插播时间点的时间。默认值为当前时间。如果您未指定时间，则该服务会尽快开始使用预取数据。
+ 在 “**结束时间**” 中，输入您希望 MediaTailor 停止将预取的广告放入广告插播时间点的时间。 MediaTailor 将尝试针对您的客户在此时间或之前提出的清单请求预取广告。结束时间必须晚于开始时间，且距离现在不到一天。消费窗口可以与检索窗口重叠。
+ 在 “[**可用性匹配条件**](variables.md)” 部分中，选择 “**添加可用性标准**”，然后将尽可能多的广告五个可用性匹配条件添加到您的日程安排中。然后，在 “**动态变量键**” 下，添加动态变量键，例如`scte.event_id`。 MediaTailor *只有*当预取的广告符合由您的客户传递给的动态变量值或从会话数据等信息中推断出的动态变量值定义的条件时 MediaTailor，才会将其放置在广告插 MediaTailor 播中。如果广告插播时间不符合指定的匹配条件，则会 MediaTailor 跳过该广告插播时间的预取。有关信息，请参阅[单次预取计划消耗说明](understanding-prefetching.md#avail-matching-criteria)。
1. 选择 “**添加可用性标准**”。
预取计划在消费窗口结束时间后自动过期。出于诊断目的，它们至少会在 7 天内保持可见，之后它们 MediaTailor 会自动删除。或者，您可以随时手动删除预回迁时间表。有关如何手动删除预回迁时间表的信息，请参阅下一[删除预回迁计划](deleting-prefetch-schedules.md)节。
### 确定您的客户应多久调用 CreatePrefetchSchedule API 的频率
如果您确切知道广告中断的发生时间，则您的客户可以每天以编程方式调用一次 [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html)API 来设置检索和消费。或者，您的客户可以在一天中多次调用 API 来定义检索和使用。选择 API 调用频率时，请考虑[有效预取计划的最大数量](quotas.md#prefetch-schedules-limit)，以及在您创建预取计划后您的广告中断时间表是否会发生变化的可能性。如果在您创建了预提时间表之后，广告中断时间表可能会发生变化，那么您可能需要更频繁地调用 API。
## 定期预取计划
创建时间表，在活动中每个广告投放之前预先获取广告。
1. 在**重复检索**窗格上，指定要使用的检索设置。这些设置决定何时从 ADS MediaTailor 中预取广告。它们还会决定在 ADS 请求中包含哪些动态会话变量（如果有）。
+ 在 “**重复预取” 窗口中**，输入此广告时段 MediaTailor 可以开始预取回的时间。 MediaTailor 将尝试针对您的客户在此时间或之后提出的清单请求预取广告。默认值为当前时间。如果您未指定值，则该服务会尽快开始预取检索。
+ 对于可用性**结束后的延迟**，请输入在可用性结束后等待的秒数，然后再预取下一个可用性的广告。 MediaTailor如果未指定值，则 MediaTailor 默认为无延迟。
+ （可选）配置流量整形以限制一次向 ADS 发出的请求数量。选择以下方法之一：
*时间窗口方法*：对于**流量调整窗口持续时间**，请输入 MediaTailor 应将请求分发到 ADS 的秒数。有关更多信息，请参阅[重复预取计划检索说明](understanding-prefetching.md#avail-matching-criteria-recurring-retr)
*基于 TPS 的方法*：配置**峰值 TPS** 和**峰值并发用户**，以根据每秒交易量和并发用户数限制请求。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 在 “[**动态变量**](variables.md)” 部分，输入多达 100 个动态会话变量。 MediaTailor 在发送给 ADS 的预取请求中使用这些变量进行替换。如果您未输入任何动态会话变量， MediaTailor 请尽力插值 [AD](configurations-create.md#configurations-create-main) S 网址中包含的动态变量的值。
+ 选择 “**添加动态变量**”。
+ 对于 **Key**，输入动态会话变量密钥，例如`scte.event_id`。您可以使用任何 MediaTailor 支持的动态变量。有关动态会话变量的信息，请参见[MediaTailor ADS 请求的会话变量](variables-session.md)。
+ 在 “**值**” 中，输入动态变量值，例如*my-event*。
+ 要添加其他动态变量，请选择选择**添加动态变量**。
1. 在 “**消费**” 窗格上，指定要用于消费窗口的设置。这些设置决定了何时将广告放 MediaTailor 置在广告插播中。它们还会确定您要使用的任何可用性匹配标准。
+ 对于**检索到的广告过期**，请指明检索广告在多长时间内可供插入。
+ 在 “[**可用性匹配条件**](variables.md)” 部分中，选择 “**添加可用性标准**”，然后将尽可能多的广告五个可用性匹配条件添加到您的日程安排中。然后，在 “**动态变量键**” 下，添加动态变量键，例如`scte.event_id`。 MediaTailor *只有*当预取的广告符合由您的客户传递给的动态变量值或从会话数据等信息中推断出的动态变量值定义的条件时 MediaTailor，才会将其放置在广告插 MediaTailor 播中。如果广告插播时间不符合指定的匹配条件，则会 MediaTailor 跳过该广告插播时间的预取。有关信息，请参阅[定期预取计划消耗说明](understanding-prefetching.md#avail-matching-criteria-recur)。
1. 选择 “**添加可用性标准**”。
预取计划在消费窗口结束时间后自动过期。出于诊断目的，它们至少会在 7 天内保持可见，之后它们 MediaTailor 会自动删除。或者，您可以随时手动删除预回迁时间表。有关如何手动删除预回迁时间表的信息，请参阅下一[删除预回迁计划](deleting-prefetch-schedules.md)节。
# 基于 TPS 的流量整形
AWS Elemental MediaTailor 提供了两种可选的流量整形方法，用于限制一次向 ADS 发出的请求数量。基于 TPS 的流量整形为预取计划提供了一种替代基于时间窗的流量整形。这种方法允许您根据每秒交易量 (TPS) 和预期并发用户而不是时间计算来指定广告决策服务器 (ADS) 容量，从而提供更直观的配置。
## 基于 TPS 的流量整形的工作原理
您无需指定检索窗口的持续时间，而是提供以下参数：
峰值 TPS
您的 ADS 每秒可以处理的最大请求数。此参数没有默认值。
并发用户峰值
您的内容的预期并发观看人数峰值。此参数没有默认值。
MediaTailor 无论并发会话数量多少，都会自动将预回迁请求分发到指定的 TPS 限制之内。
**Example 基于 TPS 的配置示例**
你的广告可以处理 500 TPS，你预计在高峰时段会有 100,000 名并发观众。您可以配置：
+ 峰值 TPS：500
+ 并发用户峰值：100,000
MediaTailor 无论并发会话数量多少，都会自动将预回迁请求分发到指定的 TPS 限制之内。
# 删除预回迁计划
以下过程说明如何使用 MediaTailor控制台删除预回迁时间表。*有关如何使用 API 以编程方式删除预取计划的信息，请参阅 MediaTailor API 参考[DeletePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePrefetchSchedule.html)中的AWS Elemental MediaTailor 。*
**注意**
删除不是实时发生的。在 MediaTailor 删除预回迁时间表时，您可能会遇到延迟，在此期间，预回迁的检索和使用将继续在后台运行。
**使用控制台删除预回迁时间表**
1. 打开 MediaTailor 控制台，网址为[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)。
1. 在导航窗格中，选择**配置**。选择包含要删除的预回迁计划的播放配置。
1. 在 “**预回迁计划**” 选项卡上，选择要删除的预回迁时间表。然后选择**删除**。