Creare e inviare messaggi in-app

Scopri come creare messaggi in-app per le app mobili con Experience 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 (consulta la lezione Notifiche push di Journey Optimizer), 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.
  • Accedi a Journey Optimizer e alle 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 l'ambiente è già stato configurato nell'ambito della lezione Messaggi push di Journey Optimizer, è possibile che siano già stati eseguiti alcuni dei passaggi descritti in questa sezione di installazione.

Aggiungere una superficie app in Raccolta dati

  1. Dall'interfaccia Data Collection, seleziona App Surfaces 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, selezionare Apple iOS.

  5. Immetti l'ID del bundle per app mobile nel campo ID app (ID bundle iOS). Ad esempio, com.adobe.luma.tutorial.swiftui.

  6. Seleziona Salva.

    configurazione superficie app

Aggiorna configurazione dello stream di dati

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

  1. Nell'interfaccia utente di Data Collection, seleziona Datastreams e quindi il tuo datastream, ad esempio Luma Mobile App.

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

  3. Nella schermata Datastreams > Folder > Adobe Experience Platform, assicurati che sia selezionato Adobe Journey Optimizer. Per ulteriori informazioni, vedere Impostazioni di Adobe Experience Platform.

  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. Passa a Tag > Estensioni > Catalogo.
  2. Apri la proprietà, ad esempio Luma Mobile App Tutorial.
  3. Seleziona Catalogo.
  4. Cerca l'estensione Adobe Journey Optimizer.
  5. Installa l’estensione.

Quando solo utilizza i messaggi in-app nell'app, in Installa estensione o Configura estensione, non è necessario configurare nulla. Tuttavia, se hai già seguito la lezione Notifiche push nell'esercitazione, vedrai che per l'ambiente Sviluppo, il set di dati AJO Push Tracking Experience Event è selezionato dall'elenco Set di dati evento.

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, controlla la sezione Installare gli SDK.

NOTE
Se hai completato la sezione Installare gli SDK, l'SDK è già installato e puoi saltare questo passaggio.
  1. In Xcode, accertati che Messaggistica AEP sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.

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

  3. Assicurarsi che AEPMessaging faccia parte dell'elenco delle importazioni.

    import AEPMessaging

  4. Assicurarsi che Messaging.self faccia parte dell'array di estensioni che si sta 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. Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Nell'interfaccia utente Assurance, selezionare Configura.
    configura clic

  3. Seleziona il pulsante Plus accanto a Messaggistica in-app.

  4. Seleziona Salva.
    salva

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

  6. Selezionare la scheda Convalida. 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 generiche core per dispositivi mobili 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. Nella schermata Crea campagna:

    1. Seleziona Messaggio in-app e seleziona una superficie app dall'elenco Superficie app, ad esempio Luma Mobile App.

    2. Seleziona Crea

      Proprietà campagna

  4. Nella schermata Definizione campagna, in Proprietà, immetti un Nome per la campagna, ad esempio Luma - In-App Messaging Campaign, e una 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. Nella schermata Messaggio in-app:

    1. Seleziona Modale come Layout messaggio.

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

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

    4. Immetti Ignora come pulsante #1 testo (primario).

    5. Nota come viene aggiornata l’anteprima.

    6. Seleziona Rivedi per attivare.

      Editor in-app

  7. Nella schermata Rivedi per attivare (Luma - Campagna di messaggistica in-app), seleziona Modifica nella sezione Pianifica.
    Rivedi pianificazione seleziona pianificazione

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

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

    1. Per rimuovere Evento di avvio applicazione, selezionare Chiudi .

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

    3. Fai clic su Fine.

      Logica di attivazione

    Hai definito 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. Nella schermata Luma - In-App Messaging Campaign, seleziona Verifica per attivare.

  11. Nella schermata Revisione da attivare (Luma - Campagna di messaggistica in-app), seleziona Attiva.

  12. Vedi Luma - In-App Messaging Campaign con stato Live nell'elenco Campagne.
    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. Trovare la funzione func sendTrackAction(action: String, data: [String: Any]?) e aggiungere il codice seguente, che chiama la funzione MobileCore.track, 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 in Xcode Project Navigator. 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. Passa alla scheda Impostazioni.

  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. Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.
  2. Selezionare Messaggistica in-app.
  3. Seleziona Elenco eventi.
  4. Selezionare una voce Messaggio visualizzato.
  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 commenti generali o suggerimenti su contenuti futuri, condividili in questo Experience League post di discussione della community.

Successivo: Creare e visualizzare le offerte

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