Konfigurieren des Kanals für Push-Benachrichtigungen push-notification-configuration
Journey Optimizer ermöglicht es Ihnen, Journeys zu erstellen und Nachrichten an eine ausgewählte Zielgruppe zu senden. Bevor Sie mit dem Versand von Push-Benachrichtigungen über Journey Optimizer beginnen, müssen Sie sicherstellen, dass in der Mobile App und für Tags in Adobe Experience Platform Konfigurationen und Integrationen vorhanden sind. Informationen zum Datenfluss von Push-Benachrichtigungen in Adobe Journey Optimizer finden Sie auf dieser Seite.
Bevor Sie beginnen before-starting
Berechtigungen einrichten setup-permissions
Bevor Sie eine Mobile App erstellen, müssen Sie zunächst sicherstellen, dass Sie für Tags in Adobe Experience Platform die richtigen Benutzerberechtigungen haben oder diese zuweisen. Weitere Informationen finden Sie in der Dokumentation zu Tags.
Gehen Sie wie folgt vor, um die Rechte für Eigenschaft und Unternehmen zuzuweisen:
-
Greifen Sie auf Admin Console zu.
-
Wählen Sie auf der Registerkarte Produkte die Karte Datenerfassung in Adobe Experience Platform aus.
-
Wählen Sie ein vorhandenes Produktprofil aus oder erstellen Sie mit der Schaltfläche Neues Profil ein neues. Wie Sie ein neues Profil erstellen, erfahren Sie in der Dokumentation zur Admin Console.
-
Wählen Sie auf der Registerkarte Berechtigungen die Option Eigenschaftenrechte.
-
Klicken Sie auf Alle hinzufügen. Dadurch werden Ihrem Produktprofil die folgenden Rechte hinzugefügt:
- Genehmigen
- Entwickeln
- Umgebungen verwalten
- Erweiterungen verwalten
- Veröffentlichen
Diese Berechtigungen sind erforderlich, um die Adobe Journey Optimizer-Erweiterung zu installieren und zu veröffentlichen und die App-Eigenschaft im Adobe Experience Platform Mobile SDK zu veröffentlichen.
-
Wählen Sie dann im Menü links Unternehmensrechte.
-
Fügen Sie die folgenden Rechte hinzu:
- Mobile-App-Konfigurationen verwalten
- Eigenschaften verwalten
Diese Berechtigungen sind für die Entwicklerin oder den Entwickler der App erforderlich, um Push-Anmeldedaten für die Datenerfassung in Adobe Experience Platform einzurichten und Konfigurationen für Push-Benachrichtigungskanäle (d. h. Nachrichtenvoreinstellungen) in Adobe Journey Optimizer zu definieren.
-
Klicken Sie auf Speichern.
Gehen Sie wie folgt vor, um Benutzern dieses Produktprofil zuzuweisen:
-
Greifen Sie auf Admin Console zu.
-
Wählen Sie auf der Registerkarte Produkte die Karte Datenerfassung in Adobe Experience Platform aus.
-
Wählen Sie Ihr zuvor konfiguriertes Produktprofil aus.
-
Klicken Sie auf der Registerkarte Benutzer auf Benutzer hinzufügen.
-
Geben Sie den Namen oder die E-Mail-Adresse Ihres Benutzers ein und wählen Sie den Benutzer aus. Klicken Sie dann auf Speichern.
note note NOTE Wenn der Benutzer vorher noch nicht in der Admin Console erstellt wurde, lesen Sie die Dokumentation zum Hinzufügen von Benutzern.
App konfigurieren configure-app
Die technische Einrichtung erfordert eine enge Zusammenarbeit zwischen dem App-Entwickler und dem Business-Administrator. Bevor Sie mit dem Versand von Push-Benachrichtigungen über Journey Optimizer beginnen, müssen Sie push-Anmeldedaten sowie eine Push-Kanalkonfiguration in Adobe Journey Optimizer erstellen und Ihre App mit Adobe Experience Platform Mobile SDKs integrieren.
Folgen Sie den Implementierungsschritten, die in den folgenden Links beschrieben werden:
- Für Apple iOS: Erfahren Sie in der Apple-Dokumentation, wie Sie Ihre App mit APNs registrieren
- Für Google Android: In der Google-Dokumentationerfahren Sie, wie Sie eine Firebase Cloud Messaging-Client-App unter Android einrichten
Integrieren Ihrer Mobile App mit dem Adobe Experience Platform SDK integrate-mobile-app
Das Adobe Experience Platform Mobile-SDK stellt über Android- und iOS-kompatible SDKs Client-seitige Integrations-APIs für Ihre Mobile Apps bereit. Folgen Sie der Dokumentation zum Adobe Experience Platform Mobile SDK, um die Einrichtung in Ihrer App mit Adobe Experience Platform Mobile SDKs durchzuführen.
Am Ende dieses Vorgangs sollten Sie auch eine mobile Property in Adobe Experience Platform Data Collection erstellt und konfiguriert haben. Normalerweise wird für jede Mobile App, die verwaltet werden soll, eine Mobile Property erstellt. In der Dokumentation zum Adobe Experience Platform Mobile SDK erfahren Sie, wie Sie eine Mobile-Eigenschaft erstellen und konfigurieren.
Schritt 1: Hinzufügen von Push-Anmeldedaten für die App in Journey Optimizer push-credentials-launch
Nachdem Sie die richtigen Benutzerberechtigungen erteilt haben, müssen Sie jetzt Ihre Push-Anmeldedaten für Apps in Journey Optimizer hinzufügen.
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 das Menü Kanäle > Push-Einstellungen > Push-Anmeldedaten.
-
Klicken Sie auf Push-Anmeldedaten erstellen.
-
Wählen Sie aus der Dropdownliste Plattform das Betriebssystem aus:
-
Für iOS
-
Geben Sie die App-ID der App ein.
-
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.
-
Aktivieren Sie die Schaltfläche Push-Anmeldedaten manuell eingeben, um Ihre Anmeldedaten hinzuzufügen.
-
Ziehen Sie die p8-Datei mit dem Apple-Authentifizierungsschlüssel für Push-Benachrichtigungen per Drag-and-Drop in den Arbeitsbereich. Dieser Schlüssel kann von der Seite Zertifikate, Kennungen und Profile abgerufen werden.
-
Geben Sie die Key ID an. Dies ist 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.
-
Geben Sie die Team ID an. Dies ist ein Zeichenfolgenwert, der auf der Registerkarte „Abonnement“ zu finden ist.
-
-
Für Android
-
Geben Sie die App-ID an: Normalerweise ist der Package-Name die App-ID in Ihrer
build.gradle
-Datei. -
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.
-
Aktivieren sie die Schaltfläche Push-Anmeldedaten manuell eingeben, um Ihre Anmeldedaten hinzuzufügen.
-
Legen Sie die FCM-Push-Anmeldedaten per Drag-and-Drop ab. Weitere Informationen zum Abrufen der Push-Anmeldedaten finden Sie in der Google-Dokumentation.
-
-
-
Klicken Sie auf Senden, um Ihre App-Konfiguration zu erstellen.
Schritt 2: Erstellen einer Kanalkonfiguration für Push-Benachrichtigungen message-preset
Nachdem Ihre Push-Anmeldedaten erstellt haben, müssen Sie eine Konfiguration erstellen, damit Sie Push-Benachrichtigungen über Journey Optimizer senden können.
-
Öffnen Sie das Menü Kanäle > Allgemeine Einstellungen > Kanalkonfigurationen und klicken Sie dann auf Kanalkonfiguration erstellen.
-
Geben Sie einen Namen und eine Beschreibung (optional) für die Konfiguration an.
note note NOTE 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. Weitere Informationen zur Zugriffssteuerung auf Objektebene (OLAC).
-
Wählen Sie den Push-Kanal 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
-
Wählen Sie Ihre Plattform aus.
-
Wählen Sie dieselbe App-ID wie für Ihre oben konfigurierten Push-Anmeldedaten aus.
-
Speichern Sie Ihre Änderungen.
Sie können Ihre Konfiguration jetzt beim Erstellen Ihrer Push-Benachrichtigungen auswählen.
Schritt 3: Adobe Journey Optimizer-Erweiterung in Ihrer Mobile-Eigenschaft konfigurieren configure-journey-optimizer-extension
Die Adobe Journey Optimizer-Erweiterung für Adobe Experience Platform Mobile SDKs unterstützt Push-Benachrichtigungen für Ihre Mobile Apps und hilft Ihnen bei der Erfassung von Benutzer-Push-Token und der Verwaltung der Interaktionsmessung mit Adobe Experience Platform-Services.
Wie Sie die Journey Optimizer-Erweiterung einrichten, erfahren Sie in der Dokumentation zum Adobe Experience Platform Mobile SDK.
Schritt 4: Testen Sie Ihre Mobile App mit einem Ereignis mobile-app-test
Nachdem Sie Ihre Mobile App sowohl in Adobe Experience Platform als auch in Adobe Experience Platform Data Collection konfiguriert haben, können Sie sie nun testen, bevor Sie Push-Benachrichtigungen an Ihre Profile senden. In diesem Anwendungsbeispiel erstellen wir eine Journey, in der unsere Mobile App als Ziel ausgewählt und ein Ereignis festgelegt wird, das die Push-Benachrichtigung auslöst.
Damit diese Journey funktioniert, müssen Sie ein XDM-Schema erstellen. Weitere Informationen finden Sie in der Dokumentation zu XDM.
-
Klicken Sie im Menüabschnitt „DATEN-MANAGEMENT“ auf Schemata.
-
Klicken Sie auf Schema erstellen, wählen Sie oben rechts die Option Erlebnisereignis und klicken Sie auf Weiter.
-
Geben Sie einen Namen und eine Beschreibung für Ihr Schema ein und klicken Sie auf Beenden.
-
Klicken Sie im Abschnitt Feldergruppen links auf Hinzufügen und dann auf Neue Feldergruppe erstellen.
-
Geben Sie einen Anzeigenamen und eine Beschreibung ein. Klicken Sie abschließend auf Feldergruppen hinzufügen. Weitere Informationen zum Erstellen von Feldergruppen finden Sie in der XDM-Systemdokumentation.
-
Wählen Sie auf der linken Seite das Schema aus. Aktivieren Sie im rechten Bereich dieses Schema für Profil.
-
Wählen Sie auf der linken Seite die Feldergruppe aus und klicken Sie dann auf das Symbol + , um ein neues Feld zu erstellen. Geben Sie in die Feldergruppen-Eigenschaften auf der rechten Seite einen Feldnamen und einen Anzeigenamen ein und wählen Sie Zeichenfolge als Typ aus.
-
Markieren Sie Erforderlich und klicken Sie auf Anwenden.
-
Klicken Sie auf Speichern. Ihr Schema wurde erstellt und kann nun in einem Ereignis verwendet werden.
Anschließend müssen Sie ein Ereignis einrichten.
-
Wählen Sie im linken Menü der Startseite unter ADMINISTRATION Konfigurationen aus. Klicken Sie auf Verwalten im Abschnitt Ereignisse, um Ihr neues Ereignis zu erstellen.
-
Klicken Sie auf Ereignis erstellen. Der Bereich für die Ereigniskonfiguration wird auf der rechten Seite des Bildschirms geöffnet.
-
Geben Sie den Namen Ihres Ereignisses ein. Sie können auch eine Beschreibung hinzufügen.
-
Wählen Sie im Feld Ereignis-ID-Typ die Option Regelbasiert aus.
-
Wählen Sie im Abschnitt Parameter Ihr zuvor erstelltes Schema aus.
-
Überprüfen Sie in der Feldliste, ob das in der Schemafeldergruppe erstellte Feld ausgewählt ist.
-
Klicken Sie im Feld Ereignis-ID-Bedingung auf Bearbeiten. Ziehen Sie das zuvor hinzugefügte Feld per Drag-and-Drop hinüber, um zu definieren, welche Bedingung vom System zur Identifikation der Ereignisse verwendet wird, die Ihre Journey auslösen sollen.
-
Geben Sie die Syntax ein, die Sie zum Auslösen Ihrer Push-Benachrichtigung in Ihrer Test-App benötigen, in diesem Beispiel Bestellbestätigung.
-
Wählen Sie ECID als Namespace aus.
-
Klicken Sie auf OK und danach auf Speichern.
Ihr Ereignis wurde erstellt und kann jetzt in einer Journey verwendet werden.
-
Klicken Sie im linken Menü auf Journeys.
-
Klicken Sie auf Journey Erstellen, um eine neue Journey zu erstellen.
-
Bearbeiten Sie im Konfigurationsbereich auf der rechten Seite die Eigenschaften der Journey. Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Ziehen Sie zunächst das in den vorherigen Schritten erstellte Ereignis per Drag-and-Drop aus der Dropdown-Liste Ereignisse.
-
Ziehen Sie aus der Dropdown-Liste Aktionen die Aktivität Push per Drag-and-Drop auf Ihre Journey.
-
Konfigurieren Sie die Push-Benachrichtigung. Weiterführende Informationen zum Erstellen von Push-Benachrichtigungen finden Sie auf dieser Seite.
-
Klicken Sie auf den Umschalter Test, um mit dem Testen Ihrer Push-Benachrichtigungen zu beginnen, und danach auf Ereignis auslösen.
-
Geben Sie im Feld Schlüssel Ihre ECID und im zweiten Feld Bestellbestätigung ein.
-
Klicken Sie auf Senden.
Ihr Ereignis wird ausgelöst und Sie erhalten in Ihrer Mobile App eine Push-Benachrichtigung.