推送通知

注意

Adobe建议对需要基于单页应用程序框架的客户端渲染(例如,React)的项目使用SPA编辑器。 了解更多.

能否通过重要通知即时提醒您的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正在用一种名为Firebase Cloud Messaging(FCM)的类似服务取代GCM。 有关FCM的详细信息,请单击此处

转到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。
注意

记录服务器API密钥。 此值是在您的推送提供商的站点上输入的。

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

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

  • Amazon SNS
  • Pushwoosh
  • Adobe Mobile Services

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

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

使用AmazonSNS消息服务

注意

有关AmazonSNS的信息以及创建新AWS帐户的链接,可在此处 找到。您可以获得一年的免费帐户。

如果您不想使用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)。
注意

如果在AEM中配置了另一个具有相同App Id(和其他相关值)的应用程序:API访问令牌和GCM ID),通过AEM上的第二个应用程序发送的任何推送通知都将转到具有该App ID的任何其他应用程序。

第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"/>

注意

内容同步处理程序会查找这些节点,如果节点不在,它不会写出pge-notifications-config.json文件。

添加客户端库

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

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​磁贴右上角的编辑。

    chlimage_1-108

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

    chlimage_1-109

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

    chlimage_1-110

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

    chlimage_1-111

创建通知向导

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

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

    chlimage_1-112

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

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

    chlimage_1-113

    注意

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

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

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

    chlimage_1-115

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

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

    chlimage_1-115

注意

附加信息:

在6.4版本发布后,将不支持Pushwoosh和AmazonSNS,并将作为插件从包共享中提供。

后续步骤

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

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free