在您的游戏中构建自定义推荐系统，以展示策划内容，例如2D和3D资产、迷你游戏、其他游戏等。Recommendation Service API 允许您记录用户活动、捕获展示，并提供几乎任何类型参与的个性化结果。
推荐系统的一些常见用例包括向用户展示回合结束时的建议接口、展示个性化操作的菜单覆盖或其他向用户呈现独特选择、资产、位置或游戏的实现。
使用以下通用步骤和最佳实践来设置您的推荐系统：
本指南涵盖在您的游戏中实施RecommendationService的过程。此内容不涵盖创建用户界面、添加资产或传送用户的过程。有关这些主题，请参阅其他文档。
注册您的内容
您可以通过多种方式在游戏中实现推荐。此指南中的示例设置旨在向用户推荐各种游戏内的迷你游戏，优先推荐最有可能最大化高质量游戏时段的内容。
此类推荐系统通常包含在旋转木马用户界面菜单中，使用户可以滚动、选择并查找他们即将参与的活动的更多细节。以下设置中包括了对此类界面的考虑。
如果创建自己的系统，您可能需要使用稍微不同的设置和配置，但遵循相同的基本步骤。
要填充您的推荐系统可以向用户提供的内容，请使用RegisterItemAsync。在注册项目时，提供一个 referenceId，这是一个开发人员定义的字符串，用于唯一标识您自己数据库中的项目。此 referenceId 通常用于从数据存储中查找项目的元数据，例如名称、描述或资产ID，以便在用户界面中显示。
作为最佳实践，尽早注册项目，以确保推荐池始终是最新的。
记录用户展示
一旦服务知道您的项目并开始建议它们，请使用LogImpressionEvent告知服务用户何时实际查看推荐。
何时记录
旋转木式UI是向用户展示多个可玩选项的常见界面。使用以下最佳实践，以确保您的日志记录提供有用的可操作数据：
- 单次日志：每个会话对特定项目仅记录一次展示。
- 不要每次项目出现时都记录，因为这会产生嘈杂信息，干扰您的日志记录。
- 触发：您可以选择在项目完全在菜单中可见时记录，或在用户与该项目交互时记录，例如打开详细页面。
对于传递给RecommendationService.LogImpressionEvent的ID, 请格外小心。该服务需要将事件严格链接到它生成的特定推荐实例。
- 不要使用原始字符串或引用ID。
持续时间
持续时间跟踪展示的时间。您可以将其视为用户注视图像或推荐的时间。
如果您不使用视频，您可以将持续时间值设置为1。这确保您得到干净一致的数据，表示“用户查看了此项目”，通常这是静态卡片所需的唯一日志记录。
记录高质量操作
当用户决定与推荐进行交互时，使用LogActionEvent。在此示例中，仅在推荐上点击“播放”并不足以为高质量推荐系统提供足够的信号。重要的是要区分偶然点击和真实会话之间的不同。
要求的操作类型
当您调用LogActionEvent时，必须指定发生的操作类型。要跟踪导致游戏会话的操作事件，请使用Enum.RecommendationActionType.Play。使用正确的枚举是非常重要的，以告诉后台特定类型的操作已被激活。对于与游戏时间相关的推荐，Enum.RecommendationActionType.Play是严格要求的，以匹配下一步中用于获取推荐的MaximizePlays配置模板。如果使用其他枚举，模型将无法正确注册与游戏相关的操作事件。
“高质量游戏”策略
根据您的游戏，您可能对“高质量游戏”有不同的定义。使用以下步骤帮助微调您情况中高质量游戏的差异。
- 内部跟踪：当用户进入迷你游戏时，在您的脚本中本地跟踪他们的会话时间。
- 过滤：定义满意度的阈值，例如玩超过60秒。
- 记录：只有在用户超过此阈值时，才能触发LogActionEvent。
仅为由RecommendationService实际提供的项目记录操作。
- 不要记录来自搜索、随机选择或过去游戏的播放。
- 不要使用“虚假跟踪ID”将这些强制输入系统。
模型期望一个现实的比率。如果您提供1次展示但记录10次来自外部流量的播放，那么您会混淆训练数据，破坏指标的准确性。
获取推荐
要获取推荐，请使用GenerateItemListAsync。GenerateItemListAsync接受一个包含推荐列表查询各种选项的字典。尽管这些设置中的许多是直接的，但理解支持的 ConfigName 参数以确保您提供成功的推荐是很重要的。
ConfigName
获取推荐时，您可以使用几种配置。在当前示例中，旨在最大化高质量播放次数，使用MaximizePlays配置。根据用例，MaximizePlays配置优于MaximizeTimeSpent，因为它还会根据用户满意度进行索引，而不仅仅是花费的时间。这告诉系统返回最有可能产生高质量游戏的项目。
有关每个支持配置的更多信息，请查看GenerateItemListAsync。
监控分析
一旦您集成了该服务，您可以直接在创作者中心中监控其性能。要访问您的推荐分析：
- 在创作者中心中，导航到您的游戏页面。
- 在侧边栏中，导航到参与度 > 推荐服务。
需要关注的关键指标：
- 随时间变化的总操作数：用户是否真正参与了推荐？
- 总唯一用户数：有多少人正在使用发现功能？
- 每个用户的平均展示项目数：用户是否在浏览旋转木马？
- 每个用户的平均花费时间：推荐的质量是否让用户在游戏中停留更长时间？
- 在提供的示例中，持续时间设置为1，因此这个特定指标在该用例中并不是特别有价值。然而，在其他应用中，例如视频，这可能是您展示的一个强指示。
请记住，此推荐系统中使用的设置和过程旨在最大化高质量游戏时间，特别是将缩略图的持续时间设置为1秒、仅记录高质量播放，并严格管理您的ID。通过保持日志记录和展示数据的干净，您可以推荐并微调最适合用户独特体验的内容。
虽然此流程涵盖了最大化游戏时间的推荐系统的过程，但您可以使用类似的操作顺序和基本概念构建适合您游戏需求的推荐服务。