Creare e inviare messaggi in-app

Scopri come creare messaggi in-app per le app mobili con Experienci Platform Mobile SDK e Journey Optimizer.

Journey Optimizer consente di creare campagne per inviare messaggi in-app a tipi di pubblico mirati. Le campagne in Journey Optimizer vengono utilizzate per fornire contenuti una tantum a un pubblico specifico utilizzando vari canali. Con le campagne, le azioni vengono eseguite simultaneamente, immediatamente o in base a una pianificazione specifica. Quando si utilizzano i percorsi (vedere Notifiche push Journey Optimizer lezione), le azioni vengono eseguite in sequenza.

Architettura

Prima di inviare messaggi in-app con Journey Optimizer, è necessario assicurarsi che siano presenti le configurazioni e le integrazioni corrette. Per informazioni sul flusso di dati dei messaggi in-app in Journey Optimizer, consulta la documentazione.

NOTE
Questa lezione è facoltativa e si applica solo agli utenti di Journey Optimizer che desiderano inviare messaggi in-app.

Prerequisiti

  • L'app con gli SDK installati e configurati è stata creata ed eseguita correttamente.
  • Configura l’app per Adobe Experience Platform.
  • Accesso a Journey Optimizer e autorizzazioni sufficienti come descritto qui. È inoltre necessaria un'autorizzazione sufficiente per le seguenti funzioni di Journey Optimizer.
    • Gestire le campagne.
  • Dispositivo fisico iOS o simulatore per test.

Obiettivi di apprendimento

In questa lezione, potrai

  • Crea una superficie app in AJO.
  • Installa e configura l’estensione tag Journey Optimizer.
  • Aggiorna l’app per registrare l’estensione tag Journey Optimizer.
  • Convalidare l'impostazione in Assurance.
  • Definisci la tua esperienza di campagna e messaggio in-app in Journey Optimizer.
  • Invia il tuo messaggio in-app dall’app.

Configurazione

TIP
Se hai già configurato l’ambiente come parte del Messaggi push di Journey Optimizer In questa lezione è possibile che siano già stati eseguiti alcuni dei passaggi descritti in questa sezione di configurazione.

Aggiungere una superficie app in Raccolta dati

  1. Dalla sezione Interfaccia di Data Collection, seleziona Superfici app nel pannello a sinistra.

  2. Per creare una configurazione, seleziona Crea superficie app.
    app surface home

  3. Immetti un Nome per la configurazione, ad esempio Luma App Tutorial .

  4. Da Configurazione applicazione mobile, seleziona Apple iOS.

  5. Immetti l’ID del bundle dell’app mobile in ID app (ID bundle iOS) campo. Ad esempio: com.adobe.luma.tutorial.swiftui.

  6. Seleziona Salva.

    configurazione della superficie dellapp

Aggiorna configurazione dello stream di dati

Per fare in modo che i dati inviati dalla tua app mobile a Edge Network vengano inoltrati a Journey Optimizer, aggiorna la configurazione di Experience Edge.

  1. Nell’interfaccia utente di Data Collection, seleziona Flussi di dati e seleziona il flusso di dati, ad esempio Luma Mobile App.

  2. Seleziona Altro per Experience Platform e seleziona Modifica Modifica dal menu di scelta rapida.

  3. In Flussi di dati > Cartella > Adobe Experience Platform schermata, assicurati Adobe Journey Optimizer è selezionato. Consulta Impostazioni Adobe Experience Platform per ulteriori informazioni.

  4. Per salvare la configurazione dello stream di dati, seleziona Salva.

    Configurazione dello stream di dati AEP

Installare l’estensione dei tag di Journey Optimizer

Affinché l'app funzioni con Journey Optimizer, devi aggiornare la proprietà del tag.

  1. Accedi a Tag > Estensioni > Catalogo.
  2. Apri la proprietà, ad esempio Luma Mobile App Tutorial.
  3. Seleziona Catalogo.
  4. Cerca Adobe Journey Optimizer estensione.
  5. Installa l’estensione.

Quando solo utilizzo dei messaggi in-app nell’app, in Installa estensione o Configura estensione, non è necessario configurare nulla. Tuttavia, se hai già seguito il Notifiche push nell'esercitazione, questo sarà visibile per Sviluppo ambiente, Set di dati evento di tracciamento push AJO il set di dati è selezionato da Set di dati evento elenco.

Implementare Journey Optimizer nell’app

Come descritto nelle lezioni precedenti, l’installazione di un’estensione tag per dispositivi mobili fornisce solo la configurazione. Ora devi installare e registrare l’SDK di messaggistica. Se questi passaggi non sono chiari, rivedi Installare gli SDK sezione.

NOTE
Se hai completato il Installare gli SDK , l'SDK è già installato e puoi saltare questo passaggio.
  1. In Xcode, assicurati che Messaggistica AEP viene aggiunto all’elenco dei pacchetti in Dipendenze dai pacchetti. Consulta Gestione pacchetti Swift.

  2. Accedi a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.

  3. Assicurare AEPMessaging fa parte dell’elenco delle importazioni.

    import AEPMessaging

  4. Assicurare Messaging.self fa parte dell’array di estensioni che si stanno registrando.

    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
    ]
    

Convalida impostazione con Assurance

  1. Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Nell’interfaccia utente Assurance, seleziona Configura.
    configura clic

  3. Seleziona la Più pulsante accanto a Messaggistica in-app.

  4. Seleziona Salva.
    salva

  5. Seleziona Messaggistica in-app dal menu di navigazione a sinistra.

  6. Seleziona la Convalida scheda. Verifica che non siano presenti errori.

    Convalida in-app

Creare un messaggio in-app personalizzato

Per creare un messaggio in-app personalizzato, devi definire una campagna in Journey Optimizer che attivi un messaggio in-app in base agli eventi che si verificano. Questi eventi possono essere:

  • dati inviati a Adobe Experience Platform,
  • eventi di tracciamento di base, come azioni, oppure stato o raccolta di dati PII, tramite le API generiche core mobile,
  • eventi del ciclo di vita dell'applicazione, ad esempio avvio, installazione, aggiornamento, chiusura o arresto anomalo,
  • eventi di geolocalizzazione, come l’ingresso o l’uscita da un punto di interesse.

In questo tutorial, utilizzerai le API Mobile Core generiche e indipendenti dalle estensioni (consulta API generiche core per dispositivi mobili) per facilitare il tracciamento degli eventi di schermate utente, azioni e dati PII. Gli eventi generati da queste API vengono pubblicati nell’hub eventi SDK e sono disponibili per l’utilizzo da parte delle estensioni. L’hub eventi SDK fornisce la struttura dati di base associata a tutte le estensioni SDK di Mobile Platform, mantenendo un elenco di estensioni registrate e moduli interni, un elenco di listener di eventi registrati e un database dello stato condiviso.

L’hub eventi SDK pubblica e riceve i dati dell’evento da estensioni registrate per semplificare le integrazioni con soluzioni Adobe e di terze parti. Ad esempio, quando è installata l’estensione Optimize, tutte le richieste e le interazioni con il motore di offerta Journey Optimizer - Decision Management vengono gestite dall’hub eventi.

  1. Nell’interfaccia utente di Journey Optimizer, seleziona Campagne dalla barra a sinistra.

  2. Seleziona Crea campagna.

  3. In Crea campagna schermata:

    1. Seleziona Messaggio in-app e seleziona una superficie di app dalla sezione Superficie app elenco, ad esempio Luma Mobile App.

    2. Seleziona Crea

      Proprietà campagna

  4. Nella schermata di definizione di Campaign, in Proprietà, immetti un Nome per la campagna, ad esempio Luma - In-App Messaging Campaign, e un Descrizione, ad esempio In-app messaging campaign for Luma app.
    Nome campagna

  5. Scorri verso il basso fino a Azione, e seleziona Modifica contenuto.

  6. In Messaggio in-app schermata:

    1. Seleziona Modale come Layout messaggio.

    2. Invio https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png per URL contenuto multimediale.

    3. Immetti un Intestazione, ad esempio Welcome to this Luma In-App Message e inserisci un Corpo, ad esempio Triggered by pushing that button in the app....

    4. Invio Ignora come Testo #1 pulsante (primario).

    5. Nota come viene aggiornata l’anteprima.

    6. Seleziona Controlla per attivare.

      Editor in-app

  7. In Revisione per l’attivazione (Luma - Campagna di messaggistica in-app) schermata, seleziona Modifica nel Pianificazione affiancare.
    Rivedi pianificazione seleziona Pianificazione

  8. Torna in Luma - In-App Messaging Campaign schermata, seleziona Modifica Modifica trigger.

  9. In Attivatore messaggio in-app nella finestra di dialogo, configura i dettagli dell’azione di tracciamento che attiva il messaggio in-app:

    1. Da rimuovere Evento di avvio dell’applicazione, seleziona Chiudi .

    2. Utilizzare Aggiungi Aggiungi condizione ripetutamente per generare la logica seguente per Mostra messaggio se.

    3. Fai clic su Fine.

      Logica di attivazione

    È stata definita un'azione di tracciamento, in cui Azione è uguale a in-app e Dati contestuali con l'azione è una coppia chiave-valore di "showMessage" : "true".

  10. Torna in Luma - In-App Messaging Campaign schermata, seleziona Controlla per attivare.

  11. In Revisione per l’attivazione (Luma - Campagna di messaggistica in-app) schermata, seleziona Attiva.

  12. Vedi il tuo Luma - In-App Messaging Campaign con stato Live nel Campagne elenco.
    Elenco delle campagne

Attivare il messaggio in-app

Disponi di tutti gli ingredienti necessari per inviare un messaggio in-app. Ciò che rimane è come attivare questo messaggio in-app nella tua app.

  1. Vai a Luma > Luma > Utils > MobileSDK nel Navigatore progetti Xcode. Trova il func sendTrackAction(action: String, data: [String: Any]?) e aggiungi il seguente codice, che chiama il MobileCore.track funzione, in base ai parametri action e data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Vai a Luma > Luma > Views > General > ConfigView nel Navigatore progetti Xcode. Trova il codice per il pulsante Messaggio in-app e aggiungi il seguente codice:

    code language-swift
    // Setting parameters and calling function to send in-app message
    Task {
        MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"])
    }
    

Convalida tramite l’app

  1. Rigenera ed esegui l’app nel simulatore o su un dispositivo fisico da Xcode, utilizzando Play .

  2. Vai a Impostazioni scheda.

  3. Tocca Messaggio in-app. Il messaggio in-app viene visualizzato nell’app.

    {width="300"}

Convalida implementazione in Assurance

Puoi convalidare i messaggi in-app nell’interfaccia utente Assurance.

  1. Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.
  2. Seleziona Messaggistica in-app.
  3. Seleziona Elenco eventi.
  4. Seleziona un Visualizza messaggio voce.
  5. Inspect l’evento non elaborato, in particolare html, che contiene il layout completo e il contenuto del messaggio in-app.
    Messaggio in-app Assurance

Passaggi successivi

Ora dovresti disporre di tutti gli strumenti necessari per iniziare ad aggiungere messaggi in-app, laddove opportuno e applicabile. Ad esempio, la promozione di prodotti in base a interazioni specifiche che tieni traccia nell’app.

SUCCESS
Hai abilitato l’app per la messaggistica in-app e aggiunto una campagna di messaggistica in-app tramite Journey Optimizer e l’estensione Journey Optimizer per l’SDK di Mobile di Experience Platform.
Grazie per aver dedicato il tuo tempo all’apprendimento dell’SDK di Adobe Experience Platform Mobile. Se hai domande, vuoi condividere feedback generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community.

Successivo: Creare e visualizzare le offerte

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