Lernziele

In dieser Lektion werden Sie

  • Registrieren der App-ID beim Apple Push Notification Service (APNs).
  • Erstellen Sie eine Kanalkonfiguration in Journey Optimizer.
  • Aktualisieren Sie Ihr Schema, um Push-Messaging-Felder einzuschließen.
  • Installieren und konfigurieren Sie die Tag-Erweiterung von Journey Optimizer.
  • Aktualisieren Sie Ihre App, um die Journey Optimizer-Tag-Erweiterung zu registrieren.
  • Überprüfen Sie das Setup in Assurance.
  • Senden einer Testnachricht von Assurance
  • Definieren Sie Ihr eigenes Push-Benachrichtigungsereignis, Journey und Erlebnis in Journey Optimizer.
  • Senden Sie Ihre eigene Push-Benachrichtigung aus der App heraus.

Einrichten

TIPP
Wenn Sie Ihre Umgebung bereits im Rahmen der Lektion Journey Optimizer-In-App-Messaging eingerichtet haben, haben Sie möglicherweise bereits einige der Schritte in diesem Setup-Abschnitt ausgeführt.

App-ID bei APNs registrieren

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

Erstellen eines privaten Schlüssels

  1. Navigieren Sie im Apple-Entwicklerportal zu Keys.

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

  3. Geben Sie einen Schlüsselnamen“.

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

  5. Wählen Sie Weiter aus.
    Neuen Schlüssel konfigurieren

  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.
    Wichtige Details

Weitere Dokumentationen finden Sie hier.

Push-Anmeldedaten für Mobile Apps in Journey Optimizer hinzufügen

Als Nächstes müssen Sie Ihre Push-Anmeldedaten für Mobile Apps in Journey Optimizer hinzufügen. (In früheren Versionen des Produkts wurden diese als Teil der Konfiguration „App-Oberfläche“ in der Datenerfassung hinzugefügt).

Die Registrierung der Push-Anmeldedaten für Mobile Apps ist erforderlich, um Adobe zu erlauben, Push-Benachrichtigungen in Ihrem Namen zu senden. Gehen Sie wie folgt vor:

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

  2. Wählen Sie Push-Anmeldedaten erstellen aus.

    Erstellen Sie eine neue Konfiguration für Push-Anmeldeinformationen in Journey Optimizer

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

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

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

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

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

  8. 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.)

    Konfiguration von Push-Anmeldeinformationen in Journey Optimizer

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

Erstellen einer Kanalkonfiguration für Push-Benachrichtigungen in Journey Optimizer

Nachdem Sie eine Konfiguration für Push-Anmeldeinformationen erstellt haben, müssen Sie eine Konfiguration erstellen, um Push-Benachrichtigungen von Journey Optimizer senden zu können.

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

    Erstellen Sie eine neue Kanalkonfiguration

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

    HINWEIS
    Namen müssen mit einem Buchstaben (A–Z) beginnen. Ein Name darf nur alphanumerische Zeichen enthalten. Sie können auch die Zeichen Unterstrich _, Punkt . und Bindestrich - verwenden.
  3. 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).

  4. Wählen Sie den Kanal Push aus.

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

  6. Wählen Sie Ihre Plattform aus.

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

  8. Klicken Sie Senden, um Ihre Änderungen zu speichern.

    Konfiguration des Push-Kanals

Aktualisieren der Datenstromkonfiguration

Aktualisieren Sie Ihre Experience Edge-Konfiguration , um sicherzustellen, dass Daten von Ihrer Mobile App an Edge Network Journey Optimizer weitergeleitet werden.

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

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

  3. Im Bildschirm Datenströme > Ordner > 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.

    Konfiguration des AEP-Datenstroms

Installieren der Journey Optimizer Tags-Erweiterung

Damit Ihre App mit Journey Optimizer verwendet werden kann, müssen Sie Ihre Tag-Eigenschaft aktualisieren.

  1. Navigieren Sie Tags > Erweiterungen > Katalog,

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

  3. Wählen Sie Katalog aus.

  4. Suchen Sie nach der Erweiterung Adobe Journey Optimizer.

  5. Installieren Sie die Erweiterung .

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

      AJO-Erweiterungseinstellungen

HINWEIS
Wenn Sie AJO Push-Tracking-Erlebnisereignis-Datensatz nicht als Option sehen, wenden Sie sich an die Kundenunterstützung.

Überprüfen des Setups mit Assurance

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

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

  3. Wählen Sie Plus neben Push-Debugging aus.

  4. Wählen Sie Speichern aus.
    Speichern

  5. Wählen Debug pushen in der linken Navigationsleiste aus.

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

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

  8. Vergewissern Sie sich, dass Sie keine Fehler erhalten.
    Validieren

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

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

  11. Wählen Sie Fehler Test-Push-Benachrichtigung senden.

  12. Überprüfen Sie Testergebnisse.

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

Signieren

Das Signieren der Luma-App ist erforderlich, um Push-Benachrichtigungen zu senden erfordert ein gebührenpflichtiges Apple-Entwicklerkonto.

So aktualisieren Sie die Signatur für Ihre App:

  1. Rufen Sie Ihre App in Xcode auf.

  2. Wählen Sie Luma im Projekt-Navigator aus.

  3. Wählen Sie die Luma aus.

  4. Wählen Sie die Registerkarte Signierung und Funktionen aus.

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

    WICHTIG
    Stellen Sie sicher dass Sie eine eindeutige“ Bundle-Kennung verwenden und die com.adobe.luma.tutorial.swiftui Bundle-Kennung ersetzen, da jede Bundle-Kennung eindeutig sein muss. Normalerweise verwenden Sie ein Reverse-DNS-Format für Paket-ID-Zeichenfolgen wie com.organization.brand.uniqueidentifier. Die fertige Version dieses Tutorials verwendet beispielsweise com.adobe.luma.tutorial.swiftui.

    Xcode-Signaturfunktionen

Hinzufügen von Push-Benachrichtigungsfunktionen zu Ihrer App

WICHTIG
Um Push-Benachrichtigungen in einer iOS-Mobile-App zu implementieren und zu testen, benötigen Sie ein - Apple-Entwicklerkonto. Wenn Sie noch kein kostenpflichtiges Apple-Entwicklerkonto haben, können Sie den Rest dieser Lektion überspringen.
  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. Dadurch 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.

Push-Benachrichtigungs-Erweiterung