Dokumentation Experience Platform Tutorial für Mobile Apps

Erstellen und Senden von In-App-Nachrichten

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

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.

Architektur

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.

HINWEIS

Diese Lektion ist optional und gilt nur für Journey Optimizer-Benutzende, die In-App-Nachrichten senden möchten.

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

TIPP

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

Erstellen einer Kanalkonfiguration in Journey Optimizer

Zunächst müssen Sie eine Kanalkonfiguration erstellen, damit Sie über Journey Optimizer Benachrichtigungen zu Mobile Apps senden 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 In-App-Messaging 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 zu Marketing-Aktionen.
Wählen Sie die Plattform aus, für die Sie die Einstellungen definieren möchten. Auf diese Weise können Sie die Ziel-App für jede Plattform festlegen und eine konsistente Inhaltsbereitstellung über mehrere Plattformen hinweg sicherstellen.

HINWEIS
Bei iOS- und Android-Plattformen basiert der Versand ausschließlich auf der App-ID. Wenn beide Apps dieselbe App-ID verwenden, werden Inhalte für beide bereitgestellt, unabhängig von der in der Kanalkonfiguration ausgewählten Plattform.
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 für Experience Platform und wählen Sie Bearbeiten aus dem Kontextmenü.
Stellen Sie Bildschirm Datenströme“ > > Adobe Experience Platform sicher, dass Adobe Journey Optimizer ausgewählt ist. 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 .

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.

HINWEIS

Wenn Sie den Abschnitt Installieren von SDKs abgeschlossen haben, ist die SDK bereits installiert und Sie können diesen Schritt überspringen.

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.

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 -Schaltfläche neben In-App-Messaging.
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:
1. Wählen Sie In-App-Nachricht und wählen Sie eine Programmoberfläche aus der Liste Programmoberfläche, z. B. Luma Mobile App.
2. 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:
1. Wählen Sie Modal als Nachrichten-Layout.
2. Geben Sie https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png für die Medien-URL ein.
3. 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....
4. Geben Sie Schließen als Schaltflächen-#1 (primär) ein.
5. Beachten Sie, wie die Vorschau aktualisiert wird.
6. Wählen Sie Zum Aktivieren überprüfen aus.
Wählen im Bildschirm Zu aktivierende Überprüfung (Luma - In-App-Messaging-Kampagne) die Option in der Kachel Zeitplan aus.
Zurück im Luma - In-App Messaging Campaign wählen Sie Trigger bearbeiten.
Im Dialogfeld In-App-Nachrichten-Trigger konfigurieren Sie die Details der Tracking-Aktion, mit der die In-App-Nachricht Trigger wird:
1. Um das Anwendungsstartereignis“ zu entfernen wählen Sie aus.
2. Verwenden Sie Bedingung hinzufügen wiederholt, um die folgende Logik für "Meldung anzeigen, wenn zu erstellen.
3. 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 Funktion MobileCore.track aufruft, basierend auf den Parametern action und data.
// 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:
// 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 aus.
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.
Überprüfen Sie das Rohereignis, 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.

SUCCESS

Sie haben die App für In-App-Nachrichten aktiviert und eine In-App-Nachrichtenkampagne mit Journey Optimizer und der Journey Optimizer-Erweiterung für Experience Platform Mobile SDK hinzugefügt.

Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese auf diesem Experience League Community-Diskussionsbeitrag.

Weiter: Angebote erstellen und anzeigen

recommendation-more-help