針對 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. 定義​ Label ​和​ Internal 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. 確定透過SDK在Adobe Campaign和應用程式程式碼中定義了相同的​ Integration key

    note note
    NOTE
    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版本 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 ​視窗的​ API version ​下拉式清單中選取​ HTTPV1

  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. 按一下​ Finish,然後再按​ Save。 您的Android應用程式現在已準備好用於Campaign Classic。

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

訊息類型
可設定的訊息元素(FCM裝載名稱)
可設定的選項(FCM裝載名稱)
資料訊息
N/A
validate_only
通知訊息
title,內文, 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