推播通知

能夠立即以重要通知提醒您的Adobe Experience Manager (AEM)行動應用程式使用者，對行動應用程式的價值及其行銷活動至關重要。 以下說明讓應用程式接收推播通知所必須採取的步驟。 您也會瞭解如何設定推送，並從AEM Mobile傳送至手機上安裝的應用程式。 此外，本節將說明如何設定 深層連結 功能新增至您的推播通知。

搭配AEM使用推播通知需要幾項不同的技術。 首先，推播通知服務提供者必須用來管理推播通知和裝置(AEM尚未執行此操作)。 使用AEM可立即使用兩個提供者進行設定： Amazon簡單通知服務 （或SNS），以及 Pushwoosh. 第二，特定行動作業系統的推送技術必須通過適當的服務 — 適用於iOS裝置的Apple推送通知服務（或APNS），以及適用於Android™裝置的Google雲端通訊（或GCM）。 雖然AEM不會直接與這些平台專屬服務通訊，但AEM必須隨同通知提供一些相關設定資訊，這些服務才能執行推送。

安裝及設定完成後（如下所述），其運作方式如下：

1. 推播通知會在AEM中建立，並傳送給服務提供者(Amazon SNS或Pushwoosh)。
2. 服務提供者會接收該檔案，並將其傳送給核心提供者（APNS或GCM）。
3. 核心提供者會將通知推播至已註冊該推播的所有裝置。 對於每個裝置，它會使用行動資料網路或WiFi，以裝置上可用的任何專案為準。
4. 如果為其註冊的應用程式未執行，則通知會顯示在裝置上。 使用者點選通知會啟動應用程式，並在應用程式中顯示通知。 如果應用程式已在執行中，則只會顯示應用程式內通知。

此版本的AEM支援iOS和Android™行動裝置。

概述與程式

若要在AEM Mobile應用程式中使用推播通知，必須執行下列高階步驟。

通常Experience Manager開發人員會執行以下操作：

1. 註冊Apple和Google訊息服務
2. 註冊推送訊息服務並進行設定
3. 將推送支援新增至應用程式
4. 準備電話以進行測試

當Experience Manager管理員執行下列操作時：

1. 在AEM應用程式上設定推播
2. 建置和部署應用程式
3. 傳送推播通知
4. 設定深層連結 （選擇性）

步驟1：註冊Apple和Google訊息服務

使用Apple推播通知服務(APNS)

前往Apple頁面 此處 以熟悉Apple推播通知服務。

若要使用APN，您需要 憑證 檔案（.cer檔案），推播 私密金鑰 （a .p12檔案）和 私密金鑰密碼 來自Apple。 操作說明，請參閱 此處.

使用Google雲端通訊(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雲端通訊.
6. 接著會顯示新的伺服器API金鑰和（新的或現有的）寄件者ID。

步驟2：註冊並設定推送訊息服務

AEM已設定為使用下列三個推送通知服務之一：

• Amazon SNS
• Pushwoosh
• Adobe行動服務

AMAZON SNS 和 Pushwoosh 設定可讓您從AEM畫面內傳送推播。

Adobe行動服務 設定可讓您使用Adobe Analytics帳戶從Adobe Mobile Services中設定及傳送推播通知（但應用程式必須透過此設定集建置，才能啟用AMS推播通知）。

使用Amazon SNS傳訊服務

如果您不想要使用Amazon SNS，可以略過這些步驟。

請依照下列步驟設定推播通知的Amazon SNS：

1. 向Amazon SNS註冊

   1. 記錄您的帳戶ID。 格式應為12位數，不含空格或破折號，即"123456789012"。
   2. 確定您位於「美國東部」或「歐盟」地區，因為後續步驟（建立身分識別集區）需要這些步驟之一。
   3. 註冊之後，登入管理主控台並選取 SNS （推播通知服務）。 如果出現，請按一下[開始使用]。

2. 建立存取金鑰和ID

   1. 按一下畫面右上角的登入名稱，然後從功能表選擇[安全性認證]。
   2. 按一下「存取金鑰」，然後在下列空白處按一下 建立新的存取金鑰.
   3. 按一下 顯示存取金鑰，並複製及儲存所顯示的存取金鑰ID和機密存取金鑰。 如果選擇下載金鑰的選項，您會得到包含這些相同值的csv檔案。
   4. 您可以在此頁面管理其他安全性相關憑證，以及某些其他憑證。
   注意

   存取金鑰可用於多個應用程式。

   對於使用「AWS沙箱」帳戶的組織，步驟類似，並概述如下：

   1. 按一下畫面右上角的登入名稱，然後從功能表選擇「我的安全性認證」。
   2. 按一下動作左側清單中的「使用者」 ，然後選擇您的使用者名稱。
   3. 按一下「保全性證明資料」標籤。
   4. 從這裡，您可以看到您的金鑰並建立新的金鑰。 儲存金鑰以供稍後使用。

3. 建立主題

   1. 按一下 建立主題 並選擇主題名稱。 記錄所有欄位，例如「主題ARN」、「主題擁有者」、「區域」、「顯示名稱」。
   2. 按一下 其他主題動作 > 編輯主題原則. 在 允許這些使用者訂閱此主題，選取 每個人。
   3. 按一下 更新原則.
   注意

   您可以針對不同的情境建立多個主題，例如開發、測試和示範。 其餘的SNS設定可以維持不變。 使用不同主題建置應用程式；傳送至該主題的推播通知將只會由該主題建置的應用程式接收。

4. 建立平台應用程式

   1. 按一下應用程式，然後按一下建立平台應用程式。 選擇名稱並選取平台(APNS適用於iOS，GCM適用於Android™)。 視平台而定。 其他欄位必須填寫：

      1. 對於APNS，必須輸入P12檔案、密碼、憑證和私密金鑰。 這些應該在步驟中獲得 使用Apple推播通知服務(APNS) 以上。
      2. 對於GCM，必須輸入API金鑰。 這應在步驟中獲得 使用Google雲端通訊(GCM)服務 以上。

   2. 針對您支援的每個平台重複上述步驟一次。 若要同時推送至iOS和Android™，必須建立兩個平台應用程式。

5. 建立識別集區

   1. 使用 Cognito 建立身分識別集區，以儲存未驗證使用者的基本資料。 請注意，Amazon Cognito目前僅支援「美國東部」和「歐盟」地區。
   2. 為其命名，並勾選「啟用對未驗證身分的存取」方塊。
   3. 在下一頁("您的Cognito身分識別需要存取您的資源")按一下「允許」。
   4. 在頁面的右上方，按一下連結»編輯身分識別集區」. 此時會顯示身分識別集區ID。 儲存此文字以供稍後使用。
   5. 在同一頁面上，選擇「Unauthenticated role」旁的下拉式清單，並確定其角色為Cognito_<pool name="">已選取UnauthRole。 儲存您的變更。

6. 設定存取權限

   1. 登入 識別與存取管理 (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：Subscribe" ], "Effect"： "Allow"， "資源": [ "*" ] } ] }

   1. 按一下 套用原則.

使用Pushwoosh傳訊服務

如果您不想要使用Pushwoosh，可以略過此步驟。

若要使用Pushwoosh：

1. 註冊Pushwoosh

   1. 前往pushwoosh.com並建立帳戶。

2. 建立API存取Token

   1. 在Pushwoosh網站上，前往API存取功能表專案來產生API存取權杖。 安全地記錄此權杖。

3. 建立應用程式

   1. 如需Android™支援，您必須提供GCM API金鑰。
   2. 設定應用程式時，請選擇Cordova做為架構。
   3. 若為iOS支援，您必須提供憑證檔案(.cer)、推播憑證(.p12)和私密金鑰密碼；這些應該已從Apple的APNS網站取得。 針對「架構」，請選擇「Cordova」。
   4. Pushwoosh會為該應用程式產生一個應用程式ID，格式為「XXXXX-XXXXX」，其中每個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/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"/>

新增使用者端資料庫

您必須依照下列步驟，將推播通知使用者端程式庫新增至應用程式：

CRXDE Lite：

1. 瀏覽至 /etc/designs/phonegap/<app name="">/clientlibsall。
2. 在屬性窗格中連按兩下內嵌區段。
3. 在出現的對話方塊中，按一下+按鈕以新增使用者端程式庫。
4. 在新文字欄位中新增"cq.mobile.push"，然後按一下「確定」。
5. 再新增一個名為cq.mobile.push.amazon的專案，然後按一下「確定」。
6. 儲存變更。

步驟4：準備電話以進行測試

iOS

若為iOS，請使用macOS電腦並加入 iOS開發人員計畫. 有些公司擁有所有開發人員都可使用的公司授權。

使用XCode 8.1時，您必須先前往專案中的功能標籤，並將推播通知切換為開啟，才能使用推播通知。

Android™

若要使用CLI在Android™手機上安裝應用程式(請參閱下文： 步驟6 — 建置和部署應用程式)，您必須先將手機置於「開發人員模式」。 另請參閱 啟用裝置上開發人員選項 以取得執行此動作的詳細資訊。

步驟5：在AEM應用程式上設定推播

在建置及部署到您設定的行動裝置之前，您必須針對您決定使用的訊息服務設定通知設定。

1. 為推播通知建立適當的授權群組。
2. 以適當使用者身分登入AEM，按一下「應用程式」標籤。
3. 按一下應用程式。
4. 找到「管理Cloud Service」圖磚，然後按一下鉛筆圖示，即可修改您的雲端設定。
5. 選取Amazon SNS連線、Pushwoosh連線或Adobe Mobile Services作為通知設定。
6. 輸入提供者屬性，然後按一下「提交」以儲存這些屬性，再按一下「完成」。 除非有AMS，否則目前階段不會從遠端驗證它們。
7. 您現在應該會看到剛才在「管理Cloud Service」圖磚上輸入的設定。

步驟6：建置和部署應用程式

注意： 請參閱指示 此處 建置PhoneGap應用程式時。

有兩種方法可使用PhoneGap建置和部署您的應用程式。

注意： 對於推播通知測試，模擬器是不夠的，因為推播通知在推播提供者(Apple或Google)和裝置之間使用不同的通訊協定。 目前的Mac/PC硬體和模擬器不支援此功能。

1. PhoneGap Build 是PhoneGap提供的服務，可在伺服器上為您建立應用程式，並讓您直接下載至裝置。 請參閱PhoneGap Build檔案，網址為 https://build.phonegap.com/ 以瞭解如何設定和使用PhoneGap Build。

2. PhoneGap命令列介面 (CLI)可讓您在命令列上使用一組豐富的PhoneGap命令，以建置、偵錯和部署您的應用程式。 請參閱PhoneGap開發人員檔案(https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface)，瞭解如何設定和使用PhoneGap CLI。

步驟7：傳送推播通知

若要建立通知並傳送，請依照下列步驟進行。

1. 建立通知

   • 在您的AEM Mobile應用程式控制面板中，找出「推播通知」圖磚。
   • 在右上角的功能表中，選擇「建立」。 在首次設定雲端設定之前，此按鈕不可用。
   • 在「建立通知精靈」中輸入標題和訊息，然後按一下「建立」按鈕。 您的通知現在已準備好立即或稍後傳送。 可以編輯它，並且可以變更和儲存訊息和/或標題。

2. 傳送通知

   • 在應用程式控制面板中，找出「推播通知」圖磚。
   • 選取通知，或按一下右下方的詳細資訊按鈕( )。…)，顯示通知清單。 此清單也會指出通知是否已準備好傳送、已傳送，或傳送期間是否發生錯誤。
   • 勾選一個通知的核取方塊（僅限），然後按一下清單上方的「傳送通知」按鈕。 您有機會在出現的對話方塊上「取消」或「傳送」通知。

3. 處理結果

   • 如果推播通知服務(Amazon SNS或Pushwoosh)收到傳送請求，確認其有效，然後成功傳送給原生提供者（APNS和GCM），「傳送」對話方塊會關閉，但不顯示任何訊息。 在通知清單中，該通知的狀態會列為「已傳送」。

   • 如果推送傳送失敗，對話方塊會顯示訊息，指出問題。 在通知清單中，該通知的狀態會列為「錯誤」，但如果問題已解決，則可再次傳送通知。 如果發生錯誤，伺服器錯誤記錄中應該會出現其他錯誤資訊。

   • 請注意，iOS和Android™推播通知之間有一些平台差異。 其中包括：

     • 以CLI建置應用程式，會在應用程式部署於Android™上後啟動。 在iOS上，您必須手動啟動。 由於推送註冊步驟會在啟動時進行，Android™應用程式會立即收到推送通知（因為其已啟動並註冊），而iOS應用程式則無法進行。
     • 在Android™上，「確定」按鈕文字全部為大寫（以及在應用程式內通知中新增的任何其他按鈕中），但在iOS中則否。

對於AMS推播通知，必須撰寫通知並從AMS伺服器傳送。 AMS提供其他推播通知功能，超出搭配AWS和Pushwoosh的AEM通知所具備的功能。

設定推播通知的深層連結

什麼是深層連結？ 在推播通知的情境下，這是允許應用程式開啟或導向（如果開啟）至應用程式內指定位置的方法。

如何運作？ 推播通知的作者可選擇新增按鈕標籤（即「顯示給我！」） 前往通知，並透過視覺路徑瀏覽器選擇他們要在通知中連結的頁面。 傳送後，推播會正常發生，除了應用程式內訊息中，「確定」按鈕會被「解除」按鈕取代，而新按鈕則被指定（「顯示我！」） 也會出現。 按一下新按鈕，應用程式就會移至應用程式內的指定頁面。 按一下「關閉」會排除訊息。

如果應用程式未開啟，則陰影會正常顯示。 在陰影中的通知上採取行動會開啟應用程式，然後根據推播通知中的設定向使用者顯示深層連結按鈕。

建立通知、新增按鈕文字，以及選擇性深層連結的連結路徑：

1. 按一下右上角的編輯 管理Cloud Service 圖磚。

   

2. 選取 Pushwoosh連線. 按一下「下一步」。

   

3. 輸入屬性的詳細資訊，然後按一下 提交.

   

   只要您提交設定， 推播通知 圖磚會顯示在控制面板中。

   

建立通知精靈

一旦 推播通知 圖磚會顯示在您的儀表板中，使用建立通知精靈來新增內容：

1. 按一下右上角的新增符號 推播通知 圖磚以開啟 建立通知精靈.

   

2. 按一下連結路徑中的瀏覽圖示，使用者會看到應用程式的內容結構。

   選取路徑後，按一下核取圖示。

   

   注意

   連結按鈕文字限製為20個字元。

   如果一般使用者沒有最新版本的應用程式，且連結的路徑無法使用，則確認深層連結的動作會將使用者引導至應用程式的首頁面。

3. 輸入 文字詳細資訊 在 建立通知精靈 並按一下 建立.

   

   按一下您從「 」建立的推播通知以開啟詳細資訊。 推播通知 圖磚。

   您可以編輯屬性、傳送通知或刪除通知。

   

後續步驟

瞭解應用程式的推播通知詳細資訊後，請參閱 AEM Mobile內容個人化.