Adobe建議針對需要以單頁應用程式框架為基礎的使用者端轉譯(例如React)的專案,使用SPA編輯器。 深入了解。
能夠立即以重要通知提醒您的Adobe Experience Manager (AEM)行動應用程式使用者,對行動應用程式的價值及其行銷活動至關重要。 以下說明讓應用程式接收推播通知所必須採取的步驟。 您也會瞭解如何設定推送,並從AEM Mobile傳送至手機上安裝的應用程式。 此外,本節將說明如何設定 深層連結 功能新增至您的推播通知。
推播通知並不保證一定會傳送;它們更像公告。 盡最大努力確保每個人都收到這些訊息,但它們不是保證的傳送機制。 此外,傳送推播的時間可能會從不到一秒到最多半小時不等。
搭配AEM使用推播通知需要幾項不同的技術。 首先,推播通知服務提供者必須用來管理推播通知和裝置(AEM尚未執行此操作)。 使用AEM可立即使用兩個提供者進行設定: Amazon簡單通知服務 (或SNS),以及 Pushwoosh. 第二,特定行動作業系統的推送技術必須通過適當的服務 — 適用於iOS裝置的Apple推送通知服務(或APNS),以及適用於Android™裝置的Google雲端通訊(或GCM)。 雖然AEM不會直接與這些平台專屬服務通訊,但AEM必須隨同通知提供一些相關設定資訊,這些服務才能執行推送。
安裝及設定完成後(如下所述),其運作方式如下:
此版本的AEM支援iOS和Android™行動裝置。
若要在AEM Mobile應用程式中使用推播通知,必須執行下列高階步驟。
通常Experience Manager開發人員會執行以下操作:
當Experience Manager管理員執行下列操作時:
前往Apple頁面 此處 以熟悉Apple推播通知服務。
若要使用APN,您需要 憑證 檔案(.cer檔案),推播 私密金鑰 (a .p12檔案)和 私密金鑰密碼 來自Apple。 操作說明,請參閱 此處.
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 和 Pushwoosh 設定可讓您從AEM畫面內傳送推播。
Adobe行動服務 設定可讓您使用Adobe Analytics帳戶從Adobe Mobile Services中設定及傳送推播通知(但應用程式必須透過此設定集建置,才能啟用AMS推播通知)。
如需Amazon SNS的相關資訊,以及建立AWS帳戶的連結,請參閱 此處. 您可以取得一年的免費帳戶。
如果您不想要使用Amazon SNS,可以略過這些步驟。
請依照下列步驟設定推播通知的Amazon SNS:
向Amazon SNS註冊
建立存取金鑰和ID
存取金鑰可用於多個應用程式。
對於使用「AWS沙箱」帳戶的組織,步驟類似,並概述如下:
建立主題
您可以針對不同的情境建立多個主題,例如開發、測試和示範。 其餘的SNS設定可以維持不變。 使用不同主題建置應用程式;傳送至該主題的推播通知將只會由該主題建置的應用程式接收。
建立平台應用程式
按一下應用程式,然後按一下建立平台應用程式。 選擇名稱並選取平台(APNS適用於iOS,GCM適用於Android™)。 視平台而定。 其他欄位必須填寫:
針對您支援的每個平台重複上述步驟一次。 若要同時推送至iOS和Android™,必須建立兩個平台應用程式。
建立識別集區
設定存取權限
{ 「版本」:「2012-10-17」, "陳述式": [ { "動作": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effect": "Allow", "資源": [ "*" ] } ] }
|
如果您不想要使用Pushwoosh,可以略過此步驟。
若要使用Pushwoosh:
註冊Pushwoosh
建立API存取Token
建立應用程式
如果在AEM中使用相同的應用程式ID (及其他相關值: API存取權杖和GCM ID)設定第二個應用程式,任何透過AEM上的第二個應用程式傳送的推播通知都會傳送到具有該應用程式ID的任何其他應用程式。
建立兩個名為notificationsConfig的內容節點(一個在app-config中,一個在app-config-dev中):
<your app>
/shell/jcr:content/pge-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfig使用以下屬性(.content.xml檔案) :
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" jcr:primaryType="nt:unstructured" excludeProperties="[appAPIAccessToken]" path="。./…/…/…"
🔗targetRootDirectory="www" type="notificationsconfig"/>
內容同步處理常式會尋找這些節點,如果不存在,則不會寫出page-notifications-config.json檔案。
您必須依照下列步驟,將推播通知使用者端程式庫新增至應用程式:
CRXDE Lite:
如果出於應用程式空間考量而移除或未使用推播通知,並為了避免主控台錯誤訊息,請從您的應用程式中移除這些clientlibs。
對於推播通知,您必須在實際裝置上進行測試,因為模擬器無法接收推播通知。
若為iOS,請使用macOS電腦並加入 iOS開發人員計畫. 有些公司擁有所有開發人員都可使用的公司授權。
使用XCode 8.1時,您必須先前往專案中的功能標籤,並將推播通知切換為開啟,才能使用推播通知。
若要使用CLI在Android™手機上安裝應用程式(請參閱下文: 步驟6 — 建置和部署應用程式),您必須先將手機置於「開發人員模式」。 另請參閱 啟用裝置上開發人員選項 以取得執行此動作的詳細資訊。
在建置及部署到您設定的行動裝置之前,您必須針對您決定使用的訊息服務設定通知設定。
注意: 請參閱指示 此處 建置PhoneGap應用程式時。
有兩種方法可使用PhoneGap建置和部署您的應用程式。
注意: 對於推播通知測試,模擬器是不夠的,因為推播通知在推播提供者(Apple或Google)和裝置之間使用不同的通訊協定。 目前的Mac/PC硬體和模擬器不支援此功能。
PhoneGap Build 是PhoneGap提供的服務,可在伺服器上為您建立應用程式,並讓您直接下載至裝置。 請參閱PhoneGap Build檔案,網址為 https://build.phonegap.com/
以瞭解如何設定和使用PhoneGap Build。
PhoneGap命令列介面 (CLI)可讓您在命令列上使用一組豐富的PhoneGap命令,以建置、偵錯和部署您的應用程式。 請參閱PhoneGap開發人員檔案(https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
),瞭解如何設定和使用PhoneGap CLI。
若要建立通知並傳送,請依照下列步驟進行。
建立通知
傳送通知
處理結果
如果推播通知服務(Amazon SNS或Pushwoosh)收到傳送請求,確認其有效,然後成功傳送給原生提供者(APNS和GCM),「傳送」對話方塊會關閉,但不顯示任何訊息。 在通知清單中,該通知的狀態會列為「已傳送」。
如果推送傳送失敗,對話方塊會顯示訊息,指出問題。 在通知清單中,該通知的狀態會列為「錯誤」,但如果問題已解決,則可再次傳送通知。 如果發生錯誤,伺服器錯誤記錄中應該會出現其他錯誤資訊。
請注意,iOS和Android™推播通知之間有一些平台差異。 其中包括:
對於AMS推播通知,必須撰寫通知並從AMS伺服器傳送。 AMS提供其他推播通知功能,超出搭配AWS和Pushwoosh的AEM通知所具備的功能。
推播通知並不保證一定會傳送;它們更像公告。 盡最大努力確保每個人都能聽到,但他們並不是保證的傳送機制。 此外,傳送推播的時間可能會從不到一秒到最多半小時不等。
什麼是深層連結? 在推播通知的情境下,這是允許應用程式開啟或導向(如果開啟)至應用程式內指定位置的方法。
如何運作? 推播通知的作者可選擇新增按鈕標籤(即「顯示給我!」) 前往通知,並透過視覺路徑瀏覽器選擇他們要在通知中連結的頁面。 傳送後,推播會正常發生,除了應用程式內訊息中,「確定」按鈕會被「解除」按鈕取代,而新按鈕則被指定(「顯示我!」) 也會出現。 按一下新按鈕,應用程式就會移至應用程式內的指定頁面。 按一下「關閉」會排除訊息。
如果應用程式未開啟,則陰影會正常顯示。 在陰影中的通知上採取行動會開啟應用程式,然後根據推播通知中的設定向使用者顯示深層連結按鈕。
建立通知、新增按鈕文字,以及選擇性深層連結的連結路徑:
若要存取控制面板中的「推播通知」圖磚,請遵循下列步驟。
按一下右上角的編輯 管理Cloud Service 圖磚。
選取 Pushwoosh連線. 按一下「下一步」。
輸入屬性的詳細資訊,然後按一下 提交.
只要您提交設定, 推播通知 圖磚會顯示在控制面板中。
一旦 推播通知 圖磚會顯示在您的儀表板中,使用建立通知精靈來新增內容:
按一下右上角的新增符號 推播通知 圖磚以開啟 建立通知精靈.
按一下連結路徑中的瀏覽圖示,使用者會看到應用程式的內容結構。
選取路徑後,按一下核取圖示。
連結按鈕文字限製為20個字元。
如果一般使用者沒有最新版本的應用程式,且連結的路徑無法使用,則確認深層連結的動作會將使用者引導至應用程式的首頁面。
輸入 文字詳細資訊 在 建立通知精靈 並按一下 建立.
按一下您從「 」建立的推播通知以開啟詳細資訊。 推播通知 圖磚。
您可以編輯屬性、傳送通知或刪除通知。
其他資訊:
6.4版之後不支援Pushwoosh和Amazon SNS,並會以Package Share附加元件的形式提供。
瞭解應用程式的推播通知詳細資訊後,請參閱 AEM Mobile內容個人化.