針對 Android 的設定步驟

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

主要步驟為:

然後,您將能夠 建立Android豐富型通知.

IMPORTANT
Android Firebase Cloud Messaging (FCM) 服務的一些重要變更將於 2024 年發行,並可能影響 Adobe Campaign 實施。Android 推播訊息訂閱服務設定可能需要更新,才能支援此變更。您已經可以檢查並採取行動。 在本節瞭解更多 Adobe Campaign v8技術檔案.

設定Android外部帳戶 configuring-external-account-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

    note note
    NOTE
    您也可以依照https://localhost:8080/nms/jsp/androidPushConnector.js進行設定,但建議您使用聯結器版本2。

  4. 對於Android V2,Adobe伺服器設定檔案(serverConf.xml)中還提供另一個引數:

    • maxGCMConnectPerChild:每個子伺服器向FCM發起之平行HTTP請求的最大限制(預設為8個)。

設定Android服務 configuring-android-service

瞭解如何在影片中設定Android服務.

  1. 前往 Profiles and Targets > Services and subscriptions 節點並按一下 New.

  2. 定義 LabelInternal name.

  3. 前往 Type 欄位並選取 Mobile application.

    note note
    NOTE
    預設 Subscriber applications (nms:appSubscriptionRcp) 目標對應會連結至收件者表格。 如果您想使用不同的目標對應,則需要建立新的目標對應,並在 Target mapping 服務的欄位。 有關建立目標對應的詳細資訊,請參閱 本節.

  4. 然後按一下 Add 按鈕以選取應用程式型別。

  5. 建立您的Android應用程式。 如需詳細資訊,請參閱本章節

建立Android行動應用計畫 creating-android-app

建立服務後,您現在需要建立Android應用程式:

  1. 從您新建立的服務,按一下 Add 按鈕以選取應用程式型別。

  2. 選取 Create an Android application 並輸入 Label.

  3. 確定相同 Integration key 是透過SDK在Adobe Campaign和應用程式程式碼中定義的。

    note note
    NOTE
    Integration key 可使用字串值完全自訂,但需與SDK中指定的值完全相同。
  4. 選取 API version:HTTP v1或HTTP (舊版)。 這些設定的詳細資訊,請參見 本節

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

  6. 按一下 FinishSave. 您的Android應用程式現在已準備好用於Campaign Classic。

依預設,Adobe Campaign會將金鑰儲存在 User identifier (@userKey)欄位 Subscriber applications (nms:appSubscriptionRcp) 表格。 此金鑰可讓您將訂閱連結至收件者。 若要收集其他資料(例如複雜的調解金鑰),您必須套用下列設定:

設定API版本 select-api-version

IMPORTANT
Android Firebase Cloud Messaging (FCM) 服務的一些重要變更將於 2024 年發行,並可能影響 Adobe Campaign 實施。為Google持續改善其服務,我們將於以下日期終止使用舊版FCM API: 2024年6月20日. 在本節瞭解更多 Adobe Campaign v8技術檔案.

建立服務和新的行動應用程式後,您需要設定行動應用程式。 此 HTTP (舊版) 不應選取API,因為它已被Google取代。

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

  1. 在您的 Mobile application creation wizard 視窗,選取 HTTPV1API version 下拉式清單。

  2. 按一下 Load project json file to extract project details… 直接載入您的JSON金鑰檔案。 有關如何解壓縮JSON檔案的詳細資訊,請參閱 此頁面.

    您也可以手動輸入下列明細:

    • Project Id
    • Private Key
    • Client Email

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

    note caution
    CAUTION
    對於中間來源部署, Test connection 按鈕不會檢查MID伺服器是否可存取FCM伺服器。

  4. 或者,您也可以選擇擴充推送訊息的內容 Application variables 如有需要。 這些都是可完全自訂的專案,而且是傳送至行動裝置的訊息裝載的一部分。

  5. 按一下 FinishSave. 您的Android應用程式現在已準備好用於Campaign Classic。

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

訊息類型
可設定的訊息元素(FCM裝載名稱)
可設定的選項(FCM裝載名稱)
資料訊息
N/A
validate_only
通知訊息
標題,內文, android_channel_id,圖示,聲音,標籤,顏色,點選動作,影像,提示,粘性,可見度,通知優先順序,通知計數
validate_only

擴充appsubscriptionRcp結構描述 extend-subscription-schema

瞭解如何在影片中擴充appsubscriptionRcp結構

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

  1. 建立「 」的 Subscriber applications (nms:appsubscriptionRcp) 和定義新欄位。 進一步瞭解中的結構描述擴充功能 此頁面

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

    note caution
    CAUTION
    請確定 Subscription parameters 標籤與行動應用程式程式碼中的標籤相同。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1