Erstellen und Versenden von Push-Benachrichtigungen

Navigieren Sie im Apple-Entwicklerportal zu Schlüssel.

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

Stellen Sie eine Schlüsselname.

Wählen Sie die Apple Push Notification Service (APNs) aktivieren.

Klicken Sie auf Weiter.

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

Laden Sie die .p8 privater Schlüssel. Sie wird später in dieser Lektion in der App Surface-Konfiguration verwendet.

Beachten Sie die Schlüssel-ID. Sie wird in der App Surface-Konfiguration verwendet.

Beachten Sie die Team-ID. Sie wird in der App Surface-Konfiguration verwendet.

Aus dem Datenerfassungsoberflächeauswählen App-Oberflächen im linken Bereich.

Um eine Konfiguration zu erstellen, wählen Sie App-Oberfläche erstellen.

Geben Sie einen Name für die Konfiguration, beispielsweise Luma App Tutorial .

Von Konfiguration von Mobile Apps auswählen Apple iOS.

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

Schalten Sie die Push-Anmeldedaten Schalten Sie um, um Ihre Anmeldedaten hinzuzufügen.

Ziehen und ablegen .p8 Authentifizierungsschlüssel für Apple-Push-Benachrichtigungen -Datei.

Stellen Sie die Schlüssel-ID, eine 10-stellige Zeichenfolge, die bei der Erstellung von p8 Authentifizierungsschlüssel. Sie finden sie unter der Schlüssel im Zertifikate, Kennungen und Profile auf den Apple Developer Portal-Seiten. Siehe auch Privaten Schlüssel erstellen.

Geben Sie die Team ID an. Die Team-ID ist ein Wert, der unter der Mitgliedschaft oder oben auf der Apple Developer Portal-Seite. Siehe auch Privaten Schlüssel erstellen.

Wählen Sie Speichern aus.

Wählen Sie in der Datenerfassungs-Benutzeroberfläche die Option Datenspeicher und wählen Sie Ihren Datastream aus, z. B. Luma Mobile App.

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

Im Datenspeicher > > Adobe Experience Platform screen:

1. Wenn noch nicht ausgewählt, wählen Sie AJO Push Profile DataSet von Profildatensatz. Dieser Profildatensatz ist bei Verwendung der MobileCore.setPushIdentifier API-Aufruf (siehe Geräte-Token für Push-Benachrichtigungen registrieren), die sicherstellt, dass die eindeutige Kennung für Push-Benachrichtigungen (auch Push-Kennung genannt) als Teil des Benutzerprofils gespeichert wird.

2. Adobe Journey Optimizer ausgewählt ist. Siehe Adobe Experience Platform-Einstellungen für weitere Informationen.

3. Wählen Sie zum Speichern Ihrer Datastream-Konfiguration Speichern.

Navigieren Sie zu Tags > Erweiterungen > Katalog,

Öffnen Sie Ihre Eigenschaft, beispielsweise Luma Mobile App Tutorial.

Auswählen Katalog.

Suchen Sie nach Adobe Journey Optimizer -Erweiterung.

Installieren Sie die -Erweiterung.

Im Installieren der Erweiterung dialog

1. Wählen Sie beispielsweise eine Umgebung aus. Entwicklung.

2. Wählen Sie die AJO Push Tracking Erlebnis-Datensatz Datensatz aus der Ereignis-Datensatz Liste.

3. Auswählen In Bibliothek speichern und erstellen.

   

Überprüfen Sie die Einrichtungsanweisungen -Abschnitt, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

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

Auswählen neben Push Debug.

Wählen Sie Speichern aus.

Auswählen Push Debug über die linke Navigation.

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

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

Vergewissern Sie sich, dass keine Fehler auftreten.

Wählen Sie die Test-Push senden Registerkarte.

(optional) Ändern Sie die Standarddetails für Titel und body

Auswählen Push-Benachrichtigung zum Testversand senden.

Überprüfen Sie die Testergebnisse.

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

{width="300"}

Rufen Sie Ihre App in Xcode auf.

Auswählen Luma im Projekt-Navigator.

Wählen Sie die Luma Zielgruppe.

Wählen Sie die Signieren und Funktionen Registerkarte.

Konfigurieren Automatische Verwaltungssignatur, Team, und Bundle-Kennung oder verwenden Sie Ihre spezifischen Apple-Entwicklungsbereitstellungsdetails.

{modal="regular"}

Wählen Sie in Xcode Luma aus dem ZIELE Liste, wählen Sie die Signieren und Funktionen auswählen, wählen Sie die + Funktion Schaltfläche und wählen Sie Push-Benachrichtigungen. Dadurch kann Ihre App Push-Benachrichtigungen empfangen.

Als Nächstes müssen Sie der App eine Benachrichtigungserweiterung hinzufügen. Gehen Sie zurück zu General und wählen Sie die + -Symbol unten im ZIELE Abschnitt.

Sie werden aufgefordert, die Vorlage für Ihr neues Ziel auszuwählen. Auswählen Erweiterung für Benachrichtigungsdienst und wählen Sie Nächste.

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

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

Navigieren Sie zu Luma > Luma > AppDelegate im Xcode-Projektnavigator.

Sichern AEPMessaging ist Teil Ihrer Importliste.

import AEPMessaging

Sichern Messaging.self ist Teil des Arrays von Erweiterungen, 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 für die func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) -Funktion.

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

Diese Funktion ruft das Geräte-Token ab, das für das Gerät eindeutig ist, auf dem die App installiert ist. Legt dann das Token für den Push-Benachrichtigungsversand mithilfe der von Ihnen eingerichteten Konfiguration fest, die sich auf den Push-Benachrichtigungsdienst (APNs) von Apple stützt.

Wählen Sie in der Journey Optimizer-Benutzeroberfläche die Option Schemas über die linke Leiste.

Auswählen Durchsuchen in der Symbolleiste.

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

Im Schema-Editor:

1. Wählen Sie die eventType -Feld.

2. Im Feldeigenschaften nach unten scrollen, um die Liste der möglichen Werte für den Ereignistyp anzuzeigen. Auswählen Zeile hinzufügen und fügen Sie application.test als WERT und Test event for push notification als DISPLAY NAME.

3. Wählen Sie Anwenden aus.

4. Wählen Sie Speichern aus.

   

Wählen Sie in der Journey Optimizer-Benutzeroberfläche die Option Konfigurationen über die linke Leiste.

Im Dashboard Bildschirm, wählen Sie Verwalten im Veranstaltungen Kachel.

Im Veranstaltungen Bildschirm, auswählen Ereignis erstellen.

Im Ereignis-Ereignis bearbeiten1 -Bereich:

1. Eingabe LumaTestEvent als Name des Ereignisses.

2. Stellen Sie eine Beschreibung, beispielsweise Test event to trigger push notifications in Luma app.

3. Wählen Sie das Erlebnisereignisschema der Mobile App aus, das Sie zuvor in Erstellen eines XDM-Schemas aus dem Schema beispielsweise Liste Luma Mobile App Event Schema v.1.

4. Auswählen neben dem Felder Liste.

   

   Im Felder müssen Sie sicherstellen, dass die folgenden Felder ausgewählt sind (über den Standardfeldern, die immer ausgewählt sind (_id, id, und timestamp). Mithilfe der Dropdown-Liste können Sie zwischen Ausgewählt, Alle und Primär oder verwenden Sie -Feld.

   • App identifiziert (id),
   • Ereignistyp (eventType),
   • Primär (primary).

   

   Wählen Sie anschließend Ok.

5. Auswählen neben dem Ereignis-ID-Bedingung -Feld.

   1. Im Ereignis-ID-Bedingung hinzufügen Dialogfeld, ziehen und ablegen Ereignistyp (eventType) auf Element hierher ziehen und ablegen.

   2. Scrollen Sie im Popover-Fenster zum unteren Rand und wählen Sie application.test (Dies ist der Ereignistyp, den Sie zuvor zur Liste der Ereignistypen im Rahmen von Schema aktualisieren). Scrollen Sie dann nach oben und wählen Sie Ok.

   3. Auswählen Ok , um die Bedingung zu speichern.

      

6. Auswählen ECID (ECID) aus dem Namespace Liste. Automatisch die Profilkennung -Feld mit Die ID des ersten Elements des ECID-Schlüssels für die Map identityMap.

7. Wählen Sie Speichern aus.

   

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

Auswählen Journey erstellen.

Im Journey-Eigenschaften Bereich:

1. Geben Sie einen Name für die Journey, beispielsweise Luma - Test Push Notification Journey.

2. Geben Sie einen Beschreibung für die Journey, beispielsweise Journey for test push notifications in Luma mobile app.

3. Sichern Wiedereintritt erlauben ausgewählt und festgelegt ist Wartezeit beim erneuten Eintritt nach 30 Sekunden.

4. Klicken Sie auf OK.

   

Zurück auf der Journey-Arbeitsfläche, aus dem EREIGNISSE, ziehen Sie Ihre LumaTestEvent auf der Arbeitsfläche, auf der sie angezeigt wird Wählen Sie ein Eintrittsereignis oder die Aktivität Audience lesen aus.

• Im Ereignisse: LumaTestEvent Bereich, geben Sie eine Titel, beispielsweise Luma Test Event.

Aus dem AKTIONEN Dropdown, per Drag & Drop Push auf im rechten LumaTestEvent -Aktivität. Im Aktionen: Push -Bereich:

1. Stellen Sie eine Titel, beispielsweise Luma Test Push Notification, stellen Sie eine Beschreibung, beispielsweise Test push notification for Luma mobile appauswählen Transactional aus dem Kategorie Liste und Auswahl Luma aus dem Push-Oberfläche.

2. Auswählen Inhalt bearbeiten , um die eigentliche Push-Benachrichtigung zu bearbeiten.

   

   Im Push-Benachrichtigung editor:

   1. Geben Sie einen Titel, beispielsweise Luma Test Push Notification und geben Sie einen body, beispielsweise Test push notification for Luma mobile app.

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

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

      

3. Um die Definition der Push-Benachrichtigung zu speichern und abzuschließen, wählen Sie Ok.

Ihre Journey sollte wie unten dargestellt aussehen. Auswählen Veröffentlichen , um Ihre Journey zu veröffentlichen und zu aktivieren.

Navigieren Sie zu Luma > Luma > Modell > XDM > TestPushPayload im Xcode-Projektnavigator 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 stellt die folgende einfache Payload dar, die Sie an den Trigger Ihrer Test-Push-Benachrichtigung senden werden Journey

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

Navigieren Sie zu Luma > Luma > Utils > MobileSDK im Xcode Project-Navigator und fügen Sie den folgenden Code zu 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() ?? [:]
    )
}

Dieser Code erstellt eine testPushPayload -Instanz mit den Parametern, die der Funktion (applicationId und eventType) und anschließend -Aufrufe sendExperienceEvent beim Konvertieren der Payload in ein Wörterbuch. Dieser Code berücksichtigt diesmal auch die asynchronen Aspekte des Aufrufs des Adobe Experience Platform-SDK, indem das Swift-Parallelitätsmodell verwendet wird, das auf await und async.

Navigieren Sie zu Luma > Luma > Views > General > ConfigView im Xcode-Projektnavigator. Fügen Sie in der Definition der Push-Benachrichtigungsschaltfläche den folgenden Code hinzu, um die Payload des Erlebnisereignisses für Push-Benachrichtigungen zu senden, die bei jedem Tippen auf diese Schaltfläche auf Ihre Journey Trigger werden.

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

Navigieren Sie zu Einstellungen Registerkarte.

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

{width="300"}