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 der Verwendung von Journey (siehe Journey Optimizer-Push-Benachrichtigungen Lektion), werden 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 unter die 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 beschrieben here. 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 als Teil der Push-Nachrichten in Journey Optimizer -Lektion verwenden, haben Sie möglicherweise bereits einige der Schritte in diesem Einrichtungsabschnitt ausgeführt.

App-Oberfläche zur Datenerfassung hinzufügen

  1. Aus dem Datenerfassungsoberflächeauswählen App-Oberflächen im linken Bereich.

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

  3. Geben Sie einen Name für die Konfiguration, beispielsweise Luma App Tutorial .

  4. Von Konfiguration von Mobile Apps auswählen Apple iOS.

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

  6. Wählen Sie Speichern aus.

    App-Oberflächenkonfiguration

Aktualisierung der Konfiguration des Datenspeichers

Um sicherzustellen, dass Daten, die von Ihrer mobilen App an das Edge-Netzwerk gesendet werden, an Journey Optimizer weitergeleitet werden, aktualisieren Sie Ihre Experience Edge-Konfiguration.

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

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

  3. Im Datenspeicher > Ordner > Adobe Experience Platform Bildschirm, stellen Sie sicher Adobe Journey Optimizer ausgewählt ist. Siehe Adobe Experience Platform-Einstellungen für weitere Informationen.

  4. Wählen Sie zum Speichern Ihrer Datastream-Konfiguration Speichern.

    AEP-Datenspeicherkonfiguration

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, beispielsweise Luma Mobile App Tutorial.
  3. Auswählen Katalog.
  4. Suchen Sie nach Adobe Journey Optimizer -Erweiterung.
  5. Installieren Sie die -Erweiterung.

Wann only Verwenden von In-App-Nachrichten in Ihrer App, in Installieren der Erweiterung oder Erweiterung konfigurieren, müssen Sie nichts konfigurieren. Wenn Sie jedoch bereits die Push-Benachrichtigungen Lektion im Tutorial sehen Sie, dass für die Entwicklung Umgebung, AJO Push Tracking Erlebnis-Datensatz Der Datensatz wird aus der Ereignis-Datensatz Liste.

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, überprüfen Sie die SDKs installieren Abschnitt.

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

  2. Navigieren Sie zu Luma > Luma > AppDelegate im Xcode-Projektnavigator.

  3. Sichern AEPMessaging ist Teil Ihrer Importliste.

    import AEPMessaging

  4. Sichern Messaging.self ist Teil des Arrays von Erweiterungen, 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. Überprüfen Sie die Einrichtungsanweisungen -Abschnitt, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. Wählen Sie in der Assurance-Benutzeroberfläche die Option Konfigurieren.
    configure click

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

  4. Wählen Sie Speichern aus.
    Speichern

  5. Auswählen In-App-Nachrichten über die linke Navigation.

  6. Wählen Sie die Validierung Registerkarte. 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 Generische Mobile Core-APIs), um die Ereignisverfolgung für Benutzerbildschirme, 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 die Option Kampagnen über die linke Leiste.

  2. Auswählen Kampagne erstellen.

  3. Im Kampagne erstellen screen:

    1. Auswählen In-App-Nachricht und wählen Sie eine App-Oberfläche aus dem Anwendungsoberfläche beispielsweise Liste Luma Mobile App.

    2. Auswählen Erstellen

      Kampagneneigenschaften

  4. Gehen Sie im Bildschirm zur Kampagnendefinition zu Eigenschaften eingeben, Name beispielsweise für die Kampagne Luma - In-App Messaging Campaignund ein Beschreibung, beispielsweise In-app messaging campaign for Luma app.
    Kampagnenname

  5. Nach unten scrollen zu Aktion und wählen Sie Inhalt bearbeiten.

  6. Im In-App-Nachricht screen:

    1. Auswählen Modal als Nachrichtenlayout.

    2. Eingabe https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png für die Medien-URL.

    3. Geben Sie einen Kopfzeile, beispielsweise Welcome to this Luma In-App Message und geben Sie einen body, beispielsweise Triggered by pushing that button in the app....

    4. Eingabe Verwerfen als Schaltfläche 1 Text (primär).

    5. Beachten Sie, wie die Vorschau aktualisiert wird.

    6. Auswählen Aktivieren.

      In-App-Editor

  7. Im Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) Bildschirm, auswählen Bearbeiten im Zeitplan Kachel.
    Zeitplan überprüfen: Zeitplan auswählen

  8. Zurück im Luma - In-App Messaging Campaign Bildschirm, auswählen Bearbeiten Trigger bearbeiten.

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

    1. Entfernen Anwendungsstartereignis auswählen Schließen .

    2. Verwendung Hinzufügen Bedingung hinzufügen wiederholt , um die folgende Logik für Meldung anzeigen, wenn.

    3. Klicken Sie auf Fertig.

      Trigger-Logik

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

  10. Zurück im Luma - In-App Messaging Campaign Bildschirm, auswählen Aktivieren.

  11. Im Überprüfung zur Aktivierung (Luma - In-App Messaging Campaign) Bildschirm, auswählen Aktivieren.

  12. Sie sehen Ihre Luma - In-App Messaging Campaign mit Status Live im Kampagnen Liste.
    Liste der Kampagnen

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 zu Luma > Luma > Utils > MobileSDK im Xcode-Projektnavigator. Suchen Sie die func sendTrackAction(action: String, data: [String: Any]?) und fügen Sie den folgenden Code hinzu, der die MobileCore.track -Funktion basierend auf den Parametern action und data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Navigieren Sie zu Luma > Luma > Views > General > ConfigView im Xcode-Projektnavigator. 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 mithilfe von Play .

  2. Navigieren Sie zu Einstellungen Registerkarte.

  3. Tippen 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. Überprüfen Sie die Einrichtungsanweisungen -Abschnitt, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
  2. Auswählen In-App-Nachrichten.
  3. Auswählen Ereignisliste.
  4. Wählen Sie eine Nachricht anzeigen eingeben.
  5. Inspect das Rohereignis, insbesondere das html, das das vollständige Layout und den 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, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag.

Weiter: Angebote erstellen und anzeigen

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