In-App-Nachrichten erstellen und senden
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 Zielgruppen zu senden. Kampagnen in Journey Optimizer werden verwendet, um einmalige Inhalte mithilfe verschiedener Kanäle an eine bestimmte Zielgruppe zu senden. Bei Kampagnen werden Aktionen gleichzeitig, entweder sofort oder basierend auf einem festgelegten Zeitplan ausgeführt. Bei Verwendung von Journey (siehe Lektion Journey Optimizer-Push-Benachrichtigungen ) 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 der Dokumentation.
Voraussetzungen
- App erfolgreich erstellt und ausgeführt, wobei SDKs installiert und konfiguriert sind.
- Richten Sie die App für Adobe Experience Platform ein.
- Zugriff auf Journey Optimizer und ausreichende Berechtigungen wie in hier beschrieben. Außerdem benötigen Sie ausreichende Berechtigungen für die folgenden Journey Optimizer-Funktionen.
- Verwalten Sie Kampagnen.
- Physisches iOS-Gerät oder Simulator zum Testen.
Lernziele
In dieser Lektion werden Sie
- Erstellen Sie eine App-Oberfläche in AJO.
- Installieren und konfigurieren Sie die Journey Optimizer-Tag-Erweiterung.
- Aktualisieren Sie Ihre App, um die Journey Optimizer-Tag-Erweiterung zu registrieren.
- Validieren Sie die Einrichtung 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
App-Oberfläche zur Datenerfassung hinzufügen
-
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
. -
Wählen Sie Speichern aus.
Aktualisierung der Konfiguration des Datenspeichers
Um sicherzustellen, dass Daten, die von Ihrer App an das Edge Network gesendet werden, an Journey Optimizer weitergeleitet werden, aktualisieren Sie Ihre Experience Edge-Konfiguration.
-
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ü.
-
Stellen Sie im Bildschirm Datastreams > > Adobe Experience Platform sicher, dass Adobe Journey Optimizer ausgewählt ist. Weitere Informationen finden Sie unter Adobe Experience Platform-Einstellungen .
-
Wählen Sie Speichern aus, um Ihre Datastream-Konfiguration zu speichern.
Journey Optimizer-Tag-Erweiterung installieren
Damit Ihre App mit Journey Optimizer verwendet werden kann, müssen Sie Ihre Tag-Eigenschaft aktualisieren.
- 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.
Wenn nur In-App-Nachrichten in Ihrer App verwendet, müssen Sie in Install Extension oder Configure Extension nichts konfigurieren. Wenn Sie jedoch bereits die Lektion Push-Benachrichtigungen im Tutorial befolgt haben, sehen Sie, dass für die Umgebung Entwicklung der Datensatz AJO Push Tracking Experience Event Datensatz aus der Liste Ereignisdatensatz ausgewählt ist.
Implementieren von Journey Optimizer in die App
Wie in den vorherigen Lektionen erläutert, bietet die Installation einer mobilen Tag-Erweiterung nur die Konfiguration. Als Nächstes müssen Sie das Messaging SDK installieren und registrieren. Wenn diese Schritte nicht klar sind, lesen Sie den Abschnitt SDKs installieren .
-
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.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 ]
Validieren der Einrichtung mit Assurance
-
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 die Schaltfläche neben In-App-Nachrichten.
-
Wählen Sie Speichern aus.
-
Wählen Sie im linken Navigationsbereich In-App-Nachrichten aus.
-
Wählen Sie die Registerkarte Validierung aus. Vergewissern Sie sich, dass keine Fehler auftreten.
Erstellen einer eigenen In-App-Nachricht
Um eine eigene In-App-Nachricht zu erstellen, müssen Sie eine Kampagne in Journey Optimizer definieren, in der eine In-App-Nachricht auf der Grundlage der Ereignisse Trigger wird. Diese Ereignisse können:
- an Adobe Experience Platform gesendete Daten,
- Core-Tracking-Ereignisse wie Aktionen oder Status oder Erfassung von PII-Daten über die generischen Mobile Core-APIs,
- Anwendungslebenszyklusereignisse wie Start, Installation, Aktualisierung, Schließen oder Absturz,
- Geolocation-Ereignisse, z. B. das Eintreten oder Beenden eines Zielpunkts.
In diesem Tutorial verwenden Sie die generischen und erweiterungsunabhängigen Mobile Core-APIs (siehe Mobile Core-APIs), um die Ereignisverfolgung von Benutzerbildschirmen, Aktionen und PII-Daten zu erleichtern. Von diesen APIs generierte Ereignisse werden in den SDK-Ereignis-Hub veröffentlicht und können von Erweiterungen verwendet werden. Der SDK-Ereignis-Hub bietet die Kerndatenstruktur, die mit allen Mobile Platform SDK-Erweiterungen verknüpft ist, und verwaltet eine Liste registrierter Erweiterungen und interner Module, eine Liste registrierter Ereignis-Listener und eine freigegebene Statusdatenbank.
Der SDK-Ereignis-Hub veröffentlicht und empfängt Ereignisdaten von registrierten Erweiterungen, um die Integration mit Adobe- und Drittanbieterlösungen zu vereinfachen. Wenn beispielsweise die Optimize-Erweiterung installiert ist, werden alle Anforderungen und Interaktionen mit dem Journey Optimizer - Decision Management-Angebotsmodul vom Event Hub verarbeitet.
-
Wählen Sie in der Journey Optimizer-Benutzeroberfläche in der linken Leiste Kampagnen aus.
-
Wählen Sie Kampagne erstellen aus.
-
Im Bildschirm Kampagne erstellen :
-
Wählen Sie In-App-Nachricht und wählen Sie eine App-Oberfläche aus der Liste App-Oberfläche aus, z. B. Luma Mobile App.
-
Wählen Sie Erstellen
-
-
Geben Sie im Bildschirm "Kampagnendefinition"unter Eigenschaften einen Namen für die Kampagne ein, z. B.
Luma - In-App Messaging Campaign
, und eine Beschreibung, z. B.In-app messaging campaign for Luma app
.
-
Scrollen Sie nach unten zu Aktion und wählen Sie Inhalt bearbeiten aus.
-
Im Bildschirm In-App-Nachricht:
-
Wählen Sie Modal als Nachrichten-Layout aus.
-
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 Hauptteil ein, z. B.Triggered by pushing that button in the app...
. -
Geben Sie Beenden als Text für Schaltfläche 1 (primär) ein.
-
Beachten Sie, wie die Vorschau aktualisiert wird.
-
Wählen Sie Überprüfen, um zu aktivieren.
-
-
Wählen Sie im Bildschirm Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) die Option in der Kachel Plan aus.
-
Wählen Sie im Bildschirm Luma - In-App Messaging Campaign die Option Trigger bearbeiten aus.
-
Im Dialogfeld In-App-Nachricht-Trigger konfigurieren Sie die Details der Verfolgungsaktion, mit der die In-App-Nachricht Trigger wird:
-
Um das Anwendungsstartereignis zu entfernen, wählen Sie aus.
-
Verwenden Sie wiederholt Add condition (Bedingung hinzufügen), um die folgende Logik für Show message if zu erstellen.
-
Klicken Sie auf Fertig.
Sie haben eine Verfolgungsaktion definiert, bei der Aktion gleich
in-app
und die Kontextdaten mit der Aktion ein Schlüsselwertpaar von"showMessage" : "true"
ist. -
-
Wählen Sie im Bildschirm Luma - In-App Messaging Campaign die Option Überprüfen, um zu aktivieren.
-
Wählen Sie im Bildschirm Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) die Option Aktivieren.
-
Ihr 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 nötigen Ressourcen, um eine In-App-Nachricht zu senden. Es bleibt jedoch die Möglichkeit, diese In-App-Nachricht in Ihrer App Trigger.
-
Navigieren Sie im Xcode-Projektnavigator zu Luma > Luma > Utils > MobileSDK . Suchen Sie die Funktion
func sendTrackAction(action: String, data: [String: Any]?)
und fügen Sie den folgenden Code hinzu, der die FunktionMobileCore.track
basierend auf den Parameternaction
unddata
aufruft.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Wechseln Sie im Xcode Project Navigator zu Luma > Luma > Views > General > ConfigView . 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 Ihrer App
-
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 In-App-Nachricht. Die In-App-Nachricht wird in Ihrer App angezeigt.
{width="300"}
Validieren der Implementierung in Assurance
Sie können Ihre In-App-Nachrichten in der Assurance-Benutzeroberfläche validieren.
- Lesen Sie den Abschnitt Setup instructions , um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
- Wählen Sie In-App-Nachrichten aus.
- Wählen Sie Ereignisliste aus.
- Wählen Sie einen Eintrag für Display message aus.
- Inspect das Rohereignis, insbesondere das
html
, das das vollständige Layout und den gesamten Inhalt der In-App-Nachricht enthält.
Nächste Schritte
Sie sollten jetzt über alle Tools verfügen, um gegebenenfalls In-App-Nachrichten hinzuzufügen. Beispielsweise die Promotion von Produkten basierend auf bestimmten Interaktionen, die Sie in Ihrer App verfolgen.
Weiter: Angebote erstellen und anzeigen