Skapa och skicka push-meddelanden

Följande steg är inte Adobe Experience Cloud-specifika och har utformats för att vägleda dig genom APN-konfigurationen.

1. Gå till Keys på Apple utvecklarportal.

2. Välj + om du vill skapa en nyckel.

   {modal="regular"}

3. Ange en Key Name.

4. Välj Apple Push Notification service (APN:er) och välj Configure.

   1. Välj Configure Key i listrutan Sandbox & Production på skärmen Environment.
   2. Välj Save.

5. Välj Continue.

   {modal="regular"}

6. Granska konfigurationen och välj Register.

7. Hämta den privata nyckeln .p8. Den används i nästa övning när du konfigurerar push-autentiseringsuppgifter för Journey Optimizer.

8. Notera Key ID. Den används i nästa övning när du konfigurerar push-autentiseringsuppgifter för Journey Optimizer.

9. Notera Team ID. Den används i nästa övning när du konfigurerar push-autentiseringsuppgifter för Journey Optimizer. Team-ID:t finns uppe till höger på skärmen bredvid ditt inloggningsnamn.
   {modal="regular"}

Ytterligare dokumentation finns här.

Följande steg är inte Adobe Experience Cloud-specifika och har utformats för att vägleda dig genom Firebase-konfigurationen.

1. Gå till Firebase-konsolen.

2. Välj Create a Firebase project.

   1. Ange en Project name.
   2. Välj Continue i Create a project - Let’s start with a name for your project. Exempel: Luma Android App.
   3. Inaktivera Gemini in Firebase och välj Continue i Create a project - AI assistance for your Firebase project.
   4. Inaktivera Google Analytics for this project och välj Continue i Create a project - Google Analytics for your Firebase project.
   5. Välj Create Project.
   6. När projektet är klart väljer du Continue.

3. Gå tillbaka till Firebase-konsolen och se till att ditt projekt är markerat längst upp. Exempel: Luma Android App.

   {modal="regular"}

4. Välj > Project Settings.

5. I Project settings väljer du Add app.

   1. I Add Firebase to your app väljer du Android som plattform.

   2. I Add Firebase to your Android app:

      1. I steg 1, Register app:

         1. Ange ett namn på ett Android-paket som liknar din programidentifierare. Exempel: com.adobe.luma.tutorial.android.
         2. Ange ett valfritt App nickname.
         3. Välj Register app.

      2. I steg 2, Download and then add config file.

         1. Välj Download google-services.json. När du skapar en egen version av Android-appen bör du ersätta den aktuella google-services.json-filen i Android Studio-exempelprojektet med den version av filen som genereras av den nya appkonfigurationen.
            De andra stegen hanteras redan i exempelappen.

   Skärmen ska se ut så här:

   {modal="regular"}

6. I Project Settings väljer du Service accounts.

7. Välj Generate new private key. En luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json-fil genereras. Spara filen på en säker plats när du behöver den i ett senare skede.

Mer information finns i dokumentationen för Firebase-utvecklare.

1. I Xcode väljer du Luma i listan TARGETS, väljer fliken Signing & Capabilities, klickar på knappen + Capability och väljer sedan Push Notifications. Med det här alternativet kan din app ta emot push-meddelanden.

2. Sedan måste du lägga till ett meddelandetillägg i programmet. Gå tillbaka till fliken General och välj ikonen + längst ned i avsnittet TARGETS.

3. Du uppmanas att välja en mall för det nya målet. Välj Notification Service Extension och sedan Next.

4. I nästa fönster använder du NotificationExtension som namn på tillägget och klickar på knappen Finish.

Du bör nu ha ett tillägg för push-meddelanden tillagt i appen, som liknar skärmen nedan.

{modal="regular"}

Android Studio-projektet har redan konfigurerats för push-meddelanden. Du behöver inte vidta ytterligare åtgärder för att aktivera Android-versionen av Luma-appen för push-meddelanden. Mer information finns i Om meddelanden.

Android push-meddelanden kräver att du definierar ett ID för en meddelandekanal, både i din app och när du skickar ett push-meddelande. Det kanalmeddelande-ID som används i Android Luma-appen är LUMA_CHANNEL ID.

1. Kontrollera att AEP Messaging har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.

2. Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

3. Se till att AEPMessaging ingår i din lista över importer.

   import AEPMessaging

4. Kontrollera att Messaging.self är en del av den array med tillägg som du registrerar.

   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. I Android Studio kontrollerar du att aepsdk-messing-android är en del av beroendena i build.gradle.kts (Module :app) i Android Gradle Scripts. Se Gradle.

2. Navigera till Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication i projektnavigeraren i Android Studio.

3. Se till att com.adobe.marketing.mobile.Messaging ingår i din lista över importer.

   import import com.adobe.marketing.mobile.Messaging

4. Kontrollera att Messaging.EXTENSION är en del av den array med tillägg som du registrerar.

   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. Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

2. Lägg till API:t MobileCore.setPushIdentifier i funktionen func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

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

   Den här funktionen hämtar enhetstoken som är unik för den enhet som appen är installerad på. Ställer sedan in token för leverans av push-meddelanden med den konfiguration som du har konfigurerat och som är beroende av Apple Push Notification-tjänst (APN:er).

1. Navigera till Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication i projektnavigeraren i Android Studio.

2. Lägg till API:t MobileCore.setPushIdentifier i funktionen override fun onCreate() i class LumaAplication : Application, i FirebaseMessaging.getInstance().token.addOnCompleteListener.

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

   Den här funktionen hämtar enhetstoken som är unik för den enhet som appen är installerad på. Ställer sedan in token för leverans av push-meddelanden med den konfiguration som du har konfigurerat och som är beroende av FCM (Firebase Cloud Messaging).

1. Navigera till Luma > Luma > Model > XDM > TestPushPayload i Xcode Project-navigatorn och kontrollera koden.

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

   Koden är en representation av följande enkla nyttolast som du ska skicka för att utlösa testresan för push-meddelanden.

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

2. Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project-navigatorn och lägg till följande kod i 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() ?? [:] ) }

   Den här koden skapar en testPushPayload-instans med de parametrar som har angetts för funktionen (applicationId och eventType) och anropar sedan sendExperienceEvent när nyttolasten konverteras till ett lexikon. Den här koden tar också hänsyn till asynkrona aspekter av att anropa Adobe Experience Platform SDK genom att använda Swift-modellen för samtidighet, baserat på await och async.

3. Navigera till Luma > Luma > Views > General > ConfigView i Xcode Project-navigatorn. I definitionen för knappen Push Notification (Push-meddelande) lägger du till följande kod för att skicka händelsenyttolasten för testpush-meddelanden för att utlösa din resa när användaren trycker på knappen.

   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. Navigera till Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt i Android Studio-navigatorn och kontrollera koden.

   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 ) } }

   Koden är en representation av följande enkla nyttolast som du ska skicka för att utlösa testresan för push-meddelanden.

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

2. Navigera till Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK i Android Studio-navigatorn och lägg till följande kod i func sendTestPushEvent(applicationId: String, eventType: String):

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

   Den här koden skapar en testPushPayload-instans med de parametrar som har angetts för funktionen (applicationId och eventType) och anropar sedan sendExperienceEvent när nyttolasten konverteras till en karta.

3. Navigera till Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt i Android Studio-navigatorn. I definitionen för knappen Push Notification (Push-meddelande) lägger du till följande kod för att skicka händelsenyttolasten för testpush-meddelanden för att utlösa din resa när användaren trycker på knappen.

   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. Återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med .

2. Gå till fliken Settings.

3. Tryck på Push Notification.

   Push-meddelandet visas ovanpå appen.

   {width="300"}

1. Återskapa och kör appen i simulatorn eller på en fysisk enhet från Android Studio med .

2. Gå till fliken Settings.

3. Tryck på Push Notification.

   Push-meddelandet visas ovanpå appen.

   {width="300"}