建立和傳送推播通知

下列步驟並非特定於Adobe Experience Cloud，而是旨在引導您完成APN設定。

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

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

   {modal="regular"}

3. 提供​ 金鑰名稱。

4. 選取​ Apple推播通知服務 (APN)，然後選取​ 設定。

   1. 在​ 設定索引鍵 ​畫面中，從​ 環境 ​下拉式選單中選取​ 沙箱與生產。
   2. 選取「儲存」。

5. 選取​ 繼續。

   {modal="regular"}

6. 檢閱組態並選取​ 註冊。

7. 下載.p8私密金鑰。 當您設定Journey Optimizer推送認證時，它將在下一個練習中使用。

8. 記下​ 金鑰識別碼。 當您設定Journey Optimizer推送認證時，它將在下一個練習中使用。

9. 記下​ 團隊識別碼。 當您設定Journey Optimizer推送認證時，它將在下一個練習中使用。 團隊ID可在畫面右上角找到，位於您的登入名稱旁。
   {modal="regular"}

其他檔案可在此處找到。

下列步驟並非特定於Adobe Experience Cloud，而是設計用來引導您完成Firebase設定。

1. 存取Firebase主控台。

2. 選取​ 建立Firebase專案。

   1. 輸入​ 專案名稱。
   2. 在​ 建立專案 ​中選取​ 繼續 - 讓我們以您專案的名稱 ​開始。 例如, Luma Android App.
   3. 停用Firebase中的​ Gemini，並在​ 建立專案 ​中選取​ 繼續 - 您的Firebase專案的AI協助。
   4. 停用此專案的​ Google Analytics，並選取​ 為您的Firebase專案建立專案 - Google Analytics ​中的​ 繼續。
   5. 選取​ 建立專案。
   6. 專案準備就緒後，選取​ 繼續。

3. 返回Firebase主控台，確定您的專案已選取在頂端。 例如，Luma Android App。

   {modal="regular"}

4. 選取 > 專案設定。

5. 在​ 專案設定 ​中，選取​ 新增應用程式。

   1. 在​ 將Firebase新增至您的應用程式 ​中，選取​ Android ​作為平台。

   2. 在​ 將Firebase新增至您的Android應用程式中：

      1. 在步驟1，註冊應用程式：

         1. 輸入Android套件名稱，類似於應用程式識別碼。 例如 com.adobe.luma.tutorial.android。
         2. 輸入選用的​ 應用程式暱稱。
         3. 選取​ 註冊應用程式。

      2. 在步驟2中，下載然後新增設定檔。

         1. 選取 下載google-services.json。 當您建置您自己的Android應用程式版本時，您應該將範例Android Studio專案中目前的google-services.json檔案取代為此新應用程式設定產生的檔案版本。
            已在範例應用程式中注意其他步驟。

   您的畫面應如下所示：

   {modal="regular"}

6. 在​ 專案設定 ​中，選取​ 服務帳戶。

7. 選取​ 產生新的私密金鑰。 已產生luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json檔案。 將此檔案儲存在安全的地方，因為您稍後需要檔案。

如需詳細資訊，請參閱Firebase開發人員檔案。

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

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

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

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

現在，您應該會在應用程式中新增推播通知擴充功能，類似於下列畫面。

{modal="regular"}

Android Studio專案已設定為推送通知。 您不需要執行額外的步驟，即可啟用Android版本的Luma應用程式以使用推播通知。 如需詳細資訊，請參閱關於通知。

Android推播通知需要您在應用程式中及傳送推播通知時，定義通知通道id。 Android Luma應用程式中使用的管道通知ID為LUMA_CHANNEL ID。

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

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

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

   import AEPMessaging

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

   code language-swift
   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 ]

1. 在Android Studio中，確定aepsdk-messing-android是​ Android:app ChevronDown ​ ​Gradle指令碼 build.gradle.kts （模組​ ） ​的相依性的一部分。 請參閱Gradle。

2. 在Android Studio專案導覽器中，導覽至​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

3. 請確定com.adobe.marketing.mobile.Messaging是匯入清單的一部分。

   import import com.adobe.marketing.mobile.Messaging

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

   code language-kotlin
   val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )

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

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

   code language-swift
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(deviceToken)

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

1. 在Android Studio專案導覽器中，導覽至​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

2. 將MobileCore.setPushIdentifier API新增至override fun onCreate()中class LumaAplication : Application的FirebaseMessaging.getInstance().token.addOnCompleteListener函式。

   code language-kotlin
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(token)

   此函式擷取安裝應用程式的裝置所獨有的裝置代號。 然後，使用您已設定的且依賴Firebase雲端通訊(FCM)的設定，設定推播通知傳送的代號。

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

   code language-swift
   import Foundation // MARK: - TestPush struct TestPushPayload: Codable { let application: Application let eventType: String } // MARK: - Application struct Application: Codable { let id: String }

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

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

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

   code language-swift
   // 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() ?? [:] ) }

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

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

   code language-swift
   // 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) }

1. 在Android Studio導覽器中導覽至​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt，並檢查程式碼。

   code language-kotlin

   import com.google.gson.annotations.SerializedName data class TestPushPayload( @SerializedName("application") val application: Application, @SerializedName("eventType") val eventType: String ) { fun asMap(): Map<String, Any> { return mapOf( "application" to application.asMap(), "eventType" to eventType ) } } data class Application( @SerializedName("id") val id: String ) { fun asMap(): Map<String, Any> { return mapOf( "id" to id ) } }

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

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. 導覽至Android Studio導覽器中的​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > 模型 > MobileSDK，並將下列程式碼新增至func sendTestPushEvent(applicationId: String, eventType: String)：

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   此程式碼會使用提供給函式（testPushPayload和applicationId）的引數建立eventType執行個體，然後在將裝載轉換為對應時呼叫sendExperienceEvent。

3. 在Android Studio導覽器中，導覽至​ Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt。 在推播通知按鈕定義中，新增下列程式碼，以傳送測試推播通知體驗事件裝載，以便在點選按鈕時觸發您的歷程。

   code language-kotlin
   // Setting parameters and calling function to send push notification val eventType = testPushEventType val applicationId = context.packageName scope.launch { MobileSDK.shared.sendTestPushEvent( applicationId, eventType ) }

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

2. 前往​ 設定 ​標籤。

3. 點選​ 推播通知。

   您會看到推播通知出現在應用程式頂端。

   {width="300"}

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

2. 前往​ 設定 ​標籤。

3. 點選​ 推播通知。

   您會看到推播通知出現在應用程式頂端。

   {width="300"}