針對 Android 的配置步驟

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

注意

若要瞭解如何為iOS設定應用程式,以及如何建立iOS的傳送,請參閱此章節

主要步驟為:

  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​來豐富推播訊息內容。 這些功能可完全自訂,而且是傳送至行動裝置的訊息裝載的一部分。

    在下列範例中,我們新增​titleimageURL​和​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裝置上收到影像和網頁時,應該會顯示在推播通知中。

建立通知消息

注意

通知訊息的其他選項僅適用於HTTP v1 API設定。 如需詳細資訊,請參閱本區段

瞭解如何在視訊中建立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裝置上收到影像和網頁時,應該會顯示在推播通知中。

本頁內容