針對 Android 的設定步驟

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

注意

若要了解如何為iOS設定您的應用程式，以及如何為iOS建立傳送，請參閱此區段。

關鍵步驟為：

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

然後，您將能夠建立Android豐富通知。

配置Android外部帳戶

Android提供兩個連接器：

  • V1連接器，允許每個MTA子項有一個連接。
  • 允許與FCM伺服器同時連線以改善吞吐量的V2連接器。

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

  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伺服器設定檔案(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。 如需詳細資訊，請參閱本章節。

    注意

    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 API

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

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

  2. 按一下​Load project json file to extract projet details…​以直接載入您的JSON索引鍵檔案。 如需如何擷取JSON檔案的詳細資訊，請參閱本頁。

    您也可以手動輸入下列詳細資訊：

    • Project Id
    • Private Key
    • Client Email

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

    注意

    若為中間來源部署，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, image, ticker, ticking, 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
通知訊息 標題， body, android_channel_id，圖示， sound, tag, color, click_action
dryRun

擴展appsubscriptionRcp架構

了解如何在影片中擴充appsubscriptionRcp架構

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

  1. 建立​Subscriber applications (nms:appsubscriptionRcp)​架構的擴充功能並定義新欄位。 進一步了解本頁面中的綱要擴展

  2. 在​Subscription parameters​索引標籤中定義對應。

    注意

    確認​Subscription parameters​標籤中的設定名稱與行動應用程式程式碼中的名稱相同。 請參閱本節。

本頁內容