設定推播通知頻道 push-notification-configuration

若要使用Adobe Campaign傳送推播通知,您必須先設定環境和應用程式,如本頁面所述。 在Adobe Campaign中,傳送推播通知的頻道是行動應用程式頻道。

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

開始使用Adobe Campaign傳送推播通知之前,您需要確保行動應用程式上和Adobe Experience Platform中的標籤已具備設定和整合。 Adobe Experience Platform Mobile SDK透過Android和iOS相容的SDK,為您的行動裝置提供使用者端整合API。

若要使用Adobe Experience Platform Mobile SDK設定您的應用程式,請遵循下列步驟:

  1. 檢查必要條件
  2. 在Adobe Experience Platform資料彙集中設定行動標籤屬性
  3. 取得此頁面🔗中詳細的Adobe Experience Platform Mobile SDK 。
  4. (選擇性)啟用記錄與生命週期量度,在此頁面🔗中有詳細的。
  5. (選用)將Adobe Experience Platform保證新增至您的應用程式,以驗證您的實作。 在此頁面🔗瞭解如何實作Adobe Experience Platform保證擴充功能。
  6. 在Adobe Campaign中設定您的iOS和Android Mobile Services,如本頁面🔗所述。
  7. 在您的行動屬性中安裝並設定Adobe Campaign擴充功能
  8. 請依照Adobe Experience Platform Mobile SDK檔案中的指示在您的應用程式中設定Adobe Experience Platform Mobile SDK。

先決條件 before-starting

設定許可權 setup-permissions

建立行動應用程式之前,您必須先確定您擁有或指派適用於Adobe Experience Platform標籤的正確使用者許可權。 Adobe Experience Platform中標籤的使用者許可權會透過Adobe Admin Console指派給使用者。 進一步瞭解標籤檔案

CAUTION
推播設定必須由專家使用者執行。 根據您的實施模式以及此實施中涉及的角色,您可能需要將完整的許可權集指派給單一產品設定檔,或應用程式開發人員與​ Adobe Campaign ​管理員共用許可權。

若要指派​ 屬性 ​和​ 公司 ​許可權,請遵循下列步驟:

  1. 存取​ Admin Console

  2. 從​ Products ​索引標籤中,選取​ Adobe Experience Platform Data Collection ​卡片。

  3. 選取現有​ Product Profile ​或使用​ New profile ​按鈕建立新按鈕。 在Admin Console檔案中瞭解如何建立新的​ New profile

  4. 在​ Permissions ​索引標籤中,選取​ Property Rights

  5. 按一下 Add all。這會將以下許可權新增至您的產品設定檔:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    需要這些許可權才能安裝及發佈Adobe Campaign擴充功能,以及在​ Adobe Experience Platform Mobile SDK ​中發佈應用程式屬性。

  6. 然後在左側功能表中選取​ Company rights

  7. 新增下列許可權:

    • Manage App Configurations
    • Manage Properties

    行動應用程式開發人員需要這些許可權,才能在​ Adobe Experience Platform資料彙集 ​中設定推送認證。

  8. 按一下​ Save

若要將此​ Product profile ​指派給使用者,請遵循下列步驟:

  1. 存取​ Admin Console

  2. 從​ Products ​索引標籤中,選取​ Adobe Experience Platform Data Collection ​卡片。

  3. 選取您先前設定的​ Product profile

  4. Users 索引標籤中,按一下 Add user

  5. 輸入使用者的名稱或電子郵件地址,然後選取使用者。 然後,按一下​ Save

    note note
    NOTE
    如果使用者先前不是在Admin Console中建立的,請參閱新增使用者檔案

設定您的應用程式 configure-app

技術設定涉及應用程式開發人員與企業管理員之間的密切合作。 開始使用Adobe Campaign傳送推播通知之前,您必須在Adobe Experience Platform Data Collection中定義設定,並將行動應用程式與Adobe Experience Platform Mobile SDK整合。

請依照下列連結中詳述的實作步驟操作:

  • 針對​ Apple iOS:在Apple檔案中瞭解如何使用APN註冊您的應用程式
  • 針對​ Google Android:在Google檔案中瞭解如何在Android上設定Firebase Cloud Messaging使用者端應用程式

在Adobe Experience Platform資料彙集中設定行動標籤屬性 launch-property

設定行動屬性可讓行動應用程式開發人員或行銷人員設定行動SDK。 您通常會為想要管理的每個行動應用程式建立行動屬性。 在Adobe Experience Platform Mobile SDK檔案中瞭解如何建立及設定行動屬性。

Adobe Experience Platform檔案中進一步瞭解Adobe Experience Platform Data Collection標籤。

建立後,請開啟新標籤屬性並建立程式庫。 操作步驟:

  1. 在左側導覽中瀏覽至​ 發佈流程,並選取​ 新增資料庫
  2. 輸入程式庫名稱並選取環境。
  3. 選取​ 新增所有變更的資源,以及​ 儲存並建置至開發
  4. 最後,從​ 選取工作程式庫 ​按鈕將此程式庫設定為您的工作程式庫。

在Campaign中設定行動服務 push-service

在Adobe Experience Platform Data Collection中設定您的行動應用程式後,您需要建立兩個服務(一個用於iOS裝置,一個用於Android裝置)才能從​ Adobe Campaign ​傳送推播通知。

推播通知會透過專用服務傳送給您的應用程式使用者。 使用者安裝您的應用程式時,會訂閱此服務: Adobe Campaign仰賴此服務,僅鎖定您應用程式的訂閱者。 在此服務中,您需要新增iOS和Android應用程式,以在iOS和Android裝置上傳送。

若要建立服務以傳送推播通知,請遵循下列步驟:

  1. 瀏覽至​ Profiles and Targets > Services and Subscriptions ​標籤,然後按一下​ Create

    {width="800"}

  2. 輸入​ Label ​和​ Internal name,然後選取​ Mobile application ​型別。

    note note
    NOTE
    預設​ Subscriber applications (nms:appSubscriptionRcp) ​目標對應已連結至收件者表格。 如果您想使用不同的目標對應,則需要建立新的目標對應,並在服務的​ Target mapping ​欄位中輸入它。 在此頁面中進一步瞭解目標對應。
  3. 然後使用右側的​ Add ​圖示來定義使用此服務的行動應用程式。

iOS

若要為iOS裝置建立應用程式,請遵循下列步驟:

  1. 選取 Create an iOS application 並按一下 Next

    {width="600"}

  2. 在​ Label ​欄位中輸入您的應用程式名稱。

  3. (選擇性)您可以使用約​ Application variables ​擴充推送訊息內容。 這些都是可完全自訂的專案,而且是傳送至行動裝置的訊息裝載的一部分。

    在下列範例中,已新增​ mediaURl ​和​ mediaExt ​變數來建立豐富推播通知,然後為應用程式提供要在通知內顯示的影像。

    {width="600"}

  4. 瀏覽至​ Subscription parameters ​標籤以定義具有​ Subscriber applications (nms:appsubscriptionRcp) ​結構描述副檔名的對應。

  5. 瀏覽至​ Sounds ​索引標籤以定義要播放的聲音。 按一下​ Add ​並填入​ Internal name ​欄位,欄位必須包含內嵌於應用程式中的檔案名稱或系統聲音名稱。

  6. 按一下​ Next ​開始設定開發應用程式。

  7. 整合金鑰是每個應用程式專屬的。 這會將行動應用程式連結至Adobe Campaign。

    請確定透過SDK在Adobe Campaign和應用程式程式碼中定義了相同的​ Integration key

    深入瞭解開發人員檔案

    note note
    NOTE
    Integration key ​可使用字串值完全自訂,但必須與SDK中指定的完全相同。
    您不能對應用程式的開發版本(沙箱)和生產版本使用相同的憑證。
  8. 從​ Application icon ​欄位中選取圖示,以個人化您服務中的行動應用程式。

  9. 選取 Authentication mode。提供兩種模式:

    • (建議) Token-based authentication:填入APNs連線設定​ Key IdTeam Id ​和​ Bundle Id,然後按一下​ Enter the private key… ​以選取您的p8憑證。 如需​ Token-based authentication ​的詳細資訊,請參閱Apple檔案

    • Certificate-based authentication:按一下​ Enter the certificate…,然後選取您的p12金鑰並輸入行動應用程式開發人員提供的密碼。 請注意,此憑證有到期日,必須每年更新。 為避免使用者的服務中斷,請在憑證過期前更新憑證。 憑證的有效期為一年,您必須更新憑證才能繼續與APN通訊。

  10. 使用​ Test the connection ​按鈕驗證您的設定。

  11. 按一下​ Next ​開始設定生產應用程式,並依照上述步驟執行。

  12. 按一下​ Finish

您的iOS應用程式現在已準備好在Campaign中使用。

Android

若要為Android裝置建立應用程式,請遵循下列步驟:

  1. 選取 Create an Android application 並按一下 Next

    {width="600"}

  2. 在​ Label ​欄位中輸入您的應用程式名稱。

  3. 整合金鑰是每個應用程式專屬的。 這會將行動應用程式連結至Adobe Campaign。

    請確定透過SDK在Adobe Campaign和應用程式程式碼中定義了相同的​ Integration key

    深入瞭解開發人員檔案

    note note
    NOTE
    Integration key ​可使用字串值完全自訂,但必須與SDK中指定的完全相同。
  4. 從​ Application icon ​欄位中選取圖示,以個人化您服務中的行動應用程式。

  5. 在​ API version ​下拉式清單中選取​ HTTP v1

  6. 按一下​ Load project json file to extract project details… ​連結以載入您的JSON金鑰檔案。 如需有關如何解壓縮JSON檔案的詳細資訊,請參閱Google Firebase檔案

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

    • Project Id
    • Private Key
    • Client Email
  7. 使用​ Test the connection ​按鈕驗證您的設定。

    note caution
    CAUTION
    Test connection ​按鈕不會檢查MID伺服器是否可存取FCM伺服器。
  8. (選擇性)如有需要,您可以使用約​ Application variables ​擴充推送訊息內容。 這些都是可完全自訂的專案,而且是傳送至行動裝置的訊息裝載的一部分。

  9. 按一下​ Finish,然後再按​ Save。 您的Android應用程式現在已準備好在Campaign中使用。

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

table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
訊息類型 可設定的訊息元素(FCM裝載名稱) 可設定的選項(FCM裝載名稱)
資料訊息 N/A validate_only
通知訊息 title,內文, android_channel_id,圖示,聲音,標籤,顏色,點按動作,影像,提示,粘性,可見度,通知優先順序,通知計數 validate_only

在您的行動屬性中設定Adobe Campaign擴充功能 configure-extension

適用於Adobe Experience Platform Mobile SDK的​ Adobe Campaign Classic擴充功能 ​可支援行動應用程式的推播通知,並可協助您收集使用者推播權杖,並管理與Adobe Experience Platform服務的互動測量。

此擴充功能適用於Campaign Classic v7和Campaign v8,已預先安裝在您的環境中,且必須加以設定。 若要設定行動標籤屬性的擴充功能,請遵循下列步驟:

  1. 開啟您之前建立的標籤屬性。
  2. 從左側導覽列瀏覽至​ 擴充功能,然後開啟​ 目錄 ​標籤。 使用搜尋欄位來尋找​ Adobe Campaign Classic ​擴充功能。
  3. 從Campaign Classic卡中,按一下​ 安裝 ​按鈕。
  4. Adobe Experience Platform Mobile SDK檔案中所述,輸入設定。

Adobe Experience Platform Mobile SDK檔案所詳述,您現在可將Campaign新增至您的應用程式。

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b