推送通知

能否通过重要通知即时提醒您的AEM Mobile应用用户，对于移动应用及其营销活动的价值至关重要。 在此，我们介绍了需要采取哪些步骤来允许您的应用程序接收推送通知，以及如何配置推送并将推送从AEM Mobile发送到电话上安装的应用程序。 此外，本节还介绍如何为推送通知配置深度链接功能。

将推送通知与AEM结合使用需要一些不同的技术。 首先，必须使用推送通知服务提供商来管理认证和设备(AEM尚未这样做)。 两个提供者已通过AEM现成配置：Amazon简单通知服务（或SNS）和Pushwoosh。 其次，针对给定移动操作系统的推送技术必须通过适当的服务——针对iOS设备的Apple推送通知服务（或APNS）;和Google Cloud Messaging（或GCM）（针对Android设备）。 尽管AEM不直接与这些平台特定的服务通信，但AEM必须随通知提供一些相关配置信息，以使这些服务执行推送。

安装和配置（如下所述）后，其工作方式如下：

1. 在AEM中创建推送通知，并将其发送给服务提供商(AmazonSNS或Pushwoosh)。
2. 服务提供商接收它并将其发送到核心提供程序（APNS或GCM）。
3. 核心提供者将通知推送到为该推送注册的所有设备。 对于每台设备，它使用蜂窝数据网络或WiFi（以设备上当前可用的方式为准）。
4. 如果注册的应用程序未运行，则通知将显示在设备上。 点击通知的用户将开始应用程序并在应用程序中显示通知。 如果应用程序已在运行，则只显示应用程序内通知。

此版本的AEM支持iOS和Android移动设备。

概述和过程

要在AEM Mobile应用程序中使用推送通知，必须执行以下高级步骤。

通常，AEM开发人员将：

1. 注册Apple和Google消息服务
2. 注册推送消息服务并配置它
3. 向应用程序添加推送支持
4. 准备电话以进行测试

而AEM管理员将：

1. 在AEM应用程序上配置推送
2. 构建和部署应用程序
3. 发送推送通知
4. 配置深层链接​（可选）

第1步：向Apple和Google消息服务注册

使用Apple推送通知服务(APNS)

转到Apple页面此处以熟悉Apple推送通知服务。

要使用APNS，您需要Apple的​证书​文件（.cer文件）、推送​私钥（.p12文件）和​私钥密码。 有关如何执行此操作的说明，请在此处找到。

使用Google Cloud Messaging(GCM)服务

转到Google页面此处，熟悉Android的Google Cloud Messaging。

您需要按照以下步骤操作：此处​创建Google API项目、启用GCM服务​和​获取API密钥。 您需要​API密钥​才能向Android设备发送推送通知。 另外，请记录​项目编号，该编号有时也称为​GCM发件人Id。

以下步骤显示了创建GCM API密钥的不同方法：

1. 登录google并转到Google的“开发人员”页面。
2. 从列表中选择您的应用程序（或创建新的应用程序）。
3. 在“Android包名称”下，输入您的应用程序id，即com.adobe.cq.mobile.weretail.outdoorsapp。 （如果这不起作用，请使用“test.test”重试。）
4. 单击​继续选择并配置服务
5. 选择“云消息传递”，然后单击​启用Google Cloud Messaging。
6. 随后将显示新的服务器API密钥和（新的或现有的）发送者ID。

第2步：注册和配置推送消息服务

AEM配置为将三个服务之一用于推送通知：

• Amazon SNS
• Pushwoosh
• Adobe Mobile Services

Amazon SNS ** 和Pushwooshconfiguration允许您从AEM屏幕内发送推送。

Adobe移 动服务配置允许您使用Adobe Analytics帐户从AdobeMobile Services中配置和发送推送通知（但需要使用此配置集构建应用程序以启用AMS推送通知）。

使用AmazonSNS消息服务

如果您不想使用AmazonSNS，可以跳过这些步骤。

按照以下步骤设置AmazonSNS推送通知：

1. 在AmazonSNS注册

   1. 记录您的帐户ID。 格式应为12位数，不带空格或短划线，即“123456789012”。
   2. 确保您位于“美国东部”或“欧盟”地区，因为后续步骤（创建身份池）需要其中一个步骤。
   3. 注册后，登录管理控制台并选择SNS（推送通知服务）。 如果出现，请单击“开始”。

2. 创建访问密钥和ID

   1. 单击屏幕右上角的登录名，然后从菜单中选择“安全凭据”。
   2. 单击“Access Keys（访问密钥）” ，在下面的空格中，单击“Create New Access Key（创建新访问密钥）” 。
   3. 单击​显示访问密钥，然后复制并保存显示的访问密钥ID和秘密访问密钥。 如果选择下载密钥的选项，将获得包含这些相同值的csv文件。
   4. 可在此页上管理其他安全相关证书和其他证书。
   注意

   访问密钥可用于多个应用程序。

   对于使用“AWS沙箱”帐户的组织，这些步骤非常相似，并在此列出：

   1. 单击屏幕右上角的登录名，然后从菜单中选择“我的安全凭据”。
   2. 单击左侧操作列表中的“用户”，然后选择您的用户名。
   3. 单击“安全凭据”选项卡。
   4. 从此处您可以看到您的密钥并创建新密钥。 保存密钥供以后使用。

3. 创建主题

   1. 单击​创建主题​并选择主题名称。 记录所有字段，如“主题ARN”、“主题所有者”、“区域”、“显示名称”。
   2. 单击​其他主题操作 > 编辑主题策略。 在​允许这些用户订阅此主题​下，选择​所有人。
   3. 单击​更新策略。
   注意

   您可以为开发、测试、演示等不同场景创建多个主题。 其余的SNS配置可以保持不变。 使用不同的主题构建应用程序；发送到该主题的推送通知将仅由使用该主题构建的应用程序接收。

4. 创建平台应用程序

   1. 单击“应用程序”，然后单击“创建平台应用程序”。 选择一个名称并选择一个平台(APNS for iOS, GCM for Android)。 其他字段需要填写，具体取决于平台：

      1. 对于APNS，必须输入P12文件、密码、证书和私钥。 应已在上述步骤​使用Apple推送通知服务(APNS)​中获取这些信息。
      2. 对于GCM，必须输入API密钥。 这应该已在上述步骤​使用Google Cloud Messaging(GCM)服务​中获取。

   2. 对要支持的每个平台重复上述步骤一次。 要能够同时推送到iOS和Android，必须创建两个平台应用程序。

5. 创建标识池

   1. 使用Cognito创建标识池，该池将存储未经过身份验证的用户的基本数据。 请注意，目前只有“美国东部”和“欧盟”地区得到Amazon·Cognito的支持。
   2. 为其命名，并选中“启用对未验证身份的访问”框。
   3. 在下一页（“您的Cognito身份需要访问您的资源”）中，单击“允许”。
   4. 在页面的右上角，单击链接“编辑标识池”。 将显示标识池ID。 保存此文本以备以后使用。
   5. 在同一页上，选择“未验证角色”旁边的下拉框，确保已选择角色Cognito_<池名称>UnauthRole。 保存更改。

6. 配置访问权限

   1. 登录Identity and Access Management(IAM)
   2. 选择角色
   3. 单击在上一步中创建的角色，名为Cognito_<yourIdentityPoolName>Unauth_Role。 记录显示的“角色ARN”。
   4. 打开“内联策略”（如果尚未打开）。 您应当看到一个名称为oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123的策略。
   5. 单击“编辑策略”。 将策略文档的内容替换为此JSON片段：

   { “版本”:《2012-10-17》, "语句": [ { "操作": [ "mobileanalytics:PutEvents", “cognito sync:*”, "SNS:CreatePlatformEndpoint", "SNS：订阅" ], “效果”:“允许”, "资源": [ "*" ] } ] }

   1. 单击​应用策略

使用Pushwoosh消息服务

如果您不想使用Pushwoosh，可以跳过此步骤。

要使用Pushwoosh:

1. 注册Pushwoosh

   1. 转到pushwoosh.com并创建新帐户。

2. 创建API访问令牌

   1. 在Pushwoosh站点上，转到“API访问”菜单项以生成API访问令牌。 您需要安全地记录此内容。

3. 创建新应用程序

   1. 要获得Android支持，您需要提供GCM API密钥。
   2. 配置应用程序时，选择Cordova作为框架。
   3. 要获得iOS支持，您需要提供证书文件(.cer)、推送证书(.p12)和私钥密码；这些应该是从苹果的APNS网站上获得的。 对于“框架”，选择“Cordova”。
   4. Pushwoosh将为该应用程序生成一个App Id，格式为“XXXXX-XXXX”，其中每个X都是一个十六进制值（0到F）。

第3步：向应用程序添加推送支持

添加ContentSync配置

创建两个名为notificationsConfig的内容节点（一个在app-config中，一个在app-config-dev中）:

• /content/<your app>/shell/jcr:content/pge-app/app-config-dev/notificationsConfig
• /content/<your app>/shell/jcr:content/pge-app/app-config/notificationsConfig

使用这些属性（.content.xml文件）:
<jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="nt:unstructured"
excludeProperties="[appAPIAccessToken]"
path="。./…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>

添加客户端库

必须按照以下步骤将推送通知客户端库添加到应用程序：

CRXDE Lite:

1. 导航到​/etc/designs/phonegap/<app name>/clientlibsall.
2. 多次单击属性窗格中的嵌入部分。
3. 在显示的对话框中，单击+按钮添加新的客户端库。
4. 在新文本字段中，添加“cq.mobile.push”，然后单击“确定”。
5. 再添加一个名为cq.mobile.push.amazon的应用程序，然后单击“确定”。
6. 保存更改。

第4步：准备电话以进行测试

IOS

对于iOS，您需要使用Mac OS计算机，并且您需要加入iOS开发人员项目。 某些公司拥有所有开发人员都可使用的公司许可证。

对于XCode 8.1，在使用推送通知之前，您必须转到项目的“功能”选项卡，并切换“推送通知”开启。

Android

要使用CLI在Android手机上安装应用程序(请参阅下文：第6步——构建和部署应用程序)，您首先必须将电话置于“开发人员模式”。 有关执行此操作的详细信息，请参阅启用设备上开发者选项。

第5步：在AEM应用程序上配置推送

在构建并部署到已配置的移动设备之前，必须为您决定使用的消息服务配置通知设置。

1. 为推送通知创建适当的授权组。
2. 以适当用户身份登录AEM，单击“应用程序”选项卡。
3. 单击应用程序。
4. 查找管理Cloud Services拼贴并单击铅笔，以修改您的云配置。
5. 选择“AmazonSNS连接”、“Pushwoosh连接”或“Adobe移动服务”作为通知配置。
6. 输入提供者属性，然后单击提交以保存它们，然后单击完成。 除AMS外，在此阶段不进行远程验证。
7. 您现在应该可以看到您刚刚在“管理Cloud Services”拼贴中输入的配置。

第6步：构建和部署应用程序

注意：另 请参阅此处有关构建 🔗 PhoneGap应用程序的说明。

有两种方法可使用PhoneGap构建和部署应用程序。

注意： 对于推送通知测试，模拟器是不够的，因为推送通知使用推送提供程序（Apple或Google）和设备之间的不同协议。当前的Mac/PC硬件和模拟器不支持此功能。

1. PhoneGap Builder 是PhoneGap提供的一项服务，将在其服务器上为您构建应用程序，并允许您直接将其下载到设备。请参阅PhoneGap Build文档，了解如何设置和使用PhoneGap Build。

2. PhoneGap命令行界面 (CLI)允许您在命令行上使用一组丰富的PhoneGap命令来构建、调试和部署应用程序。请参阅PhoneGap开发人员文档，了解如何设置和使用PhoneGap CLI。

第7步：发送推送通知

要创建并发送新通知，请按照以下步骤操作。

1. 创建新通知

   • 在您的AEM Mobile应用程序仪表板中，找到“推送通知”拼贴。
   • 在右上角的菜单中，选择“创建”。 请注意，此按钮在云配置首次设置之前不可用。
   • 在创建通知向导中，输入标题和消息，然后单击“创建”按钮。 您的通知现在可以立即发送或稍后发送。 可以编辑消息和／或标题，并更改和保存标题。

2. 发送通知

   • 在“应用程序”仪表板中，找到“推送通知”拼贴。
   • 选择通知，或单击右下角的详细信息按钮(…)以显示通知的列表。 此列表还指示通知是否已准备好发送、是否已发送，或是否在发送过程中出错。
   • 选中一个通知（仅）的复选框，然后单击列表上方的“发送通知”按钮。 您将有一次机会在显示的对话框中“取消”或“发送”通知。

3. 处理结果

   • 如果推送通知服务(AmazonSNS或Pushwoosh)收到“发送”请求，确认其有效，并成功将其发送给本机提供者（APNS和GCM），则“发送”对话框将关闭，且不显示任何消息。 在通知列表中，该通知的状态将列为“已发送”。

   • 如果推送发送失败，对话框将显示一条消息，指明问题。 在通知列表中，该通知的状态将列为“错误”，但如果问题得到纠正，则可以再次发送通知。 在错误事件下，服务器错误日志中应显示其他错误信息。

   • 请注意，iOS和Android推送通知之间存在一些平台差异。 其中：

     • 在Android上部署应用程序后，使用CLI进行构建将会对其进行开始。 在iOS上，您必须手动开始它。 由于推送注册步骤在启动时发生，因此Android应用程序可以立即接收推送通知（因为它将已启动和注册），而iOS应用程序则不会。
     • 在Android上，“确定”按钮文本为全部大写（以及在应用程序内通知上添加的任何其他按钮），而在iOS中则不是。

对于AMS推送通知，必须编写通知并从AMS服务器发送。 AMS提供的推送通知功能超出AEM通知与AWS和Pushwoosh提供的功能。

配置带推送通知的深层链接

什么是深层链接？ 在推送通知的上下文中，这是一种允许应用程序打开或定向（如果打开）到应用程序内指定位置的方法。

它是如何工作的？ 推送通知的作者可以选择添加按钮标签(即“给我看看！”) ，并通过可视路径浏览器选择您希望在通知中链接的页面。 发送后，推送会正常发生，但应用程序内消息中“确定”按钮将替换为“取消”按钮并指定新按钮（“显示我！”） 的双曲余切值。 单击新按钮将使应用程序转到应用程序中的指定页面。 单击“取消”将仅取消消息。

如果应用程序未打开，阴影将正常显示。 在阴影中对通知执行操作将打开应用程序，然后根据推送通知中配置的内容向用户显示深层链接按钮。

创建通知，为可选深层链接添加按钮文本和链接路径：

1. 单击​管理Cloud Services​磁贴右上角的编辑。

   

2. 选择​Pushwoosh连接。 单击​下一步。

   

3. 输入属性的详细信息，然后单击​提交。

   

   提交配置后，推送通知​磁贴将显示在仪表板中。

   

创建通知向导

在仪表板中显示​推送通知​拼贴后，使用创建通知向导添加内容：

1. 单击​推送通知​拼贴右上角的添加符号以打开​创建通知向导。

   

2. 单击链接路径中的浏览图标，向用户显示应用程序的内容结构。

   选择路径后，单击复选图标。

   

   注意

   “链接按钮文本”限制为20个字符。

   如果最终用户没有最新版本的应用程序并且链接的路径不可用，则确认深层链接的操作将使用户进入应用程序的主页。

3. 在​创建通知向导​中输入​文本详细信息，然后单击​创建。

   

   单击您从​推送通知​拼贴创建的推送通知以打开详细信息。

   您可以编辑属性、发送通知或删除通知。

   

后续步骤

了解有关应用程序推送通知的详细信息后，请参阅AEM Mobile内容个性化。