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 {modal="regular"}

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 per le notifiche push. È 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 configurazione di canale in Journey Optimizer.
  • Installa e configura l’estensione tag Journey Optimizer.
  • Aggiorna l’app per registrare l’estensione tag Journey Optimizer.
  • Convalida la configurazione 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.

Creare una configurazione dei canali

Per iniziare, devi creare una configurazione di canale per poter inviare notifiche di messaggi app da Journey Optimizer.

  1. Nell'interfaccia di Journey Optimizer aprire il menu Canali > Impostazioni generali > Configurazioni canale e quindi selezionare Crea configurazione canale.

  2. Immetti un nome e una descrizione (facoltativa) per la configurazione. Ad esempio, LumaInAppMessaging e Channel for in-app messaging.

    note note
    NOTE
    I nomi devono iniziare con una lettera (A-Z). Può contenere solo caratteri alfanumerici. È inoltre possibile utilizzare i caratteri trattino basso _, punto . e trattino -.
  3. Per assegnare etichette di utilizzo dei dati personalizzate o di base alla configurazione, è possibile selezionare Gestisci accesso. Ulteriori informazioni sul controllo degli accessi a livello di oggetto.

  4. Seleziona il canale Messaggistica in-app.

  5. Seleziona Azione di marketing per associare i criteri di consenso ai messaggi utilizzando questa configurazione. Tutti i criteri di consenso associati all’azione di marketing vengono utilizzati per rispettare le preferenze dei clienti. Ulteriori informazioni sulle azioni di marketing. Ad esempio: Push Targeting.

  6. Seleziona la Piattaforma per la quale vuoi definire le impostazioni. Questa impostazione consente di specificare l’app di destinazione per ogni piattaforma e garantisce la distribuzione coerente dei contenuti su più piattaforme.

    note note
    NOTE
    Per le piattaforme iOS e Android, la consegna si basa esclusivamente sull’ID app. Se entrambe le app condividono lo stesso ID app, il contenuto viene distribuito a entrambi, indipendentemente dalla piattaforma selezionata nella configurazione canale.
  7. Immetti gli ID app per la piattaforma da supportare.

    Creare una configurazione di canale {modal="regular"}

  8. Seleziona Invia per salvare le modifiche.

Aggiorna configurazione dello stream di dati

Per fare in modo che i dati inviati dalla tua app mobile ad 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 di AEP {modal="regular"}

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. Se hai già seguito la lezione Notifiche push nell'esercitazione, noterai 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. A questo punto è necessario installare e registrare il SDK di messaggistica. Se questi passaggi non sono chiari, controlla la sezione Installare gli SDK.

NOTE
Se hai completato la sezione Installare gli SDK, SDK è già installato e puoi saltare questo passaggio.
iOS
  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
    ]
    
Android
  1. In Android Studio, assicurati che aepsdk-messaging-android faccia parte delle dipendenze in build.gradle.kts in Android ChevronDown > Gradle Scripts. Vedi Gradle.

  2. Passa a Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication nel Navigatore progetti di Android Studio.

  3. Assicurarsi che com.adobe.marketing.mobile.Messaging faccia parte dell'elenco delle importazioni.

    import import com.adobe.marketing.mobile.Messaging

  4. Assicurarsi che Messaging.EXTENSION faccia parte dell'array di estensioni che si sta registrando.

    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
    )
    

Convalidare la configurazione con Assurance

  1. Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Nell'interfaccia utente di Assurance, seleziona Configura.
    configura clic {modal="regular"}

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

  4. Seleziona Salva.
    salva {modal="regular"}

  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 {modal="regular"}

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 di 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. L'hub eventi gestisce un elenco di estensioni registrate e moduli interni, un elenco di listener di eventi registrati e un database dello stato condiviso.

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

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

  2. Seleziona Crea campagna.

  3. Nella finestra di dialogo Crea campagna, seleziona Orologio Pianificato - Marketing e seleziona Conferma.

  4. Nella schermata Campagna - AAAA-MM-GG HHSS UTC+XX:XX:

    1. Nella scheda Proprietà:

      1. Immettere un nome per la campagna, ad esempio Luma Mobile In-App Campaign.
      2. Se necessario, aggiungi una descrizione.
    2. Selezionare la scheda Azione.

      1. Sotto Mostra messaggio se, selezionare Aggiungi Aggiungi azione. Dal menu a discesa, selezionare Messaggio in-app.

      2. Dal menu a discesa Configurazione messaggio in-app, seleziona la configurazione. Ad esempio, LumaInAppMessaging.

      3. Seleziona Modifica Modifica trigger.

      4. Nella finestra di dialogo Attivatore messaggio in-app:

        1. Seleziona Avvio applicazione e seleziona Azione di tracciamento dal menu a discesa.

        2. Seleziona AddCircle Aggiungi condizione.

        3. Seleziona Azione e è uguale a dai menu a discesa.

        4. Immettere in-app.

        5. Seleziona AddCircle Aggiungi condizione.

        6. Seleziona Dati contestuali dal menu a discesa e immetti showMessage.

        7. Seleziona è uguale a dal menu a discesa e immetti true.

          Modifica trigger {modal="regular"}

        8. Seleziona Fine.

    3. Nella schermata principale di definizione della campagna, seleziona la scheda Contenuto.

      1. Abilita Formattazione avanzata.

      2. Seleziona Modale come Layout messaggi. Nella finestra di dialogo Cambia layout, seleziona Cambia layout.

      3. Nella scheda Contenuto.

        1. Immetti https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png per URL file multimediale.
        2. 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....

        Contenuto messaggio in-app {modal="regular"}

      4. Selezionare la scheda Impostazioni.

        1. Seleziona Personalizza dimensione in Messaggio.
        2. Disabilita Adatta al contenuto.
        3. Imposta Altezza su 75%.

        Impostazioni messaggi in-app {modal="regular"}

  5. Seleziona Rivedi per attivare. Per modificare facoltativamente qualsiasi configurazione per Contenuto, Proprietà, Azioni o altro, selezionare Modifica .

  6. Nella schermata Rivedi per attivare (nome campagna), seleziona Attiva.

  7. Dopo un po', visualizzi il tuo nome campagna con stato Live nell'elenco Campagne.
    Elenco delle campagne {modal="regular"}

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.

iOS
  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"])
    }
    
Android
  1. Vai a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK nel navigatore di Android Studio. Trovare la funzione fun sendTrackAction(action: String, data: Map<String, String>?) e aggiungere il codice seguente, che chiama la funzione MobileCore.track, in base ai parametri action e data.

    code language-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Vai a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt nel navigatore di Android Studio. Trovare il codice per il pulsante del gestore onInAppMessageClick e aggiungere il codice seguente:

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

Convalida tramite l’app

Puoi convalidare i messaggi in-app direttamente dall’app.

iOS
  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"}

Android
  1. Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Android Studio, utilizzando Play .

  2. Passa alla scheda Impostazioni.

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

    {width="300"}

Convalidare l’implementazione in Assurance

Puoi convalidare i messaggi in-app nell’interfaccia utente di 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. Controllare l'evento non elaborato, in particolare html, che contiene il layout completo e il contenuto del messaggio in-app.

    Messaggio In-App Di Assurance {modal="regular"}

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 Experience Platform Mobile SDK.
Grazie per aver dedicato tempo all'apprendimento di Adobe Experience Platform Mobile SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League.

Successivo: Creare e visualizzare le offerte

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