最佳实践和常见问题解答


最佳实践和常见问题解答

本节介绍合作伙伴托管行 (PMR) 的最佳实践和常见问题解答。

最佳实践

  • 请勿提高优先级 - 许多应用使用的优先级值似乎高于官方文档指定的优先级值。我们使用 EXTRA_AMAZON_RANK。如果不存在该值,我们将使用推荐新近度来确定排序位置。如果存在该值,则首先按排名的升序顺序对项目排序,然后按提交时间排序,最近的项目最先列出。
  • 不要保留陈旧卡片 - 确保您的内容仍然相关,并删除陈旧或过时的卡片。此外,不要实例化“已经过时”的卡片,确保您在某种程度上跟踪之前显示(和访问过)的内容。例如,如果用户观看完了推荐内容,您可能希望使用上述删除推荐的说明删除该特定项目。

    如果您不遵循这些个性,用户可能会手动完全关闭您的推荐;在最坏的情况下,用户可能会感到沮丧,以至于他们寻找更快的途径,直接卸载您的应用,并可能会在亚马还应用商店中留下负面评级。

  • 安卓的 50 个通知限制 - 安卓强制对每个程序包施加最多 50 个通知的限制。这包括应用打算使用的推荐和任何其他通知。(请参阅 NotificationServiceManager 中的 MAX_PACKAGE_NOTIFICATIONS。) 因此,请确保在发送新通知之前取消旧通知(如果数量超过 50)。否则,您可能会看到日志错误,例如: W/NotificationManager﹕ notify: id corrupted: sent 51, got back 0.
  • 个性化 - 根据应用中用户的兴趣、个人资料和最近活动以及其他参数进行个性化设置的推荐最为有效。用户可能会发现个性化推荐比一般推荐更有效和更具吸引力。
  • 限制一次性提出的推荐数量 - 我们建议不要一次发送很多推荐。请考虑以小组形式(一次大约 5 个)批处理推荐。PMR 显示的最低推荐数量为 5。此要求是为了确保 Fire TV UI 看起来一致。
  • 作为后台应用发送推荐 - 发送推荐的可能触发点是按重复间隔安排 AlarmManager,并在到期日安排安卓 JobScheduler 作业或 Syncadapter 任务。
  • 如果您的应用签名发生变化 - 我们会使用应用签名来检查推荐发件人的有效性。如果您将来打算更改应用签名,请联系亚马逊开发者门户。此外,请遵循有关向亚马逊应用商店提交应用更新的标准操作程序。请使用发布签名和程序包名称作为开发的生产应用,这可能涉及到旁加载应用。
  • 处理后退按钮事件 - 如果您的应用捕获后退按钮事件,请勿发送导航至 Fire TV 主页的意图,而是在处理应用中最后一个后退按钮事件时退出应用。这将允许用户导航回 PMR 行。

常见问题解答

重新启动后 PMR 行丢失
在用户导航到特定类别时,UI 不会更新 PMR 行的内容。例如,从主页部分遍历到其他部分(如电影电视节目)(以及反向遍历)将强制更新 UI。然后 PMR 将反映您的应用自启动以来发送的推荐。

OTA 更新后 PMR 行丢失
服务器 API 调用生存时间 (TTL) 为 5 小时。要强制刷新,请按照下列步骤操作:

  1. 遍历到“设置”选项。
  2. 在此选择“我的账户”选项。
  3. 单击“同步亚马逊内容”部分。
  4. 推荐行现在应显示在“主页”和/或“我的视频”部分下。

启用开发者行
开发者行可帮助应用开发者在 PMR 示例行上测试他们的推荐。开发者可以测试他们的推荐显示在 Fire TV 上时的外观和风格。从第 2 代 Fire TV 和第 2 代 Fire TV Stick 上的 Fire OS 5.2.4.0 版本开始提供开发者行。

要启用开发者行,请按照以下步骤操作:

  1. 按住 SELECT + 向下方向键 3 秒钟打开“开发者工具”菜单,然后按 Fire TV 遥控器上的 MENU。同样,在亚马逊游戏控制器上,按住 A + Y 3 秒钟,然后按 MENU 按钮。

  2. 打开“开发者选项”。

  3. 打开“开发者行”。所有已安装的应用程序包将显示在列表视图中。要在 PMR 示例行中测试您的推荐,请选择您的程序包名称。

  4. 按“确定”。

  5. 重新启动设备。

资源

PMR 参考

PMR API 指南