目录引入最佳实践
目录引入最佳实践
在Fire TV上集成您的目录时，请使用这些最佳实践。
一般集成
- 为所有内容使用唯一的
ID。更新现有目录时，内容的ID不应更改。如果一个ID从您的目录中消失，就会从亚马逊的索引中删除它。如果内容稍后返回，它应该具有与以前相同的ID。避免在亚马逊引入您的目录后更改ID和ID方案。如果您在引入后更改了ID方案，将删除亚马逊对其他内容所做的任何匹配。如果您在启动后更改ID，您的目录将被挂起。 - 要使用特定的视频质量、音频语言和字幕（或是这三者的任意子集）配置启动作品，可使用
LaunchId元素。LaunchId不存在格式要求，但应用的逻辑必须理解其格式。当客户从您的应用启动内容时，Fire TV会启动广播中指示的类。它还将目录中配置的LaunchId传递给您的应用。 - 要指定您的内容是有配音的、原创的和/或有字幕的，请使用
AudioLanguage和Subtitle元素。根据需要纳入尽可能多的元素，以指定作品的可用替代方案。这有助于亚马逊向客户展示正确的语言信息。 - 使用
ReleaseYear和Credits元素来帮助进行内容匹配。在不同作品有相同标题的情况下使用这些元素很重要 - 亚马逊使用这些元素来确定作品是否重复。 - 您目录中的所有作品都应在
Offers下至少包含一项优惠。优惠项允许客户播放指定作品。如果作品可免费观看，您可以定义FreeOffer，而SubscriptionOffer则需要订阅才能观看。在给定的时间窗口内，作品可用的优惠类型只能有一种。 - 由季和剧集组成的电视连续剧必须遵循
TvShow、TvSeason和TvEpisode层次结构。对于给定的电视连续剧，您应该只有一个TvShow条目。一个TvShow可以有多个由ShowID链接的TvSeason条目。如果TvSeason没有明确的数字，您可以使用唯一的播出日期。TvEpisode条目通过ShowID链接至TvShow。相似地，SeasonID将TvEpisode链接至TvSeason。 - 不属于传统节目-季-剧集电视层次结构的电视活动可以导出为
Movie。您应该只在一次性活动中这样做，比如节假日特惠。
内容的可发现性
- 使用
ExternalID元素可以共享在外部源（如IMDb）中使用的内容的标识符。亚马逊在内容匹配中使用此值。通过将内容与其他目录进行比较，亚马逊可以确定它们是否相同，从而提高发现能力。 - 在目录导出中优先考虑相关和可搜索的内容。拥有可能不再与客户相关的内容（如新闻）可能会影响其他内容的可发现性。任何长度在10分钟以下的作品都不会被引入。目录的大小会影响验收测试所花费的时间。
- 客户无法立即获得目录的新更新。目录上传后，内容可能需要长达14个小时才能出现在客户面前。为任何作品定义
MetadataAvailabilityDate以将其隐藏到给定日期。将MetadataAvailabilityDate与WindowStart相结合，将在首映时显示信息。
启动器集成
- 验证所有用户状态的深层链接行为。完成启动器集成后，通过运行在步骤2： 从目录验证深层链接中列出的测试案例对其进行验证。具体来说，确保当客户选择内容时，应用会根据Android的意图直接在预期的屏幕中启动。如果应用发送了播放意图，则应显示视频播放屏幕；如果应用发出了登录意图，则显示登录或注册屏幕。验证行为是否正确有助于亚马逊应用商店接受您的应用。
- 验证The Buy Box（购买框）是否根据权利正确填充。
- 如果用户安装了您的应用并已登录，则您的内容应显示在主屏幕上，显示为Watch Now with <您的应用>。
- 如果您的应用包含内容，但用户没有安装您的应用或没有登录，您的应用可能会出现在主屏幕上或More Ways to Watch（更多观看方式）中。
- 如果您的应用也是Prime视频频道，请验证是否有以下正确行为：
- 如果用户通过您的应用而不是Prime视频频道订阅，则该应用应在主屏幕上显示为Watch Now with <您的应用>。
- 如果您的应用也是Prime视频频道，而用户没有安装您的应用，那么在Prime视频频道是价格较低的选项或包含免费试用的情况下，它可能会出现在购买框中。
- 有关购买框以及验证其是否正确填充的更多信息，请参阅The Buy Box。
Last updated: 2023年3月24日