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.

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 der Dokumentation.

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

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

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

App-Oberfläche zur Datenerfassung hinzufügen

  1. Wählen Sie in der Datenerfassungsoberfläche im linken Bereich die Option App-Oberflächen aus.

  2. Um eine Konfiguration zu erstellen, wählen Sie App-Oberfläche erstellen aus.
    App-Oberfläche - Startseite

  3. Geben Sie einen Namen für die Konfiguration ein, z. B. Luma App Tutorial .

  4. Wählen Sie in Mobile Application Configuration die Option Apple iOS aus.

  5. Geben Sie im Feld App-ID (iOS Bundle ID) die App-Paket-ID ein. Beispiel: com.adobe.luma.tutorial.swiftui.

  6. Wählen Sie Speichern aus.

    Konfiguration der Oberfläche der App

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.

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datastreams aus und wählen Sie Ihren Datastream aus, z. B. Luma Mobile App.

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

  3. Stellen Sie im Bildschirm Datastreams > Ordner > Adobe Experience Platform sicher, dass Adobe Journey Optimizer ausgewählt ist. Weitere Informationen finden Sie unter Adobe Experience Platform-Einstellungen .

  4. Wählen Sie Speichern aus, um Ihre Datastream-Konfiguration zu speichern.

    AEP-Datastream-Konfiguration

Journey Optimizer-Tag-Erweiterung installieren

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

  1. Navigieren Sie zu Tags > Erweiterungen > Katalog.
  2. Öffnen Sie Ihre 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 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 .

NOTE
Wenn Sie den Abschnitt SDK installieren abgeschlossen haben, ist das SDK bereits installiert und Sie können diesen Schritt überspringen.
  1. Stellen Sie in Xcode sicher, dass AEP Messaging zur Liste der Pakete in Package-Abhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.

  2. Navigieren Sie im Xcode Project-Navigator zu Luma > 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
    ]
    

Validieren der Einrichtung mit Assurance

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

  2. Wählen Sie in der Assurance-Benutzeroberfläche Konfigurieren aus.
    click konfigurieren

  3. Wählen Sie die Schaltfläche Plus neben In-App-Nachrichten.

  4. Wählen Sie Speichern aus.
    save

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

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

    In-App-Validierung

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.

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

  2. Wählen Sie Kampagne erstellen aus.

  3. Im Bildschirm Kampagne erstellen :

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

    2. Wählen Sie Erstellen

      Kampagneneigenschaften

  4. 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.
    Kampagnenname

  5. Scrollen Sie nach unten zu Aktion und wählen Sie Inhalt bearbeiten aus.

  6. Im Bildschirm In-App-Nachricht:

    1. Wählen Sie Modal als Nachrichten-Layout aus.

    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 Hauptteil ein, z. B. Triggered by pushing that button in the app....

    4. Geben Sie Beenden als Text für Schaltfläche 1 (primär) ein.

    5. Beachten Sie, wie die Vorschau aktualisiert wird.

    6. Wählen Sie Überprüfen, um zu aktivieren.

      In-App-Editor

  7. Wählen Sie im Bildschirm Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) die Option Bearbeiten in der Kachel Plan aus.
    Zeitplan überprüfen Wählen Sie Plan aus

  8. Wählen Sie im Bildschirm Luma - In-App Messaging Campaign die Option Bearbeiten Trigger bearbeiten aus.

  9. Im Dialogfeld In-App-Nachricht-Trigger konfigurieren Sie die Details der Verfolgungsaktion, mit der die In-App-Nachricht Trigger wird:

    1. Um das Anwendungsstartereignis zu entfernen, wählen Sie Schließen aus.

    2. Verwenden Sie wiederholt Add Add condition (Bedingung hinzufügen), um die folgende Logik für Show message if zu erstellen.

    3. Klicken Sie auf Fertig.

      Trigger logic

    Sie haben eine Verfolgungsaktion definiert, bei der Aktion gleich in-app und die Kontextdaten mit der Aktion ein Schlüsselwertpaar von "showMessage" : "true" ist.

  10. Wählen Sie im Bildschirm Luma - In-App Messaging Campaign die Option Überprüfen, um zu aktivieren.

  11. Wählen Sie im Bildschirm Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) die Option Aktivieren.

  12. Ihr Luma - In-App Messaging Campaign mit dem Status Live wird in der Liste Kampagnen angezeigt.
    Kampagnenliste

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.

  1. 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 Funktion MobileCore.track basierend auf den Parametern action und data aufruft.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. 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

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

  2. Gehen Sie zur Registerkarte Einstellungen .

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

  1. Lesen Sie den Abschnitt Setup instructions , um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
  2. Wählen Sie In-App-Nachrichten aus.
  3. Wählen Sie Ereignisliste aus.
  4. Wählen Sie einen Eintrag für Display message aus.
  5. Inspect das Rohereignis, insbesondere das html, das das vollständige Layout und den gesamten Inhalt der In-App-Nachricht enthält.
    In-App-Bestätigungsnachricht

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.

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 das Experience Platform Mobile SDK hinzugefügt.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeine Rückmeldungen oder Anregungen zu zukünftigen Inhalten haben möchten, teilen Sie diese in diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Angebote erstellen und anzeigen

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b