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
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
-
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.
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:
-
Ö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.
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.
-
Ö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.
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. -
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.
Aktualisieren der Datenstromkonfiguration
Aktualisieren Sie Ihre Experience Edge-Konfiguration , um sicherzustellen, dass Daten von Ihrer Mobile App an Edge Network Journey Optimizer weitergeleitet werden.
-
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
-
Im Bildschirm Datenströme >
-
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. -
Adobe Journey Optimizer ist ausgewählt. Weitere Informationen finden Sie unter {🔗}Adobe Experience Platform-Einstellungen.
-
Um Ihre Datenstromkonfiguration zu speichern, wählen Sie Speichern aus.
-
Installieren der Journey Optimizer Tags-Erweiterung
Damit Ihre App mit Journey Optimizer verwendet werden kann, müssen Sie Ihre Tag-Eigenschaft aktualisieren.
-
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
-
Wählen Sie eine Umgebung aus, zum Beispiel Entwicklung.
-
Wählen Sie den Datensatz AJO Push-Tracking-Erlebnisereignis- aus der Liste Ereignisdatensatz aus.
-
Wählen Sie In Bibliothek speichern und erstellen.
-
Überprüfen des Setups mit Assurance
-
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
-
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
-
Überprüfen Sie Testergebnisse.
-
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:
-
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.
WICHTIG
Stellen Sie sicher dass Sie eine eindeutige“ Bundle-Kennung verwenden und diecom.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 wiecom.organization.brand.uniqueidentifier
. Die fertige Version dieses Tutorials verwendet beispielsweisecom.adobe.luma.tutorial.swiftui
.
Hinzufügen von Push-Benachrichtigungsfunktionen zu Ihrer App
-
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.
Ihrer App sollte jetzt eine Push-Benachrichtigungs-Erweiterung hinzugefügt werden, ähnlich wie im folgenden Bildschirm.