針對 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。 這些功能可完全自訂,且是傳送至行動裝置之訊息裝載的一部分。

    在下列範例中,我們新增​titleimageURL​和​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​標籤中的設定名稱與行動應用程式程式碼中的名稱相同。 請參閱本節

本頁內容