Erstellen und Versenden von Push-Benachrichtigungen

Die folgenden Schritte sind nicht Adobe Experience Cloud-spezifisch und sollen Sie durch die APNs-Konfiguration führen.

1. Navigieren Sie im Apple-Entwicklerportal zu Keys.

2. Um einen Schlüssel zu erstellen, wählen Sie + aus.

   {modal="regular"}

3. Geben Sie einen Schlüsselnamen“.

4. Wählen Sie Apple Push Notification Service (APNs) und wählen Sie Konfigurieren.

   1. Wählen Sie auf dem Schlüssel konfigurieren die Option Sandbox und) aus dem Dropdown-Menü Umgebung aus.
   2. Wählen Sie Speichern aus.

5. Wählen Sie Weiter aus.

   {modal="regular"}

6. Überprüfen Sie die Konfiguration und wählen Sie Registrieren.

7. Laden Sie den privaten .p8-Schlüssel herunter. Er wird in der nächsten Übung verwendet, wenn Sie Ihre Journey Optimizer-Push-Anmeldedaten konfigurieren.

8. Notieren Sie sich die Schlüssel-ID. Er wird in der nächsten Übung verwendet, wenn Sie Ihre Journey Optimizer-Push-Anmeldedaten konfigurieren.

9. Notieren Sie sich die Team ID. Er wird in der nächsten Übung verwendet, wenn Sie Ihre Journey Optimizer-Push-Anmeldedaten konfigurieren. Die Team-ID finden Sie oben rechts auf dem Bildschirm neben Ihrem Anmeldenamen.
   {modal="regular"}

Weitere Dokumentationen finden Sie hier.

Die folgenden Schritte sind nicht Adobe Experience Cloud-spezifisch und sollen Sie durch die Firebase-Konfiguration führen.

1. Zugriff auf die Firebase-Konsole.

2. Wählen Sie Erstellen eines Firebase-Projekts.

   1. Geben Sie einen Projektnamen ein.
   2. Wählen Sie Fortfahren in Projekt erstellen - Beginnen wir mit einem Namen für Ihr Projekt. Beispiel: Luma Android App.
   3. Deaktivieren Sie Gemini in Firebase und wählen Sie Weiter in Projekt erstellen - KI-Unterstützung für Ihr Firebase-Projekt.
   4. Deaktivieren Sie Google Analytics für Projekt und wählen Sie Weiter in Projekt erstellen - Google Analytics für Ihr Firebase-Projekt.
   5. Wählen Sie Projekt erstellen aus.
   6. Wenn das Projekt fertig ist, wählen Sie Weiter aus.

3. Stellen Sie in der Firebase-Konsole sicher, dass Ihr Projekt oben ausgewählt ist. Beispiel: Luma Android App.

   {modal="regular"}

4. Wählen Sie > Projekteinstellungen aus.

5. Wählen in Projekteinstellungen“ App hinzufügen aus.

   1. Wählen in „Firebase zu Ihrer App hinzufügen Android als Plattform aus.

   2. Im Firebase zu Ihrer Android-App hinzufügen:

      1. In Schritt 1, App registrieren:

         1. Geben Sie einen Android-Paketnamen ein, ähnlich Ihrer App-Kennung. Beispiel: com.adobe.luma.tutorial.android.
         2. Geben Sie einen optionalen App-Spitznamen ein.
         3. Wählen Sie App registrieren aus.

      2. In Schritt 2, Herunterladen und dann Konfigurationsdatei hinzufügen.

         1. Wählen Sie Download google-services.json aus. Wenn Sie Ihre eigene Version der Android-App erstellen, sollten Sie die aktuelle google-services.json im Android Studio-Beispielprojekt durch die Version der Datei ersetzen, die von dieser neuen App-Konfiguration generiert wird.
            Die anderen Schritte werden bereits in der Beispiel-App durchgeführt.

   Ihr Bildschirm sollte wie folgt aussehen:

   {modal="regular"}

6. Wählen in Projekteinstellungen“ Service-Konten aus.

7. Wählen Sie Neuen privaten Schlüssel generieren aus. Es wird eine luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json-Datei generiert. Bewahren Sie diese Datei an einem sicheren Ort auf, da Sie die Datei zu einem späteren Zeitpunkt benötigen.

Weitere Informationen finden Sie in der Firebase Developer-.

1. Wählen Sie in Xcode Luma aus der Liste TARGETS, wählen Sie die Registerkarte Signierung und Funktionen aus, klicken Sie auf die Schaltfläche + Funktion und klicken Sie dann auf Push-Benachrichtigungen. Mit dieser Auswahl kann Ihre App Push-Benachrichtigungen erhalten.

2. Als Nächstes müssen Sie der App eine Benachrichtigungserweiterung hinzufügen. Gehen Sie zurück zur Registerkarte "General" und wählen Sie unten im Abschnitt „ZIELE das Symbol+​ aus.

3. Sie werden aufgefordert, die Vorlage für Ihre neue Zielgruppe auszuwählen. Wählen Sie Erweiterung für den Benachrichtigungsdienst und dann Weiter aus.

4. Verwenden Sie im nächsten Fenster NotificationExtension als Namen der Erweiterung und klicken Sie auf die Schaltfläche Beenden.

Ihrer App sollte jetzt eine Push-Benachrichtigungs-Erweiterung hinzugefügt werden, ähnlich wie im folgenden Bildschirm.

{modal="regular"}

Das Android Studio-Projekt ist bereits für Push-Benachrichtigungen eingerichtet. Sie müssen keine zusätzlichen Schritte ausführen, um die Android-Version der Luma-App für Push-Benachrichtigungen zu aktivieren. Weitere Informationen finden unterÜber Benachrichtigungen“.

Android-Push-Benachrichtigungen erfordern, dass Sie eine Benachrichtigungskanal-ID definieren, sowohl in Ihrer Mobile App als auch beim Senden einer Push-Benachrichtigung. Die in der Android Luma-App verwendete Kanalbenachrichtigungs-ID ist LUMA_CHANNEL ID.

1. Stellen Sie in Xcode sicher, dass AEP Messaging zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.

2. Navigieren Sie im Xcode-Projekt Luma Navigator zu Luma > > AppDelegate.

3. Stellen Sie sicher, dass AEPMessaging Teil Ihrer Importliste ist.

   import AEPMessaging

4. Stellen Sie sicher, dass Messaging.self Teil des Arrays von Erweiterungen ist, die Sie registrieren.

   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. Stellen Sie in Android Studio sicher, dass aepsdk-messaging-android Teil der Abhängigkeiten in build.gradle.kts (Module :app) in Android Gradle Scripts ist. Siehe Gradle.

2. Navigieren Sie zu Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication im Android Studio-Projektnavigator.

3. Stellen Sie sicher, dass com.adobe.marketing.mobile.Messaging Teil Ihrer Importliste ist.

   import import com.adobe.marketing.mobile.Messaging

4. Stellen Sie sicher, dass Messaging.EXTENSION Teil des Arrays von Erweiterungen ist, die Sie registrieren.

   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. Navigieren Sie im Xcode-Projekt Luma Navigator zu Luma > > AppDelegate.

2. Fügen Sie die MobileCore.setPushIdentifier-API zur func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) hinzu.

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

   Diese Funktion ruft das Geräte-Token ab, das für das Gerät, auf dem die App installiert ist, eindeutig ist. Anschließend legt das Token für den Versand von Push-Benachrichtigungen unter Verwendung der Konfiguration fest, die Sie eingerichtet haben und die auf dem Push Notification Service (APNs) von Apple basiert.

1. Navigieren Sie zu Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication im Android Studio-Projektnavigator.

2. Fügen Sie die MobileCore.setPushIdentifier-API in der override fun onCreate() zur class LumaAplication : Application in FirebaseMessaging.getInstance().token.addOnCompleteListener hinzu.

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

   Diese Funktion ruft das Geräte-Token ab, das für das Gerät, auf dem die App installiert ist, eindeutig ist. Legt dann das Token für den Versand von Push-Benachrichtigungen mithilfe der Konfiguration fest, die Sie eingerichtet haben und die auf Firebase Cloud Messaging (FCM) basiert.

1. Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma Modell > XDM > TestPushPayload und überprüfen Sie den Code.

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

   Der Code ist eine Darstellung der folgenden einfachen Payload, die Sie an den Trigger Ihrer Test-Push-Benachrichtigungs-Journey senden werden.

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

2. Navigieren Sie im Xcode-Projekt-Luma zu Luma > Utils > > MobileSDK) und fügen Sie func sendTestPushEvent(applicationId: String, eventType: String) den folgenden Code hinzu:

   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() ?? [:] ) }

   Dieser Code erstellt eine testPushPayload-Instanz mit den Parametern, die für die Funktion (applicationId und eventType) bereitgestellt werden, und ruft dann sendExperienceEvent beim Konvertieren der Payload in ein Wörterbuch auf. Dieser Code berücksichtigt auch die asynchronen Aspekte des Aufrufs der Adobe Experience Platform SDK durch die Verwendung des Swift-Parallelitätsmodells, das auf await und async basiert.

3. Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Views > General ConfigView. Fügen Sie der Definition der Schaltfläche „Push-Benachrichtigung“ den folgenden Code hinzu, um die Payload des Erlebnisereignisses „Push-Benachrichtigung testen“ an Ihren Journey-Trigger zu senden, wenn auf diese Schaltfläche getippt wird.

   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. Navigieren Sie zu Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt im Android Studio-Navigator und überprüfen Sie den Code.

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

   Der Code ist eine Darstellung der folgenden einfachen Payload, die Sie an den Trigger Ihrer Test-Push-Benachrichtigungs-Journey senden werden.

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

2. Android Navigieren Sie im Android Studio-Navigator zu ​ > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK und fügen Sie den folgenden Code zu func sendTestPushEvent(applicationId: String, eventType: String) hinzu:

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

   Dieser Code erstellt eine testPushPayload-Instanz mit den Parametern, die für die Funktion (applicationId und eventType) bereitgestellt werden, und ruft dann sendExperienceEvent beim Konvertieren der Payload in eine Zuordnung auf.

3. Navigieren Sie zu Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt im Android Studio-Navigator. Fügen Sie der Definition der Schaltfläche „Push-Benachrichtigung“ den folgenden Code hinzu, um die Payload des Erlebnisereignisses „Push-Benachrichtigung testen“ an Ihren Journey-Trigger zu senden, wenn auf diese Schaltfläche getippt wird.

   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. Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Xcode mithilfe von aus.

2. Navigieren Sie zur Registerkarte Einstellungen.

3. Tippen Sie auf Push-Benachrichtigung.

   Die Push-Benachrichtigung wird über der App angezeigt.

   {width="300"}

1. Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Android Studio mithilfe von aus.

2. Navigieren Sie zur Registerkarte Einstellungen.

3. Tippen Sie auf Push-Benachrichtigung.

   Die Push-Benachrichtigung wird über der App angezeigt.

   {width="300"}