创建预取计划 - AWS Elemental MediaTailor
确定您的客户应该多久打电话一次 CreatePrefetchSchedule API

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

创建预取计划

以下过程说明如何使用 MediaTailor控制台创建预回迁时间表。有关使用以编程方式创建和管理预回迁计划的信息 MediaTailor API，请参阅中的 PrefetchSchedulesAWS Elemental MediaTailor API参考。

注意

如果要在计划中使用可用匹配条件，请务必先使用动态变量配置播放配置的ADSURL模板，否则可用性匹配条件将不会生效。有关使用动态变量的信息，请参阅 MediaTailor广告插入入门主题步骤 3：配置ADS请求URL和查询参数中的。

使用控制台创建新的预回迁时间表

  1. 打开 MediaTailor 控制台，网址为https://console.aws.amazon.com/mediatailor/。

  2. 在导航窗格中，选择配置。选择要为其创建预回迁计划的播放配置。

  3. 在 “预回迁计划” 选项卡上，选择 “添加预回迁计划”。

  4. 在 “预回迁计划详细信息” 窗格下，执行以下操作：

    • 在 “名称” 中，输入预回迁计划的标识符，例如my-prefetch-schedule。

    • 对于直播 ID，可以选择输入唯一的 ID。如果您的来源包含多个播放流，则可以使用此 ID MediaTailor 来指示在特定直播中投放广告。例如，如果您的来源有体育直播和电视节目直播，则您可以使用直播ID创建预取时间表，以插入针对该体育直播的广告。您可以在客户端的会话初始化或清单请求 MediaTailor 中将流 ID 值传递给。有关更多信息，请参阅以下示例。

      • 要进行服务器端跟踪，请在客户端对 MediaTailor 终端节点的GET HTTP请求中包含?aws.streamId查询参数和值。有关服务器端跟踪的一般信息，请参阅服务器端广告跟踪。向包含流 ID 的HLS终端节点发出的清单请求如下所示，其中myStreamId是您的直播 ID 的名称：

        GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

      • 要进行客户端跟踪，请在客户端的POST HTTP会话初始化请求正文中将streamId密钥和值添加到 MediaTailor/v 1/session 端点。有关客户端跟踪的一般信息，请参阅客户端广告跟踪。包含直播 ID 的会话初始化请求如下所示，其中myStreamId是您的直播 ID 的名称：

        POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
{
    'streamId': 'myStreamId'
}
      显示更多显示更少

  5. 在 “检索” 窗格上，指定要使用的检索设置。这些设置决定何时从中 MediaTailor 预取广告。ADS它们还会确定在请求中包含哪些动态变量（如果ADS有）。

    • 在 “开始时间” 中，输入 MediaTailor 可以开始检索此广告时段的预取时间。 MediaTailor 将尝试针对您的客户在此时间或之后提出的清单请求预取广告。默认值为当前时间。如果您未指定值，则该服务会尽快开始预取检索。

    • 在 “结束时间” 中，输入您希望停止 MediaTailor 为此广告时段预取广告的时间。 MediaTailor 将尝试预取在此时间或之前提出的清单请求的广告。检索窗口可以与消费窗口重叠。

    • 在动态变量部分中，输入多达 100 个动态变量。 MediaTailor 在发送给的预取请求中使用这些变量进行替换。ADS如果您未输入任何动态变量， MediaTailor请尽最大努力为包含在中的动态变量的值进行插值。ADSURL

      • 选择 “添加动态变量”。

      • 对于 Key，输入动态可变密钥，例如scte.event_id。您可以使用任何 MediaTailor 支持的动态变量。有关动态变量的信息，请参见在中使用动态广告变量 MediaTailor。

      • 对于 “值”，输入动态变量值，例如 my-event.

      • 要添加其他动态变量，请选择选择添加动态变量。

  6. 在 “消费” 窗格上，指定要用于消费窗口的设置。这些设置决定了何时将广告放 MediaTailor 置在广告插播中。它们还会确定您要使用的任何可用性匹配标准。

    • 在 “开始时间” 中，输入您想要 MediaTailor 开始将预取广告放置到广告插播时间点的时间。默认值为当前时间。如果您未指定时间，则该服务会尽快开始使用预取数据。

    • 在 “结束时间” 中，输入您希望 MediaTailor 停止将预取的广告放入广告插播时间点的时间。 MediaTailor 将尝试针对您的客户在此时间或之前提出的清单请求预取广告。结束时间必须晚于开始时间，且距离现在不到一天。消费窗口可以与检索窗口重叠。

    • 在 “可用性匹配条件” 部分中，选择 “添加可用性标准”，然后将尽可能多的广告五个可用性匹配条件添加到您的日程安排中。然后，在动态变量键下，添加动态变量键，例如scte.event_id。 MediaTailor 只有当预取的广告符合由您的客户传递给的动态变量值或从会话数据等信息中推断出的动态变量值定义的条件时 MediaTailor，才会将其放置在广告插 MediaTailor 播中。有关信息，请参阅上一节avail-matching-criteria。

  7. 选择 “添加可用性标准”。

预取计划在消费窗口结束时间后自动过期。出于诊断目的，它们至少会在 7 天内保持可见，之后它们 MediaTailor 会自动删除。或者，您可以随时手动删除预回迁时间表。有关如何手动删除预回迁时间表的信息，请参阅下一删除预回迁计划节。

确定您的客户应该多久打电话一次 CreatePrefetchSchedule API

如果您确切知道广告中断何时会发生，则您的客户可以通过编程方式每天调用CreatePrefetchScheduleAPI一次来设置检索和消费。或者，您的客户可以在一天中API多次致电，以定义检索和消费。在选择API通话频率时，请考虑 MediaTailor有效预取计划的最大数量，以及在您创建预取时间表后广告中断时间表是否会发生变化的可能性。如果在您创建了预提时间表之后，广告中断时间表可能会发生变化，那么您可能需要API更频繁地致电预提取。