Adobe建议对需要基于单页应用程序框架的客户端渲染(例如,React)的项目使用SPA编辑器。 了解更多.
能否通过重要通知即时提醒您的AEM Mobile应用用户,对于移动应用及其营销活动的价值至关重要。 在此,我们介绍了需要采取哪些步骤来允许您的应用程序接收推送通知,以及如何配置推送并将推送从AEM Mobile发送到电话上安装的应用程序。 此外,本节还介绍如何为推送通知配置深度链接功能。
推送通知不保证投放;更像是公告。尽最大努力确保每个人都能收到它们,但它们不是保证的投放机制。 此外,传送推送的时间可从不到一秒到长达半小时。
将推送通知与AEM结合使用需要一些不同的技术。 首先,必须使用推送通知服务提供商来管理认证和设备(AEM尚未这样做)。 两个提供者已通过AEM现成配置:Amazon简单通知服务(或SNS)和Pushwoosh。 其次,针对给定移动操作系统的推送技术必须通过适当的服务——针对iOS设备的Apple推送通知服务(或APNS);和Google Cloud Messaging(或GCM)(针对Android设备)。 尽管AEM不直接与这些平台特定的服务通信,但AEM必须随通知提供一些相关配置信息,以使这些服务执行推送。
安装和配置(如下所述)后,其工作方式如下:
此版本的AEM支持iOS和Android移动设备。
要在AEM Mobile应用程序中使用推送通知,必须执行以下高级步骤。
通常,AEM开发人员将:
而AEM管理员将:
转到Apple页面此处以熟悉Apple推送通知服务。
要使用APNS,您需要Apple的证书文件(.cer文件)、推送私钥(.p12文件)和私钥密码。 有关如何执行此操作的说明,请在此处找到。
Google正在用一种名为Firebase Cloud Messaging(FCM)的类似服务取代GCM。 有关FCM的详细信息,请单击此处。
转到Google页面此处,熟悉Android的Google Cloud Messaging。
您需要按照以下步骤操作:此处创建Google API项目、启用GCM服务和获取API密钥。 您需要API密钥才能向Android设备发送推送通知。 另外,请记录项目编号,该编号有时也称为GCM发件人Id。
以下步骤显示了创建GCM API密钥的不同方法:
com.adobe.cq.mobile.weretail.outdoorsapp
。 (如果这不起作用,请使用“test.test”重试。)记录服务器API密钥。 此值是在您的推送提供商的站点上输入的。
AEM配置为将三个服务之一用于推送通知:
Amazon SNS ** 和Pushwooshconfiguration允许您从AEM屏幕内发送推送。
Adobe移 动服务配置允许您使用Adobe Analytics帐户从AdobeMobile Services中配置和发送推送通知(但需要使用此配置集构建应用程序以启用AMS推送通知)。
有关AmazonSNS的信息以及创建新AWS帐户的链接,可在此处 找到。您可以获得一年的免费帐户。
如果您不想使用AmazonSNS,可以跳过这些步骤。
按照以下步骤设置AmazonSNS推送通知:
在AmazonSNS注册
创建访问密钥和ID
访问密钥可用于多个应用程序。
对于使用“AWS沙箱”帐户的组织,这些步骤非常相似,并在此列出:
创建主题
您可以为开发、测试、演示等不同场景创建多个主题。 其余的SNS配置可以保持不变。 使用不同的主题构建应用程序;发送到该主题的推送通知将仅由使用该主题构建的应用程序接收。
创建平台应用程序
单击“应用程序”,然后单击“创建平台应用程序”。 选择一个名称并选择一个平台(APNS for iOS, GCM for Android)。 其他字段需要填写,具体取决于平台:
对要支持的每个平台重复上述步骤一次。 要能够同时推送到iOS和Android,必须创建两个平台应用程序。
创建标识池
配置访问权限
{ “版本”:《2012-10-17》, "语句": [ { "操作": [ "mobileanalytics:PutEvents", “cognito sync:*”, "SNS:CreatePlatformEndpoint", "SNS:订阅" ], “效果”:“允许”, "资源": [ "*" ] } ] }
|
如果您不想使用Pushwoosh,可以跳过此步骤。
要使用Pushwoosh:
注册Pushwoosh
创建API访问令牌
创建新应用程序
如果在AEM中配置了另一个具有相同App Id(和其他相关值)的应用程序:API访问令牌和GCM ID),通过AEM上的第二个应用程序发送的任何推送通知都将转到具有该App ID的任何其他应用程序。
创建两个名为notificationsConfig的内容节点(一个在app-config中,一个在app-config-dev中):
<your app>
/shell/jcr:content/pge-app/app-config-dev/notificationsConfig<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:
如果出于应用程序上的空间考虑而删除或未使用推送通知,并且要避免出现控制台错误消息,请从应用程序中删除这些客户端库。
对于推送通知,您需要在实际设备上进行测试,因为模拟器无法接收推送通知。
对于iOS,您需要使用Mac OS计算机,并且您需要加入iOS开发人员项目。 某些公司拥有所有开发人员都可使用的公司许可证。
对于XCode 8.1,在使用推送通知之前,您必须转到项目的“功能”选项卡,并切换“推送通知”开启。
要使用CLI在Android手机上安装应用程序(请参阅下文:第6步——构建和部署应用程序),您首先必须将电话置于“开发人员模式”。 有关执行此操作的详细信息,请参阅启用设备上开发者选项。
在构建并部署到已配置的移动设备之前,必须为您决定使用的消息服务配置通知设置。
注意:另 请参阅此处有关构建 PhoneGap应用程序的说明。
有两种方法可使用PhoneGap构建和部署应用程序。
注意: 对于推送通知测试,模拟器是不够的,因为推送通知使用推送提供程序(Apple或Google)和设备之间的不同协议。当前的Mac/PC硬件和模拟器不支持此功能。
PhoneGap Builder 是PhoneGap提供的一项服务,将在其服务器上为您构建应用程序,并允许您直接将其下载到设备。请参阅PhoneGap Build文档,了解如何设置和使用PhoneGap Build。
PhoneGap命令行界面 (CLI)允许您在命令行上使用一组丰富的PhoneGap命令来构建、调试和部署应用程序。请参阅PhoneGap开发人员文档,了解如何设置和使用PhoneGap CLI。
要创建并发送新通知,请按照以下步骤操作。
创建新通知
发送通知
处理结果
如果推送通知服务(AmazonSNS或Pushwoosh)收到“发送”请求,确认其有效,并成功将其发送给本机提供者(APNS和GCM),则“发送”对话框将关闭,且不显示任何消息。 在通知列表中,该通知的状态将列为“已发送”。
如果推送发送失败,对话框将显示一条消息,指明问题。 在通知列表中,该通知的状态将列为“错误”,但如果问题得到纠正,则可以再次发送通知。 在错误事件下,服务器错误日志中应显示其他错误信息。
请注意,iOS和Android推送通知之间存在一些平台差异。 其中:
对于AMS推送通知,必须编写通知并从AMS服务器发送。 AMS提供的推送通知功能超出AEM通知与AWS和Pushwoosh提供的功能。
推送通知不保证投放;更像是公告。尽最大努力,确保每个人都听到,但它们不是一个有保证的投放机制。 此外,传送推送的时间可从不到一秒到长达半小时。
什么是深层链接? 在推送通知的上下文中,这是一种允许应用程序打开或定向(如果打开)到应用程序内指定位置的方法。
它是如何工作的? 推送通知的作者可以选择添加按钮标签(即“给我看看!”) ,并通过可视路径浏览器选择您希望在通知中链接的页面。 发送后,推送会正常发生,但应用程序内消息中“确定”按钮将替换为“取消”按钮并指定新按钮(“显示我!”) 的双曲余切值。 单击新按钮将使应用程序转到应用程序中的指定页面。 单击“取消”将仅取消消息。
如果应用程序未打开,阴影将正常显示。 在阴影中对通知执行操作将打开应用程序,然后根据推送通知中配置的内容向用户显示深层链接按钮。
创建通知,为可选深层链接添加按钮文本和链接路径:
.要访问仪表板中的推送通知拼贴,请执行以下步骤。
单击管理Cloud Services磁贴右上角的编辑。
选择Pushwoosh连接。 单击下一步。
输入属性的详细信息,然后单击提交。
提交配置后,推送通知磁贴将显示在仪表板中。
在仪表板中显示推送通知拼贴后,使用创建通知向导添加内容:
单击推送通知拼贴右上角的添加符号以打开创建通知向导。
单击链接路径中的浏览图标,向用户显示应用程序的内容结构。
选择路径后,单击复选图标。
“链接按钮文本”限制为20个字符。
如果最终用户没有最新版本的应用程序并且链接的路径不可用,则确认深层链接的操作将使用户进入应用程序的主页。
在创建通知向导中输入文本详细信息,然后单击创建。
单击您从推送通知拼贴创建的推送通知以打开详细信息。
您可以编辑属性、发送通知或删除通知。
附加信息:
在6.4版本发布后,将不支持Pushwoosh和AmazonSNS,并将作为插件从包共享中提供。
了解有关应用程序推送通知的详细信息后,请参阅AEM Mobile内容个性化。