**终止支持通知：** 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="message-templates-creating-push"></a>

*推送通知模板* 是一种消息模板，其中包含可用于您的 Amazon Pinpoint 项目的内容和设置。当您使用模板发送推送通知时，Amazon Pinpoint 将使用您在模板中定义的内容和设置填充通知。

在创建推送通知模板时，您可以在基于模板的推送通知的各个组成部分中指定要重用的内容和设置。这些组成部分称为*模板部分*，它们可以包含文本（例如，通知的标题或正文）或设置（例如，在收件人收到通知时将播放的自定义声音）。

要为特定的推送通知渠道自定义模板，您可以在每个模板中创建多套模板部分，包括一个默认集以及可选的一个或多个特定服务集。默认集包含默认情况下要用于任何推送通知渠道的内容和设置。特定服务集包含您要用于特定通知服务（例如 Apple Push Notification service 或 Firebase Cloud Messaging）的任何内容和设置。通过向模板中添加特定于服务的设置，您可以定制通知，从而在每个收件人的设备类型上显示独特的内容。

您也可以[创建包含原始消息数据的模板](#message-templates-creating-push-raw)。此选项更高级，但很有用，它使您可以为特定渠道指定标准 Amazon Pinpoint 推送通知模板中不存在的设置。

## 创建标准推送通知模板
<a name="message-templates-creating-push-standard"></a>

完成此过程以指定基本消息内容，例如标题、消息正文、图像和操作。要指定原始消息内容，请改为完成[创建包含原始消息数据的推送通知模板](#message-templates-creating-push-raw)中的过程。

**创建推送通知模板**

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

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

1. 选择**创建模板**。

1. 在**渠道**下，选择**推送通知**。

1. 在**模板详细信息**下，对于**模板名称**，输入模板的名称。名称必须以字母或数字开头。它最多可以包含 128 个字符。字符可以是字母、数字、下划线 (\$1) 或连字符 (‐)。

1. （可选）对于**版本描述**，输入模板的简要描述。描述最多可包含 500 个字符。

1. 在**推送通知详细信息**下，执行以下操作：
   + 对于**通知类型**，请选择**标准消息**。
   + 对于**标题**，请输入要显示在消息正文上方的标题。
   + 对于**正文**，请输入要在通知消息正文中显示的文本。
**提示**  
您可以在模板标题和正文中包含个性化内容。为此，添加引用特定属性（例如，存储用户名字的属性）的消息变量。通过使用消息变量，您可以为使用模板的推送通知的每个收件人显示不同的内容。  
要使用消息变量，请从**属性查找器**中选择现有属性的名称。Amazon Pinpoint 为该属性创建一个消息变量并将其复制到您的剪贴板上。将变量粘贴到所需的位置。有关更多信息，请参阅 [向消息模板添加个性化内容](message-templates-personalizing.md)。
   + 对于**自定义提醒声音**，输入音频文件的名称，该文件包含收件人收到推送通知时要播放的自定义声音。此名称必须与收件人设备上音频文件的名称相同。
   + 对于**操作**，选择您希望收件人设备在收件人点击推送通知时执行的操作：
     + **打开您的应用程序** – 打开您的应用程序或将它移至前台（如果已将它发送到后台）。
     + **转到 URL** – 在收件人设备上打开默认浏览器并加载特定网页。如果选择此选项，请在**目标 URL** 框中输入该网页的 URL。
     + **打开深层链接** – 打开您的应用程序并显示应用程序中的特定用户界面。如果选择此选项，请在**目标 URL** 框中输入该界面的 URL。

1. （可选）要为特定推送通知服务自定义模板，请在**为单独的推送服务自定义内容**下选择相应的服务选项卡。然后选择要用于该服务的选项。

   如果在服务的选项卡上选中**覆盖默认推送内容**复选框，则 Amazon Pinpoint 会自动将您在前面步骤中选择的默认内容和设置替换为您在选项卡上选择的选项。如果要保留默认内容和设置，并且仅自定义模板以使用其他特定于渠道的设置，请不要选中此复选框。  
**Apple**  
使用这些选项为你通过 Apple 推送通知服务 (APNs) 渠道发送到在 iOS 设备上运行的应用程序的推送通知指定自定义内容和设置。  
除了标准内容和设置之外，您也可以在使用模板的推送通知中包含自定义图像或视频。为此，请在 **iOS 媒体**框中输入图像或视频文件的 URL。URL 必须是可公开访问的。否则，收件人设备将无法显示图像或视频。  
**Google**  
使用这些选项可为您通过 Google Firebase Cloud Messaging (FCM) 渠道向 Android 设备上运行的应用程序发送的推送通知指定自定义内容和设置。  
除了标准内容和设置之外，您也可以选择以下选项来在使用模板的推送通知中显示自定义图像：  
   + **Android 图像** – 输入要在推送通知正文中显示的图像的 URL。
   + **Android 图标** – 输入要在推送通知的内容视图中显示的大图标图像的 URL。
   + **Android 小图标** – 输入要在状态栏和推送通知的内容视图中显示的小图标图像的 URL。  
**Amazon**  
使用这些选项可为您通过 Amazon Device Messaging (ADM) 渠道向 Amazon 设备上运行的应用程序发送的推送通知指定自定义内容和设置。  
除了标准内容和设置之外，您也可以选择以下选项来在使用模板的推送通知中显示自定义图像：  
   + **Android 图像** – 输入要在推送通知正文中显示的图像的 URL。
   + **Android 图标** – 输入要在推送通知的内容视图中显示的大图标图像的 URL。
   + **Android 小图标** – 输入要在状态栏和推送通知的内容视图中显示的小图标图像的 URL。  
**百度**  
使用这些选项可为您通过百度渠道向使用百度云推送平台的应用程序发送的推送通知指定自定义内容和设置。  
除了标准内容和设置之外，您也可以选择以下选项来在使用模板的推送通知中显示自定义图像：  
   + **Android 图像** – 输入要在推送通知正文中显示的图像的 URL。
   + **Android 图标** – 输入要在推送通知的内容视图中显示的大图标图像的 URL。
   + **Android 小图标** – 输入要在状态栏和推送通知的内容视图中显示的小图标图像的 URL。

1. 如果使用消息变量将个性化内容添加到模板，请为每个变量指定默认值。如果执行此操作，则当收件人没有对应的值时，Amazon Pinpoint 将变量替换为您指定的值。我们建议您为模板中的每个变量执行该操作。

   要指定变量的默认值，请展开**默认属性值**部分。然后，输入要用于每个变量的默认值。如果您没有指定默认值，且收件人没有对应值，则 Amazon Pinpoint 不会发送邮件。

1. 在输入完模板的内容和设置后，选择**创建**。

## 创建包含原始消息数据的推送通知模板
<a name="message-templates-creating-push-raw"></a>

完成此过程以手动指定原始消息有效载荷。仅当您想要使用 Amazon Pinpoint 不允许您配置的特定推送通知服务的功能时，才需要指定原始消息有效负载。如果您需要指定原始消息内容，请改为完成[创建标准推送通知模板](#message-templates-creating-push-standard)中的过程。

需要您使用原始消息模板的一个例子是，当您想把消息发送给桌面 Safari Web 浏览器的用户时。在这种情况下，您必须在原始消息有效载荷中包含特定属性。有关更多信息，请参阅《AWS 最终用户消息推送用户指南》**中的[发送消息](https://docs.aws.amazon.com/push-notifications/latest/userguide/reference-send-message.html)。

**创建推送通知模板**

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

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

1. 选择**创建模板**。

1. 在**渠道**下，选择**推送通知**。

1. 在**模板详细信息**下，对于**模板名称**，输入模板的名称。名称必须以字母或数字开头。它最多可以包含 128 个字符。字符可以是字母、数字、下划线 (\$1) 或连字符 (‐)。

1. （可选）对于**版本描述**，输入模板的简要描述。描述最多可包含 500 个字符。

1. 在**推送通知详细信息**下，对于**通知类型**，选择**原始消息**。消息编辑器会显示用于模板的代码大纲。在消息编辑器中，输入要用于每个推送通知服务的设置，包括要为模板指定的任何可选设置，例如图片、声音和操作。有关详细信息，请参阅您使用的推送通知服务的文档。

1. 在完成输入原始消息内容后，选择**创建**。

要在发送给用户的推送通知中使用模板之前测试模板，您可以发送使用该模板的[测试通知](messages-mobile.md)。如果执行此操作，请确保首先完成步骤 10，为模板中的所有变量指定默认值。否则，推送通知可能无法发送，或者它可能无法正确呈现。