建立和傳送推播通知

在Apple開發人員入口網站中，瀏覽至​ 金鑰。

若要建立金鑰，請選取​ +。

提供​ 金鑰名稱。

選取​ Apple推播通知服務 (APN) ​核取方塊。

選取​ 繼續。

檢閱組態並選取​ 註冊。

下載.p8私密金鑰。 本課程稍後將用於App Surface設定。

記下​ 金鑰識別碼。 它用於App Surface設定。

記下​ 團隊識別碼。 它用於App Surface設定。

從資料收集介面，選取左側面板中的​ 應用程式介面。

若要建立設定，請選取​ 建立應用程式表面。

輸入組態的​ 名稱，例如Luma App Tutorial。

從​ 行動應用程式設定，選取​ Apple iOS。

在​ 應用程式套件ID (iOS套件ID) ​欄位中輸入行動應用程式套件ID。 例如，com.adobe.luma.tutorial.swiftui。

開啟​ 推送認證 ​切換以新增您的認證。

拖放您的.p8 Apple推播通知驗證金鑰 ​檔案。

提供​ 金鑰識別碼，在建立p8驗證金鑰期間指派的10字元字串。 您可以在Apple開發人員入口網站頁面的​ 憑證、識別碼和設定檔 ​頁面的​ 金鑰 ​標籤下找到它。 另請參閱建立私密金鑰。

提供​ 團隊識別碼。 可以在​ 成員資格 ​標籤下或Apple開發人員入口網站頁面頂端找到團隊ID的值。 另請參閱建立私密金鑰。

選取「儲存」。

在資料收集UI中，選取​ 資料串流，然後選取您的資料串流，例如​ Luma Mobile App。

選取​ Experience Platform ​的 ，並從內容功能表選取 編輯。

在​ 資料串流 > > Adobe Experience Platform ​畫面中：

1. 如果尚未選取，請從​ 設定檔資料集 ​中選取​ AJO推播設定檔資料集。 使用MobileCore.setPushIdentifier API呼叫時需要此設定檔資料集（請參閱註冊推播通知的裝置Token），以確保推播通知的唯一識別碼（亦即推播識別碼）會儲存為使用者設定檔的一部分。

2. 已選取​ Adobe Journey Optimizer。 如需詳細資訊，請參閱Adobe Experience Platform設定。

3. 若要儲存您的資料流組態，請選取​ 儲存。

導覽至​ 標籤 > 擴充功能 > 目錄，

開啟您的屬性，例如​ Luma Mobile App Tutorial。

選取​ 目錄。

搜尋​ Adobe Journey Optimizer ​擴充功能。

安裝擴充功能。

在​ 安裝擴充功能 ​對話方塊中

1. 選取環境，例如​ 開發。

2. 從​ 事件資料集 ​清單中選取​ AJO推播追蹤體驗事件資料集 ​資料集。

3. 選取​ 儲存至程式庫並建置。

   

檢閱設定指示區段，將您的模擬器或裝置連線到Assurance。

在Assurance UI中，選取​ 設定。

選取​ 推送偵錯 ​旁的 。

選取「儲存」。

從左側導覽中選取​ 推播偵錯。

選取「驗證安裝程式」標籤。

從​ 使用者端 ​清單中選取您的裝置。

確認您沒有收到任何錯誤。

選取​ 傳送測試推播 ​索引標籤。

（選擇性）變更​ 標題 ​和​ 內文 ​的預設詳細資料

選取 傳送測試推播通知。

檢查​ 測試結果。

您應該會看到測試推播通知出現在應用程式中。

{width="300"}

前往Xcode中的應用程式。

在專案導覽器中選取​ Luma。

選取​ Luma ​目標。

選取「簽署與功能」標籤。

設定​ 自動管理簽署、團隊 ​和​ 套件組合識別碼，或使用您特定的Apple開發佈建詳細資料。

{modal="regular"}

在Xcode中，從​ TARGETS ​清單中選取​ Luma，選取​ 簽署與功能 ​標籤，選取​ +功能 ​按鈕，然後選取​ 推播通知。 這可讓您的應用程式接收推播通知。

接下來，您必須將通知擴充功能新增至應用程式。 返回​ General ​標籤，並選取​ TARGETS ​區段底部的​ + ​圖示。

系統會提示您為新目標選取範本。 選取​ 通知服務延伸模組，然後選取​ 下一步。

在下一個視窗中，使用NotificationExtension作為擴充功能的名稱，然後按一下​ 完成 ​按鈕。

在Xcode中，請確定已將AEP訊息新增至封裝相依性中的封裝清單。 請參閱Swift封裝管理員。

導覽至Xcode專案導覽器中的​ Luma > Luma > AppDelegate。

請確定AEPMessaging是匯入清單的一部分。

import AEPMessaging

請確定Messaging.self是您註冊的擴充功能陣列的一部分。

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

將MobileCore.setPushIdentifier API新增至func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data)函式。

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

此函式擷取安裝應用程式的裝置所獨有的裝置代號。 然後使用您已設定的設定來設定推播通知傳送的代號，該設定依賴Apple的推播通知服務(APN)。

在Journey Optimizer UI中，從左側邊欄選取​ 結構描述。

在索引標籤列中選取​ 瀏覽。

選取您的結構描述，例如​ Luma Mobile App Event Schema ​以開啟它。

在架構編輯器中：

1. 選取​ eventType ​欄位。

2. 在​ 欄位屬性 ​窗格中，向下捲動以檢視事件型別的可能值清單。 選取​ 新增列，並將application.test新增為​ VALUE，並將Test event for push notification新增為DISPLAY NAME。

3. 選取​ 「套用」。

4. 選取「儲存」。

   

在Journey Optimizer UI中，從左側邊欄選取​ 組態。

在​ 儀表板 ​畫面中，選取​ 事件 ​方塊中的​ 管理 ​按鈕。

在​ 事件 ​畫面中，選取​ 建立事件。

在​ 編輯事件event1 ​窗格中：

1. 輸入LumaTestEvent作為事件的​ Name。

2. 提供​ 描述，例如Test event to trigger push notifications in Luma app。

3. 選取您先前在從​ 結構描述 ​清單建立XDM結構描述中建立的行動應用程式體驗事件結構描述，例如​ Luma Mobile App Event Schema v.1。

4. 選取​ 欄位 ​清單旁的 。

   

   在​ 欄位 ​對話方塊中，確定已選取下列欄位(在永遠選取的預設欄位之上（_id、id ​和​ timestamp）。 您可以使用下拉式清單在​ 已選取、全部 ​與​ 主要 ​之間切換，或使用 欄位。

   • 識別的應用程式（識別碼），
   • 事件型別(eventType)，
   • 主要（主要）。

   

   然後選取​ 確定。

5. 選取​ 事件識別碼條件 ​欄位旁的 。

   1. 在​ 新增事件識別碼條件 ​對話方塊中，將​ 事件型別(eventType) ​拖放到​ 將元素拖放到這裡。

   2. 在彈出視窗中，捲動到底部並選取​ application.test （這是您先前新增至事件型別清單的事件型別，作為更新您的結構描述的一部分）。 然後向上捲動到頂端並選取​ 確定。

   3. 選取​ 確定 ​以儲存條件。

      

6. 從​ 名稱空間 ​清單中選取​ ECID (ECID)。 設定檔識別碼 ​欄位自動填入對應identityMap 之索引鍵ECID的第一個專案識別碼。

7. 選取「儲存」。

   

在Journey Optimizer UI中，從左側邊欄選取​ 歷程。

選取​ 建立歷程。

在​ 歷程屬性 ​面板中：

1. 輸入歷程的​ 名稱，例如Luma - Test Push Notification Journey。

2. 輸入歷程的​ 描述，例如Journey for test push notifications in Luma mobile app。

3. 請確定已選取​ 允許重新進入，並將​ 重新進入等待期間 ​設定為​ 30 秒。

4. 選取​ 確定。

   

回到歷程畫布，從​ EVENTS，將 LumaTestEvent ​拖放到畫布上，其中顯示​ 選取進入事件或讀取對象活動。

• 在​ 事件： LumaTestEvent ​面板中，輸入​ 標籤，例如Luma Test Event。

從​ ACTIONS ​下拉式清單中，將 推播 ​拖放到顯示於您​ LumaTestEvent ​活動右側的 上。 在​ 動作：推播 ​窗格中：

1. 提供​ 標籤，例如Luma Test Push Notification，提供​ 描述，例如Test push notification for Luma mobile app，從​ 類別 ​清單中選取​ 異動，並從​ 推播表面 ​中選取​ Luma。

2. 選取 編輯內容 ​以開始編輯實際的推播通知。

   

   在​ 推播通知 ​編輯器中：

   1. 輸入​ 標題，例如Luma Test Push Notification，並輸入​ 內文，例如Test push notification for Luma mobile app。

   2. 您可以選擇在​ 新增媒體 ​中輸入影像(.png或.jpg)的連結。 如果這樣做，影像將成為推播通知的一部分。

   3. 若要儲存並離開編輯器，請選取 。

      

3. 若要儲存並完成推播通知定義，請選取​ 確定。

您的歷程應如下所示。 選取​ Publish ​以發佈並啟用您的歷程。

導覽至Xcode專案導覽器中的​ Luma > Luma > 模型 > XDM > TestPushPayload，並檢查程式碼。

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

程式碼可呈現您要傳送以觸發測試推播通知歷程的下列簡單裝載

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

導覽至Xcode專案導覽器中的​ Luma > Luma > Utils > MobileSDK，並將下列程式碼新增至func sendTestPushEvent(applicationId: String, eventType: String)：

// Create payload and send experience event
Task {
    let testPushPayload = TestPushPayload(
        application: Application(
            id: applicationId
        ),
        eventType: eventType
    )
    // send the final experience event
    await sendExperienceEvent(
        xdm: testPushPayload.asDictionary() ?? [:]
    )
}

此程式碼會使用提供給函式（applicationId和eventType）的引數建立testPushPayload執行個體，然後在將裝載轉換至字典時呼叫sendExperienceEvent。 這次的程式碼也考慮使用Swift根據await和async的並行模型呼叫Adobe Experience Platform SDK的非同步方面。

導覽至Xcode專案導覽器中的​ Luma > Luma > Views > General > ConfigView。 在推播通知按鈕定義中，新增下列程式碼，以傳送測試推播通知體驗事件裝載，以便在點選按鈕時觸發您的歷程。

// Setting parameters and calling function to send push notification
Task {
    let eventType = testPushEventType
    let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found"
    await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType)
}

使用 ，在模擬器中或在Xcode的實體裝置上重建並執行應用程式。

前往​ 設定 ​標籤。

點選​ 推播通知。 您會看到推播通知出現在應用程式中。

{width="300"}