設定推播通知頻道 push-notification-configuration
若要使用Adobe Campaign傳送推播通知,您必須先設定環境和應用程式,如本頁面所述。 在Adobe Campaign中,傳送推播通知的頻道是行動應用程式頻道。
開始使用Adobe Campaign傳送推播通知之前,您需要確保行動應用程式上和Adobe Experience Platform中的標籤已具備設定和整合。 Adobe Experience Platform Mobile SDK透過Android和iOS相容的SDK,為您的行動裝置提供使用者端整合API。
若要使用Adobe Experience Platform Mobile SDK設定您的應用程式,請遵循下列步驟:
- 檢查必要條件。
- 在Adobe Experience Platform資料彙集中設定行動標籤屬性。
- 取得此頁面🔗中詳細的Adobe Experience Platform Mobile SDK 。
- (選擇性)啟用記錄與生命週期量度,在此頁面🔗中有詳細的。
- (選用)將Adobe Experience Platform保證新增至您的應用程式,以驗證您的實作。 在此頁面🔗瞭解如何實作Adobe Experience Platform保證擴充功能。
- 在Adobe Campaign中設定您的iOS和Android Mobile Services,如本頁面🔗所述。
- 在您的行動屬性中安裝並設定Adobe Campaign擴充功能。
- 請依照Adobe Experience Platform Mobile SDK檔案中的指示在您的應用程式中設定Adobe Experience Platform Mobile SDK。
先決條件 before-starting
設定許可權 setup-permissions
建立行動應用程式之前,您必須先確定您擁有或指派適用於Adobe Experience Platform標籤的正確使用者許可權。 Adobe Experience Platform中標籤的使用者許可權會透過Adobe Admin Console指派給使用者。 進一步瞭解標籤檔案。
若要指派 屬性 和 公司 許可權,請遵循下列步驟:
-
存取 Admin Console。
-
從 Products 索引標籤中,選取 Adobe Experience Platform Data Collection 卡片。
-
選取現有 Product Profile 或使用 New profile 按鈕建立新按鈕。 在Admin Console檔案中瞭解如何建立新的 New profile。
-
在 Permissions 索引標籤中,選取 Property Rights。
-
按一下 Add all。這會將以下許可權新增至您的產品設定檔:
- Approve
- Develop
- Edit Property
- Manage Environments
- Manage Extensions
- Publish
需要這些許可權才能安裝及發佈Adobe Campaign擴充功能,以及在 Adobe Experience Platform Mobile SDK 中發佈應用程式屬性。
-
然後在左側功能表中選取 Company rights。
-
新增下列許可權:
- Manage App Configurations
- Manage Properties
行動應用程式開發人員需要這些許可權,才能在 Adobe Experience Platform資料彙集 中設定推送認證。
-
按一下 Save。
若要將此 Product profile 指派給使用者,請遵循下列步驟:
-
存取 Admin Console。
-
從 Products 索引標籤中,選取 Adobe Experience Platform Data Collection 卡片。
-
選取您先前設定的 Product profile。
-
在 Users 索引標籤中,按一下 Add user。
-
輸入使用者的名稱或電子郵件地址,然後選取使用者。 然後,按一下 Save。
note note NOTE 如果使用者先前不是在Admin Console中建立的,請參閱新增使用者檔案。
設定您的應用程式 configure-app
技術設定涉及應用程式開發人員與企業管理員之間的密切合作。 開始使用Adobe Campaign傳送推播通知之前,您必須在Adobe Experience Platform Data Collection中定義設定,並將行動應用程式與Adobe Experience Platform Mobile SDK整合。
請依照下列連結中詳述的實作步驟操作:
在Adobe Experience Platform資料彙集中設定行動標籤屬性 launch-property
設定行動屬性可讓行動應用程式開發人員或行銷人員設定行動SDK。 您通常會為想要管理的每個行動應用程式建立行動屬性。 在Adobe Experience Platform Mobile SDK檔案中瞭解如何建立及設定行動屬性。
在Adobe Experience Platform檔案中進一步瞭解Adobe Experience Platform Data Collection標籤。
建立後,請開啟新標籤屬性並建立程式庫。 操作步驟:
- 在左側導覽中瀏覽至 發佈流程,並選取 新增資料庫。
- 輸入程式庫名稱並選取環境。
- 選取 新增所有變更的資源,以及 儲存並建置至開發。
- 最後,從 選取工作程式庫 按鈕將此程式庫設定為您的工作程式庫。
在Campaign中設定行動服務 push-service
在Adobe Experience Platform Data Collection中設定您的行動應用程式後,您需要建立兩個服務(一個用於iOS裝置,一個用於Android裝置)才能從 Adobe Campaign 傳送推播通知。
推播通知會透過專用服務傳送給您的應用程式使用者。 使用者安裝您的應用程式時,會訂閱此服務: Adobe Campaign仰賴此服務,僅鎖定您應用程式的訂閱者。 在此服務中,您需要新增iOS和Android應用程式,以在iOS和Android裝置上傳送。
若要建立服務以傳送推播通知,請遵循下列步驟:
-
瀏覽至 Profiles and Targets > Services and Subscriptions 標籤,然後按一下 Create。
{width="800"}
-
輸入 Label 和 Internal name,然後選取 Mobile application 型別。
note note NOTE 預設 Subscriber applications (nms:appSubscriptionRcp) 目標對應已連結至收件者表格。 如果您想使用不同的目標對應,則需要建立新的目標對應,並在服務的 Target mapping 欄位中輸入它。 在此頁面中進一步瞭解目標對應。 -
然後使用右側的 Add 圖示來定義使用此服務的行動應用程式。
若要為iOS裝置建立應用程式,請遵循下列步驟:
-
選取 Create an iOS application 並按一下 Next。
{width="600"}
-
在 Label 欄位中輸入您的應用程式名稱。
-
(選擇性)您可以使用約 Application variables 擴充推送訊息內容。 這些都是可完全自訂的專案,而且是傳送至行動裝置的訊息裝載的一部分。
在下列範例中,已新增 mediaURl 和 mediaExt 變數來建立豐富推播通知,然後為應用程式提供要在通知內顯示的影像。
{width="600"}
-
瀏覽至 Subscription parameters 標籤以定義具有 Subscriber applications (nms:appsubscriptionRcp) 結構描述副檔名的對應。
-
瀏覽至 Sounds 索引標籤以定義要播放的聲音。 按一下 Add 並填入 Internal name 欄位,欄位必須包含內嵌於應用程式中的檔案名稱或系統聲音名稱。
-
按一下 Next 開始設定開發應用程式。
-
整合金鑰是每個應用程式專屬的。 這會將行動應用程式連結至Adobe Campaign。
請確定透過SDK在Adobe Campaign和應用程式程式碼中定義了相同的 Integration key。
深入瞭解開發人員檔案
note note NOTE Integration key 可使用字串值完全自訂,但必須與SDK中指定的完全相同。 您不能對應用程式的開發版本(沙箱)和生產版本使用相同的憑證。 -
從 Application icon 欄位中選取圖示,以個人化您服務中的行動應用程式。
-
選取 Authentication mode。提供兩種模式:
-
(建議) Token-based authentication:填入APNs連線設定 Key Id、Team Id 和 Bundle Id,然後按一下 Enter the private key… 以選取您的p8憑證。 如需 Token-based authentication 的詳細資訊,請參閱Apple檔案。
-
Certificate-based authentication:按一下 Enter the certificate…,然後選取您的p12金鑰並輸入行動應用程式開發人員提供的密碼。 請注意,此憑證有到期日,必須每年更新。 為避免使用者的服務中斷,請在憑證過期前更新憑證。 憑證的有效期為一年,您必須更新憑證才能繼續與APN通訊。
-
-
使用 Test the connection 按鈕驗證您的設定。
-
按一下 Next 開始設定生產應用程式,並依照上述步驟執行。
-
按一下 Finish。
您的iOS應用程式現在已準備好在Campaign中使用。
若要為Android裝置建立應用程式,請遵循下列步驟:
-
選取 Create an Android application 並按一下 Next。
{width="600"}
-
在 Label 欄位中輸入您的應用程式名稱。
-
整合金鑰是每個應用程式專屬的。 這會將行動應用程式連結至Adobe Campaign。
請確定透過SDK在Adobe Campaign和應用程式程式碼中定義了相同的 Integration key。
深入瞭解開發人員檔案
note note NOTE Integration key 可使用字串值完全自訂,但必須與SDK中指定的完全相同。 -
從 Application icon 欄位中選取圖示,以個人化您服務中的行動應用程式。
-
在 API version 下拉式清單中選取 HTTP v1。
-
按一下 Load project json file to extract project details… 連結以載入您的JSON金鑰檔案。 如需有關如何解壓縮JSON檔案的詳細資訊,請參閱Google Firebase檔案。
您也可以手動輸入下列明細:
- Project Id
- Private Key
- Client Email
-
使用 Test the connection 按鈕驗證您的設定。
note caution CAUTION Test connection 按鈕不會檢查MID伺服器是否可存取FCM伺服器。 -
(選擇性)如有需要,您可以使用約 Application variables 擴充推送訊息內容。 這些都是可完全自訂的專案,而且是傳送至行動裝置的訊息裝載的一部分。
-
按一下 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,已預先安裝在您的環境中,且必須加以設定。 若要設定行動標籤屬性的擴充功能,請遵循下列步驟:
- 開啟您之前建立的標籤屬性。
- 從左側導覽列瀏覽至 擴充功能,然後開啟 目錄 標籤。 使用搜尋欄位來尋找 Adobe Campaign Classic 擴充功能。
- 從Campaign Classic卡中,按一下 安裝 按鈕。
- 如Adobe Experience Platform Mobile SDK檔案中所述,輸入設定。
如Adobe Experience Platform Mobile SDK檔案所詳述,您現在可將Campaign新增至您的應用程式。