Erstellen und Versenden von Push-Benachrichtigungen

Navigieren Sie im Apple-Entwicklerportal zu Schlüssel.

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

Geben Sie einen Schlüsselnamen an.

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

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

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

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

Wählen Sie in der Datenerfassungsoberfläche im linken Bereich die Option App-Oberflächen aus.

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

Geben Sie einen Namen für die Konfiguration ein, z. B. Luma App Tutorial .

Wählen Sie in Mobile Application Configuration die Option Apple iOS aus.

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

Schalten Sie den Umschalter Push-Anmeldedaten ein, um Ihre Anmeldedaten hinzuzufügen.

Ziehen Sie die Datei .p8 Apple Push Notification Authentication Key in den Arbeitsbereich.

Geben Sie die Schlüssel-ID an, eine 10-stellige Zeichenfolge, die bei der Erstellung des p8-Authentifizierungsschlüssels zugewiesen wurde. Sie finden sie auf der Registerkarte Schlüssel auf der Seite Zertifikate, Kennungen und Profile der Apple-Portal-Seiten für Entwickler. Siehe auch Erstellen eines privaten Schlüssels.

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. Siehe auch Erstellen eines privaten Schlüssels.

Wählen Sie Speichern aus.

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

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

Im Bildschirm Datastreams > > Adobe Experience Platform :

1. Wählen Sie, falls noch nicht ausgewählt, AJO Push Profile DataSet aus dem Profildatensatz aus. Dieser Profildatensatz ist bei Verwendung des API-Aufrufs MobileCore.setPushIdentifier erforderlich (siehe Registrieren des Geräte-Tokens für Push-Benachrichtigungen), der 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. Weitere Informationen finden Sie unter Adobe Experience Platform-Einstellungen .

3. Wählen Sie Speichern aus, um Ihre Datastream-Konfiguration zu speichern.

Navigieren Sie zu Tags > Erweiterungen > Katalog,

Öffnen Sie Ihre 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, z. B. Entwicklung.

2. Wählen Sie den Datensatz AJO Push Tracking Experience Event Datensatz aus der Liste Ereignisdatensatz aus.

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

   

Lesen Sie den Abschnitt Setup instructions , 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 Debug".

Wählen Sie Speichern aus.

Wählen Sie im linken Navigationsbereich Debug pushen aus.

Wählen Sie die Registerkarte Einrichtung validieren aus.

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

Vergewissern Sie sich, dass keine Fehler auftreten.

Wählen Sie die Registerkarte Testversand durchführen aus.

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

Wählen Sie Test Push-Benachrichtigung senden aus.

Überprüfen Sie die Testergebnisse.

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

{width="300"}

Rufen Sie Ihre App in Xcode auf.

Wählen Sie im Projektnavigator Luma aus.

Wählen Sie das Ziel Luma aus.

Wählen Sie die Registerkarte Signing & Capabilities aus.

Konfigurieren Sie Automatische Verwaltung der Signierung, Team und die Bundle-Kennung oder verwenden Sie Ihre spezifischen Apple-Entwicklungsbereitstellungsdetails.

{modal="regular"}

Wählen Sie in Xcode Luma aus der Liste ZIELGRUPPEN, wählen Sie die Registerkarte Signing & Capabilities, klicken Sie auf die Schaltfläche + Capability und wählen Sie dann Push Notifications. Dadurch kann Ihre App Push-Benachrichtigungen empfangen.

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

Sie werden aufgefordert, die Vorlage für Ihr neues Ziel auszuwählen. Wählen Sie Erweiterung des Benachrichtigungsdienstes 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 Package-Abhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.

Navigieren Sie im Xcode Project-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 API MobileCore.setPushIdentifier zur Funktion 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 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 in der linken Leiste Schemas aus.

Wählen Sie in der Registerkartenleiste Durchsuchen aus.

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

Im Schema-Editor:

1. Wählen Sie das Feld eventType aus.

2. Scrollen Sie im Bereich Feldeigenschaften nach unten, um die Liste der möglichen Werte für den Ereignistyp anzuzeigen. Wählen Sie Zeile hinzufügen 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 Journey Optimizer-Benutzeroberfläche in der linken Leiste Konfigurationen aus.

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

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

Im Bereich Ereignis bearbeiten1 :

1. Geben Sie LumaTestEvent als Name des Ereignisses ein.

2. Geben Sie eine Beschreibung an, z. B. 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 der Liste Schema erstellt haben, z. B. Luma Mobile App Event Schema v.1.

4. Wählen Sie neben der Liste Felder aus.

   

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

   • Application Identified (id),
   • Ereignistyp (eventType),
   • Primär (primär).

   

   Wählen Sie dann OK aus.

5. Wählen Sie " "neben dem Feld Ereignis-ID-Bedingung".

   1. Ziehen Sie im Dialogfeld Ereignis-ID-Bedingung hinzufügen den Eintrag Ereignistyp (eventType) auf Element hierher ziehen und ablegen.

   2. Scrollen Sie im Popup-Fenster nach unten und wählen Sie application.test aus (der Ereignistyp, den Sie zuvor zur Liste der Ereignistypen im Rahmen von Schema aktualisieren hinzugefügt haben). Scrollen Sie dann nach oben und wählen Sie OK aus.

   3. Wählen Sie OK aus, 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 des Schlüssels ECID für die map identityMap ausgefüllt.

7. Wählen Sie Speichern aus.

   

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

Wählen Sie Journey erstellen aus.

Im Bereich 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 Neueintritt zulassen ausgewählt ist, und legen Sie die Wartezeit für den erneuten Eintritt auf ​​ 30 ​​ ​ ​​ Sekunden ​​ fest.

4. Klicken Sie auf OK.

   

Zurück auf der Journey-Arbeitsfläche ziehen Sie aus den EREIGNISSEN Ihr LumaTestEvent per Drag-and-Drop auf die Arbeitsfläche, auf der Wählen Sie ein Eintrittsereignis oder die Aktivität "Zielgruppe lesen" angezeigt wird.

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

Ziehen Sie aus dem Dropdown-Menü AKTIONEN den Eintrag Push auf den Eintrag , der rechts von Ihrer LumaTestEvent -Aktivität angezeigt wird. Im Bereich Aktionen: Push :

1. Geben Sie eine Bezeichnung an, z. B. Luma Test Push Notification, geben Sie eine Beschreibung ein, z. B. Test push notification for Luma mobile app, wählen Sie Transactional aus der Liste Kategorie und wählen Sie Luma aus der Liste Push-Oberfläche.

2. Wählen Sie Inhalt bearbeiten aus, um die eigentliche Push-Benachrichtigung zu bearbeiten.

   

   Im Editor Push Notification :

   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, wird das Bild Teil der Push-Benachrichtigung sein.

   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, wählen Sie OK aus.

Ihre Journey sollte wie unten dargestellt aussehen. Wählen Sie Publish aus, um Ihre Journey zu veröffentlichen und zu aktivieren.

Navigieren Sie im Xcode Project-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 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 im Xcode Project-Navigator zu Luma > Luma > Utils > MobileSDK und fügen Sie den folgenden Code zu func sendTestPushEvent(applicationId: String, eventType: String) 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 mithilfe der Parameter, die der Funktion (applicationId und eventType) bereitgestellt werden, und ruft dann sendExperienceEvent auf, während die Payload in ein Wörterbuch konvertiert wird. Dieser Code berücksichtigt diesmal auch die asynchronen Aspekte des Aufrufs des Adobe Experience Platform-SDK, indem er das Swift-Parallelitätsmodell verwendet, das auf await und async basiert.

Navigieren Sie im Xcode Project-Navigator zu Luma > Luma > Views > General > ConfigView . 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 mit aus.

Gehen Sie zur Registerkarte Einstellungen .

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

{width="300"}