Erstellen und Senden von In-App-Nachrichten
Erfahren Sie, wie Sie In-App-Nachrichten für Mobile Apps mit Experience Platform Mobile SDK und Journey Optimizer erstellen.
Mit Journey Optimizer können Sie Kampagnen erstellen, um In-App-Nachrichten an ausgewählte Zielgruppen zu senden. Kampagnen in Journey Optimizer werden verwendet, um einmalige Inhalte mithilfe verschiedener Kanäle für eine bestimmte Zielgruppe bereitzustellen. Bei Kampagnen werden Aktionen gleichzeitig ausgeführt, entweder sofort oder nach einem festgelegten Zeitplan. Bei Verwendung von Journey (siehe Lektion Journey Optimizer-PushBenachrichtigungen) werden die Aktionen nacheinander ausgeführt.
Bevor Sie In-App-Nachrichten mit Journey Optimizer senden, müssen Sie sicherstellen, dass die richtigen Konfigurationen und Integrationen vorhanden sind. Informationen zum Datenfluss von In-App-Nachrichten in Journey Optimizer finden Sie in Dokumentation.
Voraussetzungen
- App mit installierten und konfigurierten SDKs erfolgreich erstellt und ausgeführt.
- Richten Sie die App für Adobe Experience Platform ein.
- Zugriff auf Journey Optimizer und ausreichende Berechtigungen wie hier beschrieben. Außerdem benötigen Sie ausreichende Berechtigungen für die folgenden Journey Optimizer-Funktionen.
- Verwalten von Kampagnen.
- Physikalisches iOS-Gerät oder Simulator für Tests.
Lernziele
In dieser Lektion werden Sie
- Erstellen einer App-Oberfläche in AJO.
- 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.
- Definieren Sie Ihr eigenes Kampagnen- und In-App-Nachrichtenerlebnis in Journey Optimizer.
- Senden Sie Ihre eigene In-App-Nachricht aus der App heraus.
Einrichten
Hinzufügen einer Programmoberfläche in der Datenerfassung
-
Wählen Sie in Datenerfassungsoberfläche im linken 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 unter „Konfiguration von Mobile" die Option Apple iOS aus.
-
Geben Sie die Bundle ID der Mobile App im Feld App ID (iOS Bundle ID) ein. Beispiel:
com.adobe.luma.tutorial.swiftui
. -
Wählen Sie Speichern aus.
Aktualisieren der Datenstromkonfiguration
Um sicherzustellen, dass Daten von Ihrer Mobile App an das Edge Network Journey Optimizer weitergeleitet werden, aktualisieren Sie Ihre Experience Edge-Konfiguration.
-
Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datenströme und wählen Sie Ihren Datenstrom aus, z. B. Luma Mobile App.
-
Experience Platform Wählen Sie
-
Stellen Sie Bildschirm Datenströme“ >
-
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 .
Wenn nur In-App-Nachrichten in Ihrer App, in Erweiterung installieren oder Erweiterung konfigurieren, müssen Sie nichts konfigurieren. Wenn Sie jedoch bereits die Lektion Push-Benachrichtigungen im Tutorial befolgt haben, sehen Sie, dass für die Entwicklungs-Umgebung der AJO Push-Tracking-Erlebnisereignis-Datensatz aus der Liste Ereignisdatensatz ausgewählt ist.
Implementieren von Journey Optimizer in der App
Wie in den vorherigen Lektionen erläutert, wird bei der Installation einer mobilen Tag-Erweiterung nur die Konfiguration bereitgestellt. Als Nächstes müssen Sie Messaging SDK installieren und registrieren. Wenn diese Schritte nicht klar sind, lesen Sie den Abschnitt Installieren von SDKs.
-
Stellen Sie in Xcode sicher dass „AEP Messaging zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.
-
Navigieren Sie im Xcode-Projekt 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.code language-swift 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 ]
Ü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.
-
Klicken Sie auf die
-
Wählen Sie Speichern aus.
-
Wählen Sie In-App-) im linken Navigationsbereich aus.
-
Wählen Sie die Validierung aus. Vergewissern Sie sich, dass Sie keine Fehler erhalten.
Erstellen einer eigenen In-App-Nachricht
Um eine eigene In-App-Nachricht zu erstellen, müssen Sie eine Kampagne in Journey Optimizer definieren, über die Trigger eine In-App-Nachricht basierend auf eingetretenen Ereignissen erstellen. Diese Ereignisse können sein:
- Daten an Adobe Experience Platform gesendet,
- Core-Tracking-Ereignisse wie Aktion, Status oder Sammlung von personenbezogenen Daten über die generischen Mobile Core-APIs,
- Anwendungslebenszyklusereignisse wie Start, Installation, Upgrade, Schließen oder Absturz,
- Geolocation-Ereignisse, wie das Betreten oder Verlassen eines Points of Interest.
In diesem Tutorial verwenden Sie die generischen und erweiterungsunabhängigen APIs von Mobile Core (siehe Generische Mobile Core-APIs), um das Ereignis-Tracking von Benutzerbildschirmen, Aktionen und PII-Daten zu erleichtern. Von diesen APIs generierte Ereignisse werden im SDK Event Hub veröffentlicht und stehen Erweiterungen zur Verfügung. Der SDK Event Hub bietet die zentrale Datenstruktur, die mit allen SDK-Erweiterungen für Mobilplattformen verbunden ist. Er verwaltet eine Liste der registrierten Erweiterungen und internen Module, eine Liste der registrierten Ereignis-Listener und eine freigegebene Statusdatenbank.
Der SDK Event Hub veröffentlicht und empfängt Ereignisdaten von registrierten Erweiterungen, um die Integration mit Adobe- und Drittanbieterlösungen zu vereinfachen. Wenn beispielsweise die Erweiterung „Optimieren“ installiert ist, werden alle Anfragen und Interaktionen mit dem Angebotsmodul von Journey Optimizer - Entscheidungs-Management vom Event Hub verarbeitet.
-
Wählen Sie in der Journey Optimizer-Benutzeroberfläche Kampagnen in der linken Leiste aus.
-
Wählen Sie Kampagne erstellen aus.
-
Im Bildschirm Kampagne erstellen:
-
Wählen Sie In-App-Nachricht und wählen Sie eine Programmoberfläche aus der Liste Programmoberfläche, z. B. Luma Mobile App.
-
Wählen Sie Erstellen
-
-
Geben Sie im Bildschirm der Kampagnendefinition unter Eigenschaften einen Namen für die Kampagne, z. B.
Luma - In-App Messaging Campaign
, und einen Beschreibung z. B.In-app messaging campaign for Luma app
ein.
-
Scrollen Sie nach unten Aktion und wählen Sie Inhalt bearbeiten aus.
-
Im Bildschirm In-App-Nachricht:
-
Wählen Sie Modal als Nachrichten-Layout.
-
Geben Sie
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
für die Medien-URL ein. -
Geben Sie einen Header ein, z. B.
Welcome to this Luma In-App Message
, und geben Sie einen Body ein, z. B.Triggered by pushing that button in the app...
. -
Geben Sie Schließen als Schaltflächen-#1 (primär) ein.
-
Beachten Sie, wie die Vorschau aktualisiert wird.
-
Wählen Sie Zum Aktivieren überprüfen aus.
-
-
Wählen im Bildschirm Zu aktivierende Überprüfung (Luma - In-App-Messaging-Kampagne) die Option
-
Zurück im Luma - In-App Messaging Campaign wählen Sie
-
Im Dialogfeld In-App-Nachrichten-Trigger konfigurieren Sie die Details der Tracking-Aktion, mit der die In-App-Nachricht Trigger wird:
-
Um das Anwendungsstartereignis“ zu entfernen wählen Sie
-
Verwenden Sie
-
Klicken Sie auf Fertig.
Sie haben eine Verfolgungsaktion definiert, bei der Aktion gleich
in-app
ist und die Kontextdaten mit der Aktion ein Schlüssel-Wert-Paar von"showMessage" : "true"
ist. -
-
Wählen Sie zurück im Luma - In-App Messaging Campaign die Option Zum Aktivieren überprüfen aus.
-
Wählen Sie Bildschirm Zu aktivierende Überprüfung (Luma - In-App-Messaging-Kampagne) die Option Aktivieren aus.
-
Ihre Luma - In-App Messaging Campaign mit dem Status Live wird in der Liste Kampagnen angezeigt.
Trigger der In-App-Nachricht
Sie verfügen über alle Voraussetzungen, um eine In-App-Nachricht zu senden. Übrig bleibt, wie Sie diese In-App-Nachricht in Ihrer App Trigger haben.
-
Wechseln Sie zu Luma > Luma > Utils > MobileSDK im Xcode-Projekt-Navigator. Suchen Sie die Funktion
func sendTrackAction(action: String, data: [String: Any]?)
und fügen Sie den folgenden Code hinzu, der die FunktionMobileCore.track
aufruft, basierend auf den Parameternaction
unddata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Wechseln Sie zu Luma > Luma > Views > General > ConfigView im Xcode-Projekt-Navigator. Suchen Sie den Code für die Schaltfläche In-App-Nachricht und fügen Sie den folgenden Code hinzu:
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
Validieren mit der App
-
Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Xcode mithilfe von
-
Navigieren Sie zur Registerkarte Einstellungen.
-
Tippen Sie auf In-App-Nachricht. Die In-App-Nachricht wird nun in der App angezeigt.
Implementierung in Assurance validieren
Sie können Ihre In-App-Nachrichten über die Benutzeroberfläche von Assurance validieren.
- Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
- Wählen Sie In-App-Messaging aus.
- Wählen Sie Ereignisliste aus.
- Wählen Sie einen Nachricht anzeigen-Eintrag aus.
- Inspect : Das Raw-Ereignis, insbesondere das
html
, das das vollständige Layout und den Inhalt der In-App-Nachricht enthält.
Nächste Schritte
Sie sollten jetzt über alle Tools verfügen, um ggf. In-App-Nachrichten hinzuzufügen. Beispielsweise die Förderung von Produkten basierend auf bestimmten Interaktionen, die Sie in Ihrer App verfolgen.
Weiter: Angebote erstellen und anzeigen