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.
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.
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
Creare una configurazione dei canali
Per iniziare, devi creare una configurazione di canale per poter inviare notifiche di messaggi app da Journey Optimizer.
-
Nell'interfaccia di Journey Optimizer aprire il menu Canali > Impostazioni generali > Configurazioni canale e quindi selezionare Crea configurazione canale.
-
Immetti un nome e una descrizione (facoltativa) per la configurazione. Ad esempio,
LumaInAppMessaging
eChannel 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-
. -
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.
-
Seleziona il canale Messaggistica in-app.
-
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.
-
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. -
Immetti gli ID app per la piattaforma da supportare.
-
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.
-
Nell'interfaccia utente di Data Collection, seleziona Datastreams e quindi il tuo datastream, ad esempio Luma Mobile App.
-
Seleziona
-
Nella schermata Datastreams >
-
Per salvare la configurazione dello stream di dati, seleziona Salva.
Installare l’estensione dei tag di Journey Optimizer
Affinché l'app funzioni con Journey Optimizer, devi aggiornare la proprietà del tag.
- Passa a Tag > Estensioni > Catalogo.
- Apri la proprietà, ad esempio Luma Mobile App Tutorial.
- Seleziona Catalogo.
- Cerca l'estensione Adobe Journey Optimizer.
- 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.
-
In Xcode, accertati che Messaggistica AEP sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.
-
Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.
-
Assicurarsi che
AEPMessaging
faccia parte dell'elenco delle importazioni.import AEPMessaging
-
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 ]
-
In Android Studio, assicurati che aepsdk-messaging-android faccia parte delle dipendenze in build.gradle.kts in Android
-
Passa a Android
-
Assicurarsi che
com.adobe.marketing.mobile.Messaging
faccia parte dell'elenco delle importazioni.import import com.adobe.marketing.mobile.Messaging
-
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
-
Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.
-
Nell'interfaccia utente di Assurance, seleziona Configura.
-
Seleziona il pulsante
-
Seleziona Salva.
-
Seleziona Messaggistica in-app dal menu di navigazione a sinistra.
-
Selezionare la scheda Convalida. Verifica che non siano presenti errori.
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.
-
Nell'interfaccia utente di Journey Optimizer, seleziona Campagne dalla barra a sinistra.
-
Seleziona Crea campagna.
-
Nella finestra di dialogo Crea campagna, seleziona
-
Nella schermata Campagna - AAAA-MM-GG HHSS UTC+XX:XX:
-
Nella scheda Proprietà:
- Immettere un nome per la campagna, ad esempio
Luma Mobile In-App Campaign
. - Se necessario, aggiungi una descrizione.
- Immettere un nome per la campagna, ad esempio
-
Selezionare la scheda Azione.
-
Sotto Mostra messaggio se, selezionare
-
Dal menu a discesa Configurazione messaggio in-app, seleziona la configurazione. Ad esempio, LumaInAppMessaging.
-
Seleziona
-
Nella finestra di dialogo Attivatore messaggio in-app:
-
Seleziona Avvio applicazione e seleziona Azione di tracciamento dal menu a discesa.
-
Seleziona
-
Seleziona Azione e è uguale a dai menu a discesa.
-
Immettere
in-app
. -
Seleziona
-
Seleziona Dati contestuali dal menu a discesa e immetti
showMessage
. -
Seleziona è uguale a dal menu a discesa e immetti
true
. -
Seleziona Fine.
-
-
-
Nella schermata principale di definizione della campagna, seleziona la scheda Contenuto.
-
Abilita Formattazione avanzata.
-
Seleziona Modale come Layout messaggi. Nella finestra di dialogo Cambia layout, seleziona Cambia layout.
-
Nella scheda Contenuto.
- Immetti
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
per URL file multimediale. - Immetti un Intestazione, ad esempio
Welcome to this Luma In-App Message
, e un Corpo, ad esempioTriggered by pushing that button in the app...
.
- Immetti
-
Selezionare la scheda Impostazioni.
- Seleziona Personalizza dimensione in Messaggio.
- Disabilita Adatta al contenuto.
- Imposta Altezza su 75%.
-
-
-
Seleziona Rivedi per attivare. Per modificare facoltativamente qualsiasi configurazione per Contenuto, Proprietà, Azioni o altro, selezionare
-
Nella schermata Rivedi per attivare (nome campagna), seleziona Attiva.
-
Dopo un po', visualizzi il tuo nome campagna con stato Live nell'elenco 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.
-
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 funzioneMobileCore.track
, in base ai parametriaction
edata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
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"]) }
-
Vai a Android
fun sendTrackAction(action: String, data: Map<String, String>?)
e aggiungere il codice seguente, che chiama la funzioneMobileCore.track
, in base ai parametriaction
edata
.code language-kotlin // Send trackAction event MobileCore.track(action, data)
-
Vai a Android
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.
-
Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Xcode, utilizzando
-
Passa alla scheda Impostazioni.
-
Tocca Messaggio In-App. Il messaggio in-app viene visualizzato nell’app.
-
Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Android Studio, utilizzando
-
Passa alla scheda Impostazioni.
-
Tocca Messaggio In-App. Il messaggio in-app viene visualizzato nell’app.
Convalidare l’implementazione in Assurance
Puoi convalidare i messaggi in-app nell’interfaccia utente di Assurance.
-
Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.
-
Selezionare Messaggistica in-app.
-
Seleziona Elenco eventi.
-
Selezionare una voce Messaggio visualizzato.
-
Controllare l'evento non elaborato, in particolare
html
, che contiene il layout completo e il contenuto del messaggio in-app.
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.
Successivo: Creare e visualizzare le offerte