DokumentationExperience PlatformTutorial für Mobile Apps

Erstellen und Senden von In-App-Nachrichten

Last update: Thu Sep 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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 {modal="regular"}

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.

NOTE
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 für Push-Benachrichtigungen. 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 Sie eine Kanalkonfiguration in Journey Optimizer.
  • 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

TIP
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

Zunächst müssen Sie eine Kanalkonfiguration erstellen, damit Sie über Journey Optimizer Benachrichtigungen zu Mobile Apps senden können.

  1. Öffnen Sie in der Journey Optimizer-Benutzeroberfläche das Menü Kanäle > Allgemeine Einstellungen > Kanalkonfigurationen und wählen Sie dann Kanalkonfiguration erstellen.

  2. Geben Sie einen Namen und eine Beschreibung (optional) für die Konfiguration ein. Zum Beispiel LumaInAppMessaging und Channel for in-app messaging.

    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.

  3. Um der Konfiguration benutzerdefinierte oder grundlegende Datennutzungs-Labels zuzuweisen, können Sie Zugriff verwalten auswählen. Erfahren Sie mehr über die Zugriffssteuerung auf Objektebene (Object Level Access Control, OLAC).

  4. Wählen Sie den In-App-Messaging Kanal aus.

  5. Wählen Sie Marketing-Aktion, um mit dieser Konfiguration Einverständnisrichtlinien mit den Nachrichten zu verknüpfen. Alle mit der Marketing-Aktion verknüpften Einverständnisrichtlinien werden genutzt, um die Voreinstellungen Ihrer Kundinnen und Kunden zu berücksichtigen. Weitere Informationen zu Marketing-Aktionen. Beispiel: Push-Targeting.

  6. Wählen Sie die Plattform aus, für die Sie die Einstellungen definieren möchten. Mit dieser Einstellung können Sie die Ziel-App für jede Plattform angeben und eine konsistente Inhaltsbereitstellung über mehrere Plattformen hinweg sicherstellen.

    note note
    NOTE
    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.

  7. Geben Sie die App-IDs für die Plattform ein, die Sie unterstützen möchten.

    Erstellen einer Kanalkonfiguration {modal="regular"}

  8. 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.

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datenströme und wählen Sie Ihren Datenstrom aus, z. B. Luma Mobile App.

  2. Wählen Sie Mehr für Experience Platform und wählen Sie Bearbeiten Bearbeiten aus dem Kontextmenü.

  3. Stellen Sie Bildschirm Datenströme“ > Ordner > Adobe Experience Platform sicher, dass Adobe Journey Optimizer ausgewählt ist. Weitere Informationen finden Sie unter {}Adobe Experience Platform-Einstellungen.

  4. Um Ihre Datenstromkonfiguration zu speichern, wählen Sie Speichern aus.

    Konfiguration des AEP-Datenstroms {modal="regular"}

Installieren der Journey Optimizer Tags-Erweiterung

Damit Ihre App mit Journey Optimizer verwendet werden kann, müssen Sie Ihre Tag-Eigenschaft aktualisieren.

  1. Navigieren Sie Tags > Erweiterungen > Katalog.
  2. Öffnen Sie die Eigenschaft, z. B. Luma Mobile App Tutorial.
  3. Wählen Sie Katalog aus.
  4. Suchen Sie nach der Erweiterung Adobe Journey Optimizer.
  5. 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 die Lektion Push-Benachrichtigungen im Tutorial bereits befolgt haben, sehen Sie, dass für die Entwicklungs-Umgebung der AJO Push-Tracking-Erlebnisereignis-Datensatz aus der Liste Ereignisdatensatz 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.

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

  1. Stellen Sie in Xcode sicher, dass AEP Messaging zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.

  2. Navigieren Sie im Xcode-Projekt Luma Navigator zu Luma > > AppDelegate.

  3. Stellen Sie sicher, dass AEPMessaging Teil Ihrer Importliste ist.

    import AEPMessaging

  4. 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
]
Android

  1. Stellen Sie in Android Studio sicher, dass aepsdk-messaging-android) Teil der Abhängigkeiten in build.gradle.kts in Android ChevronDown > Gradle Scripts ist. Siehe Gradle.

  2. Navigieren Sie zu Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication im Android Studio-Projektnavigator.

  3. Stellen Sie sicher, dass com.adobe.marketing.mobile.Messaging Teil Ihrer Importliste ist.

    import import com.adobe.marketing.mobile.Messaging

  4. Stellen Sie sicher, dass Messaging.EXTENSION Teil des Arrays von Erweiterungen ist, die Sie registrieren.

    code language-kotlin 
    val extensions = listOf(
    Identity.EXTENSION,
    Lifecycle.EXTENSION,
    Signal.EXTENSION,
    Edge.EXTENSION,
    Consent.EXTENSION,
    UserProfile.EXTENSION,
    Places.EXTENSION,
    Messaging.EXTENSION,
    Optimize.EXTENSION,
    Assurance.EXTENSION
)

Überprüfen des Setups mit Assurance

  1. Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. Wählen Sie in der Assurance-Benutzeroberfläche Konfigurieren aus.
    Klick konfigurieren {modal="regular"}

  3. Klicken Sie auf die Plus -Schaltfläche neben In-App-Messaging.

  4. Wählen Sie Speichern aus.
    Speichern {modal="regular"}

  5. Wählen Sie In-App-) im linken Navigationsbereich aus.

  6. Wählen Sie die Validierung aus. Vergewissern Sie sich, dass Sie keine Fehler erhalten.

    In-App-Validierung {modal="regular"}

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 an alle SDK-Erweiterungen von Mobile Platform gebunden ist. Der Event Hub verwaltet eine Liste registrierter Erweiterungen und interner Module, eine Liste registrierter 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, verarbeitet der Event Hub alle Anfragen und Interaktionen mit dem Angebotsmodul Journey Optimizer - Entscheidungs-Management .

  1. Wählen Sie in der Journey Optimizer-Benutzeroberfläche Kampagnen in der linken Leiste aus.

  2. Wählen Sie Kampagne erstellen aus.

  3. Wählen Dialogfeld „Kampagne erstellen die Option Uhr Geplant - Marketing und wählen Sie Bestätigen.

  4. Im Bildschirm Kampagne - JJJJ-MM-TT HHSS UTC+XX:XX:

    1. Auf der Registerkarte Eigenschaften:

      1. Geben Sie einen Namen für die Kampagne ein, z. B. Luma Mobile In-App Campaign.
      2. Fügen Sie optional eine Beschreibung hinzu.

    2. Wählen Sie die Aktion aus.

      1. Wählen Sie unter Meldung anzeigen, wenn die Option Hinzufügen Aktion hinzufügen aus. Wählen Sie aus dem Dropdown-Menü In-App-Nachricht aus.

      2. Wählen Sie im Dropdown Menü Konfiguration von In-App-Nachrichten“ Ihre Konfiguration aus. Beispiel: LumaInAppMessaging.

      3. Wählen Sie Bearbeiten Trigger bearbeiten aus.

      4. Im In-App-Nachrichten-Trigger Dialogfeld:

        1. Wählen Sie Anwendungsstart und wählen Sie Aktion nachverfolgen aus dem Dropdown-Menü aus.

        2. Wählen Sie AddCircle Bedingung hinzufügen.

        3. Wählen Aktion und gleich aus den Dropdown-Menüs aus.

        4. in-app eingeben.

        5. Wählen Sie AddCircle Bedingung hinzufügen.

        6. Wählen Sie Kontextdaten aus dem Dropdown-Menü aus und geben Sie showMessage ein.

        7. Wählen gleich aus dem Dropdown-Menü aus und geben Sie true ein.

          Trigger bearbeiten {modal="regular"}

        8. Wählen Sie Fertig aus.

    3. Wählen Sie im Hauptbildschirm der Kampagnendefinition die Registerkarte Inhalt aus.

      1. Aktivieren Sie Erweiterte Formatierung.

      2. Wählen Sie Modal als Messaging-Layout. Wählen Sie im Dialogfeld Layout wechseln die Option Layout ändern aus.

      3. Auf der Registerkarte Inhalt.

        1. Geben Sie https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png für die Medien-URL ein.
        2. 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....

        In-App-Nachrichteninhalt {modal="regular"}

      4. Wählen Sie Registerkarte Einstellungen“ aus.

        1. Wählen Sie Größe anpassen in Nachricht aus.
        2. Deaktivieren Sie An Inhalt anpassen.
        3. Legen Sie Höhe auf 75% fest.

        In-App-Nachrichteneinstellungen {modal="regular"}

  5. Wählen Sie Zum Aktivieren überprüfen aus. Um optional eine der Konfigurationen für Inhalt, Eigenschaften, Aktionen oder mehr zu bearbeiten, wählen Sie Bearbeiten .

  6. Wählen Sie Bildschirm Zu aktivierendes Kampagnenname die Option Aktivieren.

  7. Nach einiger Zeit wird Ihr Kampagnenname mit Status Live in der Liste Kampagnen.
    Kampagnenliste {modal="regular"}

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.

iOS

  1. 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.

    code language-swift 
    // Send trackAction event
MobileCore.track(action: action, data: data)

  2. 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"])
}
Android

  1. Wechseln Sie zu Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK im Android Studio-Navigator. Suchen Sie die Funktion fun sendTrackAction(action: String, data: Map<String, String>?) und fügen Sie den folgenden Code hinzu, der die Funktion MobileCore.track aufruft, basierend auf den Parametern action und data.

    code language-kotlin 
    // Send trackAction event
MobileCore.track(action, data)

  2. Wechseln Sie zu Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt im Android Studio-Navigator. Suchen Sie den Code für die Schaltfläche „Handler onInAppMessageClick" und fügen Sie den folgenden Code hinzu:

    code language-kotlin 
    // Setting parameters and calling function to send in-app message
MobileSDK.shared.sendTrackAction(
    "in-app",
    mapOf("showMessage" to "true")
)

Validieren mit der App

Sie können die In-App-Nachrichten innerhalb der App selbst validieren.

iOS

  1. Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Xcode mithilfe von Play aus.

  2. Navigieren Sie zur Registerkarte Einstellungen.

  3. Tippen Sie auf In-App-Nachricht. Die In-App-Nachricht wird nun in der App angezeigt.

    {width="300"}

Android

  1. Erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Android Studio mithilfe von Play aus.

  2. Navigieren Sie zur Registerkarte Einstellungen.

  3. Tippen Sie auf In-App-Nachricht. Die In-App-Nachricht wird nun in der App angezeigt.

    {width="300"}

Implementierung in Assurance validieren

Sie können Ihre In-App-Nachrichten über die Benutzeroberfläche von Assurance validieren.

  1. Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. Wählen Sie In-App-Messaging aus.

  3. Wählen Sie Ereignisliste aus.

  4. Wählen Sie einen Nachricht anzeigen-Eintrag aus.

  5. Überprüfen Sie das Rohereignis, insbesondere das html, das das vollständige Layout und den Inhalt der In-App-Nachricht enthält.

    Assurance-In-App-Nachricht {modal="regular"}

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
9fed61f5-c338-47ad-8005-0b89a5f4af8b