Erstellen und Versenden von Push-Benachrichtigungen

Navigieren Sie im Apple-Entwicklerportal zu Keys.

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

Geben Sie einen Schlüsselnamen“.

Aktivieren Sie das Kontrollkästchen Apple Push Notification Service (APNs.

Wählen Sie Weiter aus.

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

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

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

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

Öffnen Sie in der Journey Optimizer-Benutzeroberfläche das Menü Kanäle > Push-Einstellungen > Push-Anmeldeinformationen.

Wählen Sie Push-Anmeldedaten erstellen aus.

Wählen Sie in der --Liste das Betriebssystem iOS aus.

Geben Sie die Bundle ID der Mobile App in das Feld App-ID (iOS Bundle ID) ein. Beispiel: com.adobe.luma.tutorial.swiftui

Aktivieren Sie die Option Auf alle Sandboxes anwenden, um diese Push-Anmeldedaten für alle Sandboxes verfügbar zu machen. Wenn eine bestimmte Sandbox über eigene Anmeldedaten für dasselbe Platform- und App-ID-Paar verfügt, haben diese Sandbox-spezifischen Anmeldedaten Vorrang.

Ziehen Sie die aus der vorherigen Übung erhaltene .p8 Apple Push Notification Authentication Key-Datei per Drag-and-Drop hinüber.

Geben Sie die Schlüssel-ID an, eine 10-stellige Zeichenfolge, die bei der Erstellung p8 Authentifizierungsschlüssels zugewiesen wurde. Sie finden diese auf der Registerkarte Schlüssel auf der Seite Zertifikate, Kennungen und Profile der Apple Developer Portal-Seiten. (Sie sollten dies während der vorherigen Übung notiert haben.)

Geben Sie die Team ID an. Die Team-ID ist ein Wert, der auf der Registerkarte Mitgliedschaft oder oben auf der Apple Developer Portal-Seite zu finden ist. (Sie sollten dies während der vorherigen Übung notiert haben.)

Klicken Sie Senden, um Ihre Konfiguration für Push-Anmeldeinformationen zu erstellen.

Öffnen Sie in der Journey Optimizer Benutzeroberfläche das Menü Kanäle > Allgemeine Einstellungen > Kanalkonfigurationen und wählen Sie dann Kanalkonfiguration erstellen.

Geben Sie einen Namen und eine Beschreibung (optional) für die Konfiguration an.

Um der Konfiguration benutzerdefinierte oder grundlegende Datennutzungskennzeichnungen zuzuweisen, können Sie Zugriff verwalten auswählen. Erfahren Sie mehr über die Zugriffssteuerung auf Objektebene (Object Level Access Control, OLAC).

Wählen Sie den Kanal Push aus.

Wählen Sie eine Marketing-Aktion aus, um Einverständnisrichtlinien mit den Nachrichten zu verknüpfen, die diese Konfiguration verwenden. Es werden alle mit dieser Marketing-Aktion verknüpften Einverständnisrichtlinien genutzt, um die Voreinstellungen Ihrer Kundinnen und Kunden zu respektieren. Weitere Informationen zu Marketing-Aktionen.

Wählen Sie Ihre Plattform aus.

Wählen Sie dieselbe App-ID wie für Ihre oben konfigurierten Push-Anmeldedaten aus.

Klicken Sie Senden, um Ihre Änderungen zu speichern.

Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datenströme und wählen Sie Ihren Datenstrom aus, z. B. Luma Mobile App.

Wählen Sie für Experience Platform und wählen Sie Bearbeiten aus dem Kontextmenü.

Im Bildschirm Datenströme > > Adobe Experience Platform:

1. Wählen Sie, falls noch nicht ausgewählt, AJO Push Profile Dataset aus Profile Dataset. Dieser Profildatensatz ist bei Verwendung des MobileCore.setPushIdentifier-API-Aufrufs erforderlich (siehe Registrieren des Geräte-Tokens für Push-Benachrichtigungen), wodurch sichergestellt wird, dass die eindeutige Kennung für Push-Benachrichtigungen (auch als Push-Kennung bezeichnet) als Teil des Profils des Benutzers gespeichert wird.

2. Adobe Journey Optimizer ist ausgewählt. Weitere Informationen finden Sie unter {🔗}Adobe Experience Platform-Einstellungen.

3. Um Ihre Datenstromkonfiguration zu speichern, wählen Sie Speichern aus.

Navigieren Sie Tags > Erweiterungen > Katalog,

Öffnen Sie die Eigenschaft, z. B. Luma Mobile App Tutorial.

Wählen Sie Katalog aus.

Suchen Sie nach der Erweiterung Adobe Journey Optimizer.

Installieren Sie die Erweiterung .

Im Dialogfeld Erweiterung installieren

1. Wählen Sie eine Umgebung aus, zum Beispiel Entwicklung.

2. Wählen Sie den Datensatz AJO Push-Tracking-Erlebnisereignis- aus der Liste Ereignisdatensatz aus.

3. Wählen Sie In Bibliothek speichern und erstellen.

   

Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

Wählen Sie in der Assurance-Benutzeroberfläche Konfigurieren aus.

Wählen Sie neben Push-Debugging aus.

Wählen Sie Speichern aus.

Wählen Debug pushen in der linken Navigationsleiste aus.

Wählen Sie die Registerkarte Einrichtung überprüfen aus.

Wählen Sie Ihr Gerät in der Liste Client aus.

Vergewissern Sie sich, dass Sie keine Fehler erhalten.

Wählen Sie die Registerkarte Test-Push senden aus.

(Optional) Ändern Sie die Standarddetails für Titel und Hauptteil

Wählen Sie Test-Push-Benachrichtigung senden.

Überprüfen Sie Testergebnisse.

Die Test-Push-Benachrichtigung sollte nun in Ihrer App angezeigt werden.

{width="300"}

Rufen Sie Ihre App in Xcode auf.

Wählen Sie Luma im Projekt-Navigator aus.

Wählen Sie die Luma aus.

Wählen Sie die Registerkarte Signierung und Funktionen aus.

Konfigurieren Sie Automatische Signaturverwaltung, Team und Bundle- oder verwenden Sie Ihre spezifischen Bereitstellungsdetails für die Apple-Entwicklung.

{modal="regular"}

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. Dadurch kann Ihre App Push-Benachrichtigungen erhalten.

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.

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

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

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

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

Stellen Sie sicher, dass AEPMessaging Teil Ihrer Importliste ist.

import AEPMessaging

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

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
]

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

// 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.

Wählen Sie in der Journey Optimizer-Benutzeroberfläche Schemata in der linken Leiste aus.

Wählen Durchsuchen in der Registerkartenleiste aus.

Wählen Sie Ihr Schema aus, um es beispielsweise Luma Mobile App Event Schema zu öffnen.

Im Schema-Editor:

1. Wählen Sie das Feld eventType aus.

2. Scrollen im Bereich Feldeigenschaften“ nach unten, um die Liste der möglichen Werte für den Ereignistyp anzuzeigen. Wählen Sie Zeile hinzufügen aus und fügen Sie application.test als WERT und Test event for push notification als DISPLAY NAME hinzu.

3. Wählen Sie Anwenden aus.

4. Wählen Sie Speichern aus.

   

Wählen Sie in der Benutzeroberfläche von Journey Optimizer Konfigurationen in der linken Leiste aus.

Wählen Sie im Dashboard die Schaltfläche Verwalten in der Kachel Ereignisse aus.

Wählen Sie im Ereignisse die Option Ereignis erstellen aus.

Im Bereich Ereignis bearbeiten1:

1. Geben Sie LumaTestEvent als Name des Ereignisses ein.

2. Geben Sie Beschreibung ein, z. B. Test event to trigger push notifications in Luma app.

3. Wählen Sie in der Liste Schema“ das Erlebnisereignisschema der Mobile App aus das Sie zuvor unter „Erstellen eines XDM Schemas“ erstellt haben, z. B. Luma Mobile App Event Schema v.1.

4. Wählen neben der Liste Felder aus.

   

   Stellen Sie Dialogfeld „Felder sicher, dass die folgenden Felder ausgewählt sind (zusätzlich zu den Standardfeldern, die immer ausgewählt sind (_id, id und timestamp). Sie können mithilfe der Dropdown-Liste zwischen Ausgewählt, Alle und Primär wechseln oder das Feld verwenden.

   • Kennung der Anwendung (ID,
   • Ereignistyp (eventType),
   • Primär (primär).

   

   Wählen Sie dann OK aus.

5. Klicken Sie neben dem Feld Ereignis-ID-Bedingung.

   1. Ziehen Sie Dialogfeld „Ereignis-ID-Bedingung hinzufügen per Drag-and-Drop Ereignistyp (eventType) auf Ziehen Sie ein Element hierher.

   2. Scrollen Sie im Popover nach unten und wählen Sie application.test aus (dies ist der Ereignistyp, den Sie zuvor als Teil von „Schema aktualisieren zur Liste der Ereignistypen hinzugefügt). Scrollen Sie dann nach oben und wählen Sie OK aus.

   3. Klicken Sie OK, um die Bedingung zu speichern.

      

6. Wählen Sie ECID (ECID) aus der Liste Namespace aus. Das Feld Profilkennung wird automatisch mit Die ID des ersten Elements der ECID des Schlüssels für die identityMap -Zuordnung ausgefüllt.

7. Wählen Sie Speichern aus.

   

Wählen Sie in der Journey Optimizer-Benutzeroberfläche in der Leiste die Option Journey.

Wählen Sie Journey erstellen aus.

Im Bedienfeld Journey Eigenschaften:

1. Geben Sie einen Namen für die Journey ein, z. B. Luma - Test Push Notification Journey.

2. Geben Sie eine Beschreibung für die Journey ein, z. B. Journey for test push notifications in Luma mobile app.

3. Stellen Sie sicher dass „Erneuten zulassen“ ausgewählt ist und Wartezeit bis zum erneuten Eintritt auf 30 Sekunden.

4. Klicken Sie auf OK.

   

Ziehen Sie auf der Journey-Arbeitsfläche von EREIGNISSE Ihren LumaTestEvent auf die Arbeitsfläche, auf der er angezeigt wird Wählen Sie ein Eintrittsereignis oder eine Aktivität zum Lesen einer Zielgruppe aus.

• Geben Sie im Ereignisse: LumaTestEvent einen Titel ein, z. B. Luma Test Event.

Ziehen Sie aus dem AKTIONEN-Dropdown Push auf die , die rechts neben Ihrer LumaTestEvent angezeigt wird. Im Bereich Aktionen: Push:

1. Geben Sie einen Titel ein, z. B. Luma Test Push Notification einen Beschreibung, z. B. Test push notification for Luma mobile app, wählen Sie Transaktion aus der Liste Kategorie und wählen Sie Luma aus der Push-Oberfläche.

2. Wählen Sie Inhalt bearbeiten, um mit der Bearbeitung der eigentlichen Push-Benachrichtigung zu beginnen.

   

   Im Editor Push Benachrichtigung):

   1. Geben Sie einen Titel ein, z. B. Luma Test Push Notification, und geben Sie einen Hauptteil ein, z. B. Test push notification for Luma mobile app.

   2. Optional können Sie einen Link zu einem Bild (.png oder .jpg) in Medien hinzufügen eingeben. Wenn Sie dies tun, ist das Bild Teil der Push-Benachrichtigung.

   3. Um den Editor zu speichern und zu verlassen, wählen Sie aus.

      

3. Um die Definition der Push-Benachrichtigung zu speichern und abzuschließen, klicken Sie auf OK.

Ihr Journey sollte wie folgt aussehen. Wählen Sie Veröffentlichen aus, um Ihren Journey zu veröffentlichen und zu aktivieren.

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

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

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

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

// 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 mithilfe des Swift-Parallelitätsmodells, das auf await und async basiert.

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.

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

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

Navigieren Sie zur Registerkarte Einstellungen.

Tippen Sie auf Push-Benachrichtigung. Die Push-Benachrichtigung wird in Ihrer App angezeigt.

{width="300"}