开发者控制台

目录引入最佳实践

目录引入最佳实践

在Fire TV上集成您的目录时,请使用这些最佳实践。

一般集成

  • 为所有内容使用唯一的ID。更新现有目录时,内容的ID不应更改。如果一个ID从您的目录中消失,就会从亚马逊的索引中删除它。如果内容稍后返回,它应该具有与以前相同的ID。避免在亚马逊引入您的目录后更改ID和ID方案。如果您在引入后更改了ID方案,将删除亚马逊对其他内容所做的任何匹配。如果您在启动后更改ID,您的目录将被挂起。
  • 要使用特定的视频质量、音频语言和字幕(或是这三者的任意子集)配置启动作品,可使用LaunchId元素。LaunchId不存在格式要求,但应用的逻辑必须理解其格式。当客户从您的应用启动内容时,Fire TV会启动广播中指示的类。它还将目录中配置的LaunchId传递给您的应用。
  • 要指定您的内容是有配音的、原创的和/或有字幕的,请使用AudioLanguageSubtitle元素。根据需要纳入尽可能多的元素,以指定作品的可用替代方案。这有助于亚马逊向客户展示正确的语言信息。
  • 使用ReleaseYearCredits元素来帮助进行内容匹配。在不同作品有相同标题的情况下使用这些元素很重要 - 亚马逊使用这些元素来确定作品是否重复。
  • 您目录中的所有作品都应在Offers下至少包含一项优惠。优惠项允许客户播放指定作品。如果作品可免费观看,您可以定义FreeOffer,而SubscriptionOffer则需要订阅才能观看。在给定的时间窗口内,作品可用的优惠类型只能有一种。
  • 由季和剧集组成的电视连续剧必须遵循TvShowTvSeasonTvEpisode层次结构。对于给定的电视连续剧,您应该只有一个TvShow条目。一个TvShow可以有多个由ShowID链接的TvSeason条目。如果TvSeason没有明确的数字,您可以使用唯一的播出日期。TvEpisode条目通过ShowID链接至TvShow。相似地,SeasonIDTvEpisode链接至TvSeason
  • 不属于传统节目-季-剧集电视层次结构的电视活动可以导出为Movie。您应该只在一次性活动中这样做,比如节假日特惠。

内容的可发现性

  • 使用ExternalID元素可以共享在外部源(如IMDb)中使用的内容的标识符。亚马逊在内容匹配中使用此值。通过将内容与其他目录进行比较,亚马逊可以确定它们是否相同,从而提高发现能力。
  • 在目录导出中优先考虑相关和可搜索的内容。拥有可能不再与客户相关的内容(如新闻)可能会影响其他内容的可发现性。任何长度在10分钟以下的作品都不会被引入。目录的大小会影响验收测试所花费的时间。
  • 客户无法立即获得目录的新更新。目录上传后,内容可能需要长达14个小时才能出现在客户面前。为任何作品定义MetadataAvailabilityDate以将其隐藏到给定日期。将MetadataAvailabilityDateWindowStart相结合,将在首映时显示信息。

启动器集成

  • 验证所有用户状态的深层链接行为。完成启动器集成后,通过运行步骤2: 从目录验证深层链接中列出的测试案例来验证它。具体来说,确保当客户选择内容时,应用会根据Android的意图直接在预期的屏幕中启动。如果应用发送了播放意图,则应显示视频播放屏幕;如果应用发出了登录意图,则显示登录或注册屏幕。验证行为是否正确有助于亚马逊应用商店接受您的应用。
  • 验证The Buy Box(购买框)是否根据权利正确填充。
    • 如果用户安装了您的应用并已登录,则您的内容应显示在主屏幕上,显示为Watch Now with <your app>(用<您的应用>立即观看)。
    • 如果您的应用包含内容,但用户没有安装您的应用或没有登录,您的应用可能会出现在主屏幕上或More Ways to Watch(更多观看方式)中。
    • 如果您的应用也是Prime视频频道,请验证是否有以下正确行为:
      • 如果用户通过您的应用而不是Prime视频频道订阅,则该应用应在主屏幕上显示为Watch Now with <your app>
    • 如果您的应用也是Prime视频频道,而用户没有安装您的应用,那么在Prime视频频道是价格较低的选项或包含免费试用的情况下,它可能会出现在购买框中。
    • 有关购买框以及验证其是否正确填充的更多信息,请参阅The Buy Box