向消息模板添加个性化内容 - Amazon Pinpoint

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

向消息模板添加个性化内容

要使用模板在消息中提供动态的个性化内容,请将消息变量 添加到消息模板。消息变量 是一个占位符,引用您或 Amazon Pinpoint 创建的用于存储用户相关信息的特定属性。每个属性通常对应于某位用户的一个特征,例如用户的名字或居住的城市。通过将消息变量添加到模板中,您可以使用这些属性将自定义内容提供给使用模板的消息的每位收件人。

如果模板中包含消息变量,则 Amazon Pinpoint 将每个变量替换为每个收件人当前对应的属性值。在每次发送使用模板的消息时,都会执行此操作。这意味着您可以向每位收件人发送个性化内容,而无需创建多个自定义版本的消息或消息模板。您还可确保消息中使用了您拥有的收件人的最新信息。

例如,如果您的项目是适用于跑步者的健身应用程序,其中包含每个用户的名字、偏好的活动和个人成绩记录属性,则可以在模板中使用以下文本和消息变量:

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

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

示例 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

示例 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

如果收件人没有某个属性值,Amazon Pinpoint 可以使用您为变量指定的默认值替换变量。例如,如果健身应用程序的用户尚未选择其偏好的活动,则您可以使用 running 作为 {{User.UserAttributes.Activity}} 变量的默认值。在这种情况下,Amazon Pinpoint 将替换该变量,如以下示例所示:

示例 1

Hi Jane, congratulations on your new running record of 1:42:17!

示例 2

Hi John, congratulations on your new running record of 20:52!

如果您未指定默认值,且收件人没有对应的值,则 Amazon Pinpoint 在向该收件人发送消息时将忽略该变量的所有文本。例如:

Hi Mary, congratulations on your new record of 20:52!

作为最佳实践,建议您为模板中包含的每个变量指定默认值。

添加消息变量

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

注意

应用程序内消息模板不支持使用消息变量。

将消息变量添加到消息模板
  1. 打开亚马逊 Pinpoint 控制台,网址为。https://console.aws.amazon.com/pinpoint/

  2. 在导航窗格中,选择消息模板

  3. 消息模板页面上,执行以下操作之一:

    • 要创建新模板并向其中添加消息变量,请选择创建模板。然后,在模板页面上,输入模板的名称和(可选)模板的描述。

    • 要将消息变量添加到现有模板,请选择要将变量添加到的模板。然后,在模板页面上,选择编辑。在模板详细信息下面,使用版本选择器选择要作为起点的模板版本。如果您选择最新的版本,您可以将更改直接保存到该模板版本中。否则,您可以将更改另存为模板的新版本。

  4. 在消息详细信息部分,确定添加消息变量的位置。您可以将变量添加到任何类型的模板的正文中。对于电子邮件和推送通知模板,您还可以在消息主题或标题中添加变量。

  5. 属性查找器中,展开要添加消息变量的属性类型部分。您可以从以下类型的属性中进行选择:

    标准属性

    这些是 Amazon Pinpoint 为任何项目自动创建的属性。这意味着,您可以在为任何项目发送的消息中使用它们。有关其中的每个属性的详细信息,请参阅支持的属性

    要为标准属性添加变量,请从列表中选择该属性。

    自定义属性

    您可以选择为各个项目创建这些属性。由于这些属性可能不适用于您的某些项目,因此 Amazon Pinpoint 可能无法将该变量替换为使用该模板的消息的每个收件人的值。为了帮助您避免这一问题,Amazon Pinpoint 提供了一些选项来帮助您选择在特定项目或所有项目中存在的属性。

    添加自定义属性:

    1. 选择自定义属性,然后选择加载自定义属性。在出现的窗口中,Amazon Pinpoint 列出您创建的所有项目。当您选择每个项目时,选定项目的通用属性将显示在右侧的导航窗格中。如果未显示任何属性,则这些项目之间没有通过用属性。

    2. 请执行以下操作之一:

      • 要使用选定项目的所有通用属性,请选择加载自定义属性

      • 要使用列表中的特定属性,请在搜索字段中输入属性名称的任意部分。与输入文本相匹配的属性将显示。当显示了您要使用的属性时,选择加载自定义属性属性查找器显示新添加的自定义属性。

        注意

        您无法添加来自不同项目集的常用属性,也无法修改属性查找器的 “自定义属性 部分。要更改自定义属性,请选择 X 以清除属性查找器,然后重新开始。

    3. 属性查找器中,选择要添加变量的属性。

    建议的属性

    这些是您在配置 Amazon Pinpoint 以从推荐器模型中检索个性化建议时可以选择为您的账户创建的属性。有关使用推荐系统模型的信息,请参阅机器学习模型。您可以将此类属性的变量添加到电子邮件模板、推送通知模板和SMS模板中。您无法将其添加到语音模板中。

    要为建议的属性添加变量,请从列表中选择该属性。如果属性查找器未列出任何推荐的属性,则必须先将模板连接到推荐模型。

    添加建议的属性:

    1. 选择连接模型

    2. 选择在发送使用该模板的消息时要从中检索建议的模型。

    3. 选择连接模型

  6. 当您从属性查找器选择一个属性时,Amazon Pinpoint 为该属性创建一个消息变量并将其复制到剪贴板中。将变量粘贴到所需的位置。如果属性列表很长,请输入搜索文本以缩小列表范围。选择 X 以清除搜索字段。

    粘贴变量后,Amazon Pinpoint 会将其显示为关联属性的名称,并用两组大括号括起来,例如 {{User.UserAttributes.FirstName}}

  7. 对要添加的每个消息变量重复步骤 4—6。

  8. 要为消息变量指定默认值,请展开默认属性值部分。然后,在变量列表中,输入用于变量的默认值。

    注意

    我们建议您为模板中的每个变量执行该操作。否则,Amazon Pinpoint 可能无法发送使用该模板的消息,或者消息可能以意外或不希望的方式显示。

  9. 完成后,请执行以下操作之一:

    • 如果您将消息变量添加到新模板,请选择创建

    • 如果您将消息变量添加到现有模板并希望将更改另存为模板的新版本,请选择另存为新版本

    • 如果您将消息变量添加到现有模板并希望将更改另存为模板最新版本的更新,请选择更新版本。仅当您在步骤 3 中打开了模板的最新版本时,此选项才可用。

支持的属性

每个项目都可以具有标准属性和自定义属性。标准属性是 Amazon Pinpoint 为任何项目自动创建的属性。自定义属性是您可以选择为项目创建的属性。自定义属性有三种类型:

  • 用户属性 – 这些属性描述用户,例如用户的名字、姓氏和出生日期。用户 是具有项目的唯一用户 ID 的人员。

  • 端点属性 – 这些属性描述用户的特定端点。端点 是您可以将消息发送到的目标,例如电子邮件地址、电话号码或移动设备。每位用户可以与一个或多个端点关联。例如,如果您通过电子邮件SMS、和电话与用户通信,则该用户可能与三个端点相关联,一个用于用户的电子邮件地址,另一个用于用户的移动电话号码,另一个用于用户的家庭(固定电话)电话号码。

  • 指标属性 – 这些属性是应用程序向 Amazon Pinpoint 报告的有关单独端点的数值指标,例如某个移动应用程序的会话数或购物车中留下的商品数。

  • Pinpoint 属性 — 这些属性是您的应用程序、营销活动或旅程的唯一标识符。

除了您或 Amazon Pinpoint 为项目创建的自定义属性和标准属性以外,Amazon Pinpoint 还支持建议的属性建议的属性 是临时存储的针对用户或端点的个性化建议的属性。Amazon Pinpoint 会从您为它配置的推荐器模型中检索这些建议。建议的属性与特定项目无关联,相反,它们与您的 Amazon Pinpoint 账户关联。有关使用推荐系统模型的信息,请参阅机器学习模型

您可以在消息变量中使用任何标准、自定义或建议的属性。下表指示在每个支持的属性的消息变量中显示的文本,并描述了每个属性。在桌子里,custom_attribute 表示出现在自定义属性的变量中的文本。在这种情况下,请替换 custom_attribute 使用自定义属性的名称。例如,如果您的项目在名为 FirstName 的自定义用户属性中存储用户的名字,并且您为该属性添加一个变量,则该变量的文本为 {{User.UserAttributes.FirstName}}

属性 描述
Address 您发送到端点的消息或推送通知的目标地址,例如电子邮件地址、电话号码或设备令牌。
Pinpoint.ApplicationId 应用程序的唯一标识符。
Attributes.custom_attribute 描述端点的自定义端点属性。
Pinpoint.CampaignId 活动的唯一标识符。
ChannelType 向端点发送消息或推送通知时使用的渠道。例如:
  • APNS— 适用于可以接收你通过 Apple 推送通知服务 (APNs) 渠道发送到在 iOS 设备上运行的应用程序的推送通知的端点。

  • EMAIL – 适用于可接收电子邮件消息的端点。

  • GCM— 适用于可以接收您通过 Firebase 云端消息 (FCM) 渠道发送给在 Android 设备上运行的应用的推送通知的终端节点。

  • SMS— 适用于可以接收SMS短信的端点。

  • VOICE – 适用于可以接收语音消息的端点。

CreationDate 将端点添加到项目的日期和时间,格式ISO为 86012019-06-30T11:45:25.220Z例如,2019 年 UTC 6 月 30 日上午 11:45。
Demographic.AppVersion 与端点关联的应用程序的版本号。
Demographic.Locale 端点的区域设置,格式如下:ISO639-1 alpha-2 代码,后跟下划线 (_),后跟一个 3166-1 alpha-2 值。ISO例如,en_US 是美国英语区域设置。
Demographic.Make 端点设备的制造商,例如 applesamsung
Demographic.Model 端点设备的产品名称或型号,例如 iPhoneSM-G900F
Demographic.ModelVersion 端点设备的型号版本。
Demographic.Platform 端点设备上的操作系统,例如 iosandroid
Demographic.PlatformVersion 端点设备上的操作系统版本。
Demographic.Timezone 端点的时区,采用 tz 数据库值。例如,America/Los_Angeles 表示太平洋时间(北美)。
EffectiveDate 上次更新端点的日期和时间,格式ISO为 86012019-08-23T10:54:35.220Z例如,2019 年 UTC 8 月 23 日上午 10:54。
EndpointId 端点的唯一标识符。
EndpointStatus 是否向终端节点发送消息或推送通知:ACTIVE,向终端节点发送消息,或者INACTIVE,不向终端节点发送消息。
Id 端点的唯一标识符。
Pinpoint.JourneyId 旅程的唯一标识符。
Location.City 端点所在的城市。
Location.Country 端点所在国家或地区的双字符代码,采用 ISO3166-1 alpha-2 格式。例如,US 表示美国。
Location.Latitude 端点位置的纬度坐标,舍入到一位小数。
Location.Longitude 端点位置的经度坐标,舍入到一位小数。
Location.PostalCode 终端所在区域的邮政ZIP编码或编码。
Location.Region 端点所在区域的名称,例如,省/市/自治区。
Metrics.custom_attribute 您的应用程序向 Amazon Pinpoint 报告的有关端点的自定义数值指标。
OptOut 无论用户选择不接收您的消息和推送通知:ALL,用户都选择退出并且不想接收任何消息或推送通知,或者NONE,用户尚未选择退出并希望接收所有消息和推送通知。
RecommendationItems 存储端点或用户的一个建议的标准建议属性。该属性包含推荐系统模型直接提供的文本。
RecommendationItems.[#]

存储端点或用户的有序建议列表(包含 2–5 个建议)的标准建议属性。该属性包含推荐系统模型直接提供的文本。

数字占位符 (.[#]) 表示属性包含多个值。该属性的消息变量可以引用列表中的特定值。

Recommendations.custom_attribute 存储端点或用户的一个建议的自定义建议属性。此属性包含由推荐模型提供并通过 AWS Lambda 函数增强的内容。
Recommendations.custom_attribute.[#]

存储端点或用户的多个建议的自定义建议属性。该属性包含由推荐系统模型提供并由 AWS Lambda 函数改进的内容。

数字占位符 (.[#]) 表示属性包含多个值。该属性的消息变量可以专门引用其中的一个值。

RequestId 最近更新端点请求的唯一标识符。
User.UserAttributes.custom_attribute 描述用户的自定义用户属性。
User.UserId 用户的唯一标识符。