針對 Android 的配置步驟

在安裝套件後，您就可以在Adobe Campaign Classic中定義您的Android應用程式設定。

主要步驟為：

1. 設定Android外部帳戶
2. 設定Android服務
3. 在Campaign中建立行動應用程式
4. 使用其他資料擴充應用程式架構

然後，您就可以建立Android豐富式通知。

設定Android外部帳戶

對於Android，有兩個連接器可用：

• V1連接器，允許每個MTA子項連接一個。
• V2連接器允許與FCM伺服器同時連接，以提高吞吐量。

要選擇要使用的連接器，請執行以下步驟：

1. 前往​Administration > Platform > External accounts。

2. 選擇​Android routing​外部帳戶。

3. 在​Connector​標籤中，填入​JavaScript used in the connector​欄位：

   針對Android V2:https://localhost:8080/nms/jsp/androidPushConnectorV2.js

   注意

   您也可以依https://localhost:8080/nms/jsp/androidPushConnector.js設定，但建議您使用第2版的連接器。

   

4. 對於Android V2,Adobe Server組態檔(serverConf.xml)中還有一個參數：

   • maxGCMConnectPerChild:每個子伺服器啟動的對FCM的並行HTTP請求的最大限制（預設為8）。

設定Android服務

瞭解如何在視訊中設定Android服務

1. 轉到​Profiles and Targets > Services and subscriptions​節點，然後按一下​New。

   

2. 定義​Label​和​Internal name。

3. 轉至​Type​欄位並選取​Mobile application。

   注意

   預設的​Subscriber applications (nms:appSubscriptionRcp)​目標對應會連結至收件者表格。 如果要使用不同的目標映射，則需要建立新的目標映射，並在服務的​Target mapping​欄位中輸入該映射。 有關建立目標映射的詳細資訊，請參閱配置指南。

   

4. 然後，按一下​Add​按鈕以選擇應用程式類型。

   

5. 建立您的Android應用程式。 如需詳細資訊，請參閱本區段。

建立Android行動應用程式

在建立服務後，您現在需要建立Android應用程式：

1. 在新建立的服務中，按一下​Add​按鈕以選擇應用程式類型。

   

2. 選擇​Create an Android application​並輸入​Label。

   

3. 請確定Adobe Campaign和應用程式碼中已透過SDK定義相同的​Integration key。 有關詳情，請參閱：將Campaign SDK整合至行動應用程式。

   注意

   Integration key​可完全自訂字串值，但必須與SDK中指定的值完全相同。

4. 選擇​API version:HTTP v1或HTTP（舊版）。 這些配置在本節中有詳細說明

5. 填寫​Firebase Cloud Messaging the Android connection settings​欄位。

6. 按一下 Finish，之後 Save。您的Android應用程式現在已可供用於Campaign Classic。

依預設，Adobe Campaign會在​Subscriber applications (nms:appSubscriptionRcp)​表格的​User identifier(@userKey)欄位中儲存索引鍵。 此金鑰可讓您將訂閱連結至收件者。 要收集其他資料（如複雜的協調密鑰），需要應用以下配置：

選擇API版本

在建立服務和新的行動應用程式後，您需要根據所選的API版本來設定行動應用程式。

• HTTP v1配 置在本節中有詳細 說明。
• HTTP（舊版） 設定在本節中詳 細說明。

配置HTTP v1 API

若要設定HTTP v1 API版本，請遵循下列步驟：

1. 在​Mobile application creation wizard​窗口中，選擇​API version​下拉式清單中的​HTTPV1。

2. 按一下​Load project json file to extract projet details…​可直接載入您的JSON金鑰檔案。 如需如何擷取JSON檔案的詳細資訊，請參閱此page頁面。

   您也可以人工輸入下列詳細資訊：

   • Project Id
   • Private Key
   • Client Email

   

3. 按一下​Test the connection​以檢查您的設定是否正確，以及行銷伺服器是否可存取FCM。

   注意

   對於Mid-Sourcing部署，Test connection​按鈕將不檢查MID伺服器是否可以訪問FCM伺服器。

   

4. 您也可以視需要使用某些​Application variables​來豐富推播訊息內容。 這些功能可完全自訂，而且是傳送至行動裝置的訊息裝載的一部分。

5. 按一下 Finish，之後 Save。您的Android應用程式現在已可供用於Campaign Classic。

以下是FCM裝載名稱，可進一步個人化您的推播通知：

消息類型	可配置消息元素（FCM有效負載名稱）	可配置選項（FCM有效負載名稱）
資料消息	N/A	validate_only
通知消息	title, body, android_channel ID, icon, sound, tag, color, click_action，影像， ticker, sticky, visibility, notification_priority, notification_count	validate_only

設定HTTP（舊版）API

若要設定HTTP（舊版）API版本，請遵循下列步驟：

1. 在​Mobile application creation wizard​窗口中，選擇​API version​下拉式清單中的​HTTP (legacy)。

2. 輸入由行動應用程式開發人員提供的​Project key。

3. 您也可以視需要使用某些​Application variables​來豐富推播訊息內容。 這些功能可完全自訂，而且是傳送至行動裝置的訊息裝載的一部分。

   在下列範例中，我們新增​title、imageURL​和​iconURL​來建立豐富式推播通知，然後為應用程式提供影像、標題和圖示，以便在通知中顯示。

   

4. 按一下 Finish，之後 Save。您的Android應用程式現在已可供用於Campaign Classic。

以下是FCM裝載名稱，可進一步個人化您的推播通知：

消息類型	可配置消息元素（FCM有效負載名稱）	可配置選項（FCM有效負載名稱）
資料消息	不適用	dryRun
通知消息	title, body, android_channel_id, icon, sound, tag, color, click_action	dryRun

擴充appsubscriptionRcp結構

瞭解如何在視訊中擴充appsubscriptionRcp架構

您需要擴充​appsubscriptionRcp，以定義新的其他欄位，將應用程式的參數儲存在Campaign資料庫中。 例如，這些欄位將用於個人化。 操作步驟：

1. 建立​Subscriber applications (nms:appsubscriptionRcp)​方案的副檔名並定義新欄位。 進一步瞭解本頁中的架構擴充功能

2. 在​Subscription parameters​標籤中定義映射。

   注意

   請確定​Subscription parameters​標籤中的組態名稱與行動應用程式碼中的組態名稱相同。 請參閱「將Campaign SDK整合至行動應用程式」一節。

建立Android豐富式通知

有了Firebase Cloud Messaging，您可以選擇兩種訊息類型：

• Data message，由用戶端應用程式處理。
  
  訊息會直接傳送至行動應用程式，而行動應用程式會產生並顯示Android通知至裝置。資料訊息只包含您的自訂應用程式變數。

• Notification message，由FCM SDK自動處理。
  
  FCM會代表用戶端應用程式在您的使用者裝置上自動顯示訊息。通知訊息包含一組預先定義的參數和選項，但仍可使用自訂的應用程式變數進一步個人化。

有關Firebase Cloud消息類型的詳細資訊，請參閱FCM文檔。

建立資料消息

1. 前往​Campaign management > Deliveries。

2. 按一下 New。

   

3. 在​Delivery template​下拉式清單中選取​Deliver on Android (android)。 將​Label​新增至您的傳送。

4. 按一下​To​定義要定位的人口。 預設情況下，將應用​Subscriber application​目標映射。 按一下​Add​選擇服務。

   

5. 在​Target type​窗口中，選擇​Subscribers of an Android mobile application​並按一下​Next。

6. 在​Service​下拉式清單中，選取您先前建立的服務，然後選擇應用程式，然後按一下​Finish。
   根據在配置步驟中添加的內容，會自動添加​Application variables。

   

7. 選擇​data message​作為​Message Type。

8. 編輯您的豐富式通知。

   

9. 如有需要，您可以在先前設定的​Application variables​中新增資訊。 Application variables 必須在Android服務中設定，且是傳送至行動裝置之訊息裝載的一部分。

10. 按一下​Save​並傳送傳送。

當在訂閱者的行動Android裝置上收到影像和網頁時，應該會顯示在推播通知中。

建立通知消息

瞭解如何在視訊中建立Android推播通知

1. 前往​Campaign management > Deliveries。

2. 按一下 New。

   

3. 在​Delivery template​下拉式清單中選取​Deliver on Android (android)。 將​Label​新增至您的傳送。

4. 按一下​To​定義要定位的人口。 預設情況下，將應用​Subscriber application​目標映射。 按一下​Add​選擇服務。

   

5. 在​Target type​窗口中，選擇​Subscribers of an Android mobile application​並按一下​Next。

6. 在​Service​下拉式清單中，選取您先前建立的服務，然後選擇應用程式，然後按一下​Finish。

   

7. 選擇​notification message​作為​Message Type。

8. 新增標題並編輯您的訊息。 使用​Notification options​個人化您的推播通知：

   • Channel ID:設定通知的頻道ID。應用程式必須先使用此頻道ID建立頻道，才能收到任何具有此頻道ID的通知。
   • Sound:將音效設定為在裝置收到您的通知時播放。
   • Color:設定通知的圖示顏色。
   • Icon:將通知的圖示設定為顯示在描述檔裝置上。
   • Tag:設定用來取代通知抽屜中現有通知的識別碼。
   • Click action:設定與使用者相關的動作，按一下您的通知。

   有關​Notification options​以及如何填寫這些欄位的詳細資訊，請參閱FCM文檔。

   

9. 如果您的應用程式已設定HTTP v1 API通訊協定，您可以使用下列​HTTPV1 additional options​進一步個人化您的推播通知：

   • Ticker:設定通知的提示文字。僅適用於設為Android 5.0 Lollipop的裝置。
   • Image:將影像的URL設定為顯示在通知中。
   • Notification Count:設定要直接顯示在應用程式圖示上的新未讀取資訊數目。
   • Sticky:設為true或false。如果設為false，則當使用者按一下通知時，通知會自動關閉。 如果設為true，即使使用者按一下通知，通知仍會顯示。
   • Notification Priority:將通知的優先順序層級設定為預設、最小、低或高。有關詳細資訊，請參閱FCM文檔。
   • Visibility:將通知的可見度等級設為公開、私人或機密。有關詳細資訊，請參閱FCM文檔。

   有關​HTTP v1 additional options​以及如何填寫這些欄位的詳細資訊，請參閱FCM文檔。

   

10. 如有需要，您可以在先前設定的​Application variables​中新增資訊。 Application variables 必須在Android服務中設定，且是傳送至行動裝置之訊息裝載的一部分。

11. 按一下​Save​並傳送傳送。

當在訂閱者的行動Android裝置上收到影像和網頁時，應該會顯示在推播通知中。