本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建预取计划
<a name="creating-prefetch-schedules"></a>

以下过程说明如何使用 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 <mediatailorURL>/v1/master/{{<hashed-account-id>}}/{{<origin-id>}}/{{<asset-id>}}?aws.streamId={{myStreamId}}
       ```
     + 要进行*客户端跟踪*，请在客户端的`POST HTTP`会话初始化请求正文中包含`streamId`密钥和值**MediaTailor/v1/session**。有关客户端跟踪的一般信息，请参阅[Client-side 广告跟踪](ad-reporting-client-side.md)。包含直播 ID 的会话初始化请求如下所示，其中`{{myStreamId}}`是您的直播 ID 的名称：

       ```
       POST <mediatailorURL>/v1/session/{{<hashed-account-id>}}/{{<origin-id>}}/{{<asset-id>}}
       {
           'streamId': '{{myStreamId}}',
           'reportingMode': 'client'
       }
       ```

1. 对于 **Prefetch 类型**，请进行选择并选择相应的部分，以获得有关其他字段的帮助：
   + 如果您要为活动中的一个广告时段创建一个预取时间表，请选择 “**单**个”。
   + 如果您要创建的时间表，以便在活动中的每个广告中断之前自动预取广告，请选择 “重**复**”。

## 单次预取时间表
<a name="single-prefetch"></a>

创建一个时间表，在活动中投放一个广告之前预先获取广告。

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 的频率
<a name="how-often"></a>

如果您确切知道广告中断的发生时间，则您的客户可以每天以编程方式调用一次 [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html)API 来设置检索和消费。或者，您的客户可以在一天中多次调用 API 来定义检索和使用。选择 API 调用频率时，请考虑[有效预取计划的最大数量](quotas.md#prefetch-schedules-limit)，以及在您创建预取计划后您的广告中断时间表是否会发生变化的可能性。如果在您创建了预提时间表之后，广告中断时间表可能会发生变化，那么您可能需要更频繁地调用 API。

## 定期预取计划
<a name="recurring-prefetch"></a>

创建时间表，在活动中每个广告投放之前预先获取广告。

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)节。