在 Amazon Pinpoint 中向消息添加推荐器模型建议 - Amazon Pinpoint

终止支持通知： AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 Amazon Pinpoint 终止支持。注意： APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

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

在 Amazon Pinpoint 中向消息添加推荐器模型建议

要将推荐器模型与 Amazon Pinpoint 一起使用，请先创建一个 Amazon Personalize 解决方案并将该解决方案部署为 Amazon Personalize 活动。然后，在 Amazon Pinpoint 中为推荐器模型创建一个配置。在该配置中，您可以指定一些设置以确定如何从 Amazon Personalize 活动中检索和处理建议数据。这包括是否调用 AWS Lambda 函数以对检索的数据执行其他处理。

Amazon Personalize 是一项旨在帮助您创建机器学习模型的 AWS 服务，以便为使用您的应用程序的客户提供实时、个性化的建议。Amazon Personalize 将指导您完成创建和训练机器学习模型的过程，然后准备和部署该模型作为 Amazon Personalize 活动。接下来，您可以从活动中检索实时的个性化建议。要了解有关 Amazon Personalize 的更多信息，请参阅 Amazon Personalize 开发人员指南。

AWS Lambda 是一项计算服务，您可用来运行代码而无需预配置或管理服务器。您可将代码打包并上载到 AWS Lambda 作为 Lambda 函数。然后在调用该函数时，AWS Lambda 会运行该函数。函数可被手动调用、自动调用以响应事件或者响应来自应用程序或服务（包括 Amazon Pinpoint）的请求。有关创建和调用 Lambda 函数的更多信息，请参阅 AWS Lambda 开发人员指南。

在为推荐器模型创建 Amazon Pinpoint 配置后，您可以将模型中的建议添加到从活动和旅程发送的消息中。您可以使用包含建议属性的消息变量的消息模板以做到这一点。建议的属性 是一个旨在存储建议数据的动态端点或用户属性。在为推荐器模型创建配置时，您可以定义这些属性。

您可以在以下类型的消息模板中使用建议属性的变量：

  • 电子邮件模板，用于您从活动或旅程中发送的电子邮件。

  • 推送通知模板，用于您从活动中发送的推送通知。

  • 短信模板，用于您从活动中发送的短信文本消息。

有关将推荐器模型与 Amazon Pinpoint 一起使用的更多信息，请参阅《Amazon Pinpoint 用户指南》中的机器学习模型。

如果配置 Amazon Pinpoint 以调用处理建议数据的 Lambda 函数，每次在活动或旅程的消息中发送个性化建议时，Amazon Pinpoint 都会执行以下常规任务：

  1. 评估及处理消息和消息模板的配置设置和内容。

  2. 确定消息模板已连接到推荐器模型。

  3. 评估用于连接到和使用模型的配置设置。这些设置是由模型的推荐器模型资源定义的。

  4. 检测模型配置设置定义的建议属性的一个或多个消息变量。

  5. 从模型配置设置中指定的 Amazon Personalize 活动检索建议数据。它使用 Amazon Personalize Runtime API 的 GetRecommendations 操作来执行此任务。

  6. 将相应的建议数据添加到每个消息接收人的动态建议属性 (RecommendationItems) 中。

  7. 调用 Lambda 函数，并将每个接收人的建议数据发送到该函数以进行处理。

    数据将作为 JSON 对象发送，其中包含每个接收人的端点定义。每个端点定义包含一个 RecommendationItems 字段，其中包含由 1–5 个值组成的有序数组。数组中的值数量取决于模型的配置设置。

  8. 等待 Lambda 函数处理数据并返回结果。

    结果是一个 JSON 对象，其中包含每个接收人的更新的端点定义。每个更新的端点定义包含一个新 Recommendations 对象。该对象包含 1–10 个字段，在模型配置设置中定义的每个自定义建议属性各一个字段。其中的每个字段存储端点的改进建议数据。

  9. 使用每个接收人的更新的端点定义，将每个消息变量替换为该接收人对应的值。

  10. 发送包含每个消息收件人的个性化建议的消息版本。

要以这种方式自定义和改进建议，请先创建一个 Lambda 函数以处理 Amazon Pinpoint 发送的端点定义，然后返回更新的端点定义。接下来，分配一个 Lambda 函数策略并授权 Amazon Pinpoint 调用该函数。然后，在 Amazon Pinpoint 中配置推荐器模型。在配置模型时，指定要调用的函数并定义要使用的建议属性。