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

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

# 在消息中使用建议
<a name="ml-models-rm-using"></a>

要将动态的个性化建议添加到消息中，请创建并使用包含建议属性的消息变量的消息模板。*消息变量* 是一个占位符，它引用您或 Amazon Pinpoint 创建的用于存储用户相关信息的特定属性。*建议的属性* 是临时存储针对用户的建议的属性。Amazon Pinpoint 从您部署为 Amazon Personalize 活动且配置 Amazon Pinpoint 使用它的推荐器模型检索这些建议。

如果模板包含消息变量，则 Amazon Pinpoint 将每个变量替换为每个收件人当前对应的属性值。对于建议，此过程包括从 Amazon Personalize 活动中检索针对每位收件人的最新建议。Amazon Pinpoint 在每次发送使用该模板的消息时都会执行此操作。这意味着您可以放心，消息包含收件人的最新建议。

例如，如果您的项目是一个向用户推荐电影和电视节目的应用程序，您可能会将以下属性用于每个用户：
+ 用户的名字。
+ 用户最近提交的评分。
+ 用户最近评定的电影或节目的名称。
+ 模型为用户推荐的前三个电影和节目的名称。

对于该项目，您可以在模板中使用以下文本和消息变量：

`Hi {{User.UserAttributes.FirstName}}, based on your recent {{User.UserAttributes.LatestRating}}-star rating for {{User.UserAttributes.LatestRatedTitle}}, we think you might also enjoy: {{RecommendationItems.[0]}}, {{RecommendationItems.[1]}}, and {{RecommendationItems.[2]}}.`

当您发送使用该模板的消息时，Amazon Pinpoint 将变量替换为每位收件人的每个属性的当前值。以下示例演示此操作。

**示例 1**：  
`Hi Sofia, based on your recent 5-star rating for The Marvelous Mrs. Maisel – Season 3, we think you might also enjoy: Fleabag, Late Night, and Catastrophe.`

**示例 2**：  
`Hi Alejandro, based on your recent 4-star rating for Tom Clancy's Jack Ryan – Season 2, we think you might also enjoy: Hanna, Hunters, and Agatha Christie's The ABC Murders.`

如果您将推荐器模型配置为使用 AWS Lambda 函数改进建议，模板和生成的消息可能会使用其他变量和建议的属性。例如，它们还可能会将变量用于为每个推荐的电影或节目提供图像和 URL 的属性。

有关在模板中使用消息变量的更多信息，请参阅[向消息模板添加个性化内容](message-templates-personalizing.md)。

## 在消息中添加建议
<a name="ml-models-rm-using-add-variables"></a>

要将个性化建议添加到消息中，请创建并使用包含要使用的建议的消息变量的消息模板。您可以将这些变量添加到以下类型的消息模板中：
+ 电子邮件模板，用于您从活动或旅程中发送的电子邮件。
+ 推送通知模板，用于您从活动中发送的推送通知。
+ 短信模板，用于您从活动中发送的短信文本消息。

每个模板每次可以使用一个推荐器模型中的变量和建议的属性。

您可以在创建模板时将变量添加到新模板中，或者将变量添加到现有模板中。如果您将变量添加到现有模板中，Amazon Pinpoint 不一定会将更改应用于使用该模板并且尚未发送的消息，例如，计划以后发送的活动消息。这取决于您将变量添加到的模板版本以及之前如何配置使用该模板的消息。有关更多信息，请参阅 [管理消息模板的版本](message-templates-versioning.md)。

**在消息模板中添加建议**

1. 打开 Amazon Pinpoint 控制台，网址为：[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)。

1. 在导航窗格中，选择**消息模板**。

1. 在**消息模板**页面上，执行以下操作之一：
   + 要创建新模板并在其中添加建议，请选择**创建模板**。然后，在模板页面上，输入模板的名称和（可选）模板的描述。
   + 要将建议添加到现有模板中，请选择所需的模板。然后，在模板页面上，选择**编辑**。在**模板详细信息**下面，使用版本选择器选择要作为起点的模板版本。如果您选择最新的版本，您可以将更改直接保存到该模板版本中。否则，您可以将更改另存为模板的新版本。

1. 在**属性查找器**中，展开**建议的属性**部分。

   如果还没有为模板选择推荐器模型，请选择**连接模型**。接下来，选择在发送使用该模板的消息时要从中检索建议的模型。然后，选择**连接模型**。

1. 在**建议的属性**下，选择要为其添加消息变量的属性。Amazon Pinpoint 为该属性创建一个变量并将其复制到您的剪贴板上。然后，在消息编辑器中，将变量粘贴到您希望在消息中显示建议的位置。

   粘贴变量后，Amazon Pinpoint 会将其显示为关联属性的名称，并用两组大括号括起来，例如 `{{RecommendationItems}}`。

1. 如果推荐器模型提供了多个建议的属性，请为要添加变量的每个其他属性重复上一步。

   您还可以为其他类型的属性添加变量。为此，请展开**属性查找器**中的其他部分，选择所需的每个其他属性，然后将变量粘贴到所需的位置。要了解将变量用于其他类型的属性的信息，请参阅[向消息模板添加个性化内容](message-templates-personalizing.md)。

1. 要为消息变量指定默认值，请展开**默认属性值**部分。然后，在变量列表中，输入用于变量的默认值。我们建议您为模板中的每个变量执行该操作。

1. 完成后，请执行以下操作之一：
   + 如果您将消息变量添加到新模板，请选择**创建**。
   + 如果您将消息变量添加到现有模板并希望将更改另存为模板的新版本，请选择**另存为新版本**。
   + 如果您将消息变量添加到现有模板并希望将更改另存为模板最新版本的更新，请选择**更新版本**。仅当您在步骤 3 中打开了模板的最新版本时，此选项才可用。

现在，您可以使用模板在从活动和旅程发送的消息中包括个性化建议。

请注意，您不能在作为直接或测试消息发送到有限受众的消息中包括建议。虽然您可以更广泛地在这些消息中使用模板，但 Amazon Pinpoint 不能将模型中的建议与直接或测试消息的收件人相关联。要测试使用建议的模板的外观和格式，请为引用建议属性的每个消息变量指定默认值，然后发送使用该模板的测试消息。

## 从消息中删除建议
<a name="ml-models-using-remove-variables"></a>

要从消息中删除个性化建议，请更新消息使用的消息模板。在更新模板时，删除建议的所有消息变量或仅删除一些消息变量。

如果您从模板中删除建议，Amazon Pinpoint 不一定会将更改应用于使用该模板并且尚未发送的消息，例如，计划以后发送的活动消息。这取决于您从中删除建议的模板版本以及如何配置使用该模板的消息。有关更多信息，请参阅 [管理消息模板的版本](message-templates-versioning.md)。

**从消息模板中删除建议**

1. 打开 Amazon Pinpoint 控制台，网址为：[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)。

1. 在导航窗格中，选择**消息模板**。

1. 在**消息模板**页面上，选择要从中删除建议的模板。然后，在模板页面上，选择**编辑**。

1. 在**模板详细信息**下面，使用版本选择器选择要作为起点的模板版本。如果您选择最新的版本，您可以将更改直接保存到该模板版本中。否则，您可以将更改另存为模板的新版本。

1. 在消息编辑器中，删除要删除的每个建议属性的消息变量的所有文本。每个消息变量都由两组大括号和关联属性的名称组成，例如 `{{RecommendationItems}}`。

   要从模板中完全删除推荐器模型，请删除模型提供的建议属性的所有变量。接下来，在**属性查找器**中展开**建议的属性**部分，然后选择模型名称旁边的 **X**。

1. 完成后，请执行以下操作之一：
   + 要将更改另存为模板的新版本，请选择**另存为新版本**。
   + 要将更改另存为模板的最新版本的更新，请选择**更新版本**。仅当您在步骤 4 中选择了模板的最新版本时，此选项才可用。