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.
- 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
Aggiungere una superficie app in Raccolta dati
-
Dall'interfaccia Data Collection, seleziona App Surfaces nel pannello a sinistra.
-
Per creare una configurazione, seleziona Crea superficie app.
-
Immetti un Nome per la configurazione, ad esempio
Luma App Tutorial
. -
Da Configurazione applicazione mobile, selezionare Apple iOS.
-
Immetti l'ID del bundle per app mobile nel campo ID app (ID bundle iOS). Ad esempio,
com.adobe.luma.tutorial.swiftui
. -
Seleziona Salva.
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.
-
Nell'interfaccia utente di Data Collection, seleziona Datastreams e quindi il tuo datastream, ad esempio Luma Mobile App.
-
Seleziona per Experience Platform e seleziona Modifica dal menu di scelta rapida.
-
Nella schermata Datastreams > > Adobe Experience Platform, assicurati che sia selezionato Adobe Journey Optimizer. Per ulteriori informazioni, vedere Impostazioni di Adobe Experience Platform.
-
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. 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.
-
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 ]
Convalida impostazione con Assurance
-
Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.
-
Nell'interfaccia utente Assurance, selezionare Configura.
-
Seleziona il pulsante accanto a Messaggistica in-app.
-
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 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.
-
Nell'interfaccia utente di Journey Optimizer, seleziona Campagne dalla barra a sinistra.
-
Seleziona Crea campagna.
-
Nella schermata Crea campagna:
-
Seleziona Messaggio in-app e seleziona una superficie app dall'elenco Superficie app, ad esempio Luma Mobile App.
-
Seleziona Crea
-
-
Nella schermata Definizione campagna, in Proprietà, immetti un Nome per la campagna, ad esempio
Luma - In-App Messaging Campaign
, e una Descrizione, ad esempioIn-app messaging campaign for Luma app
.
-
Scorri verso il basso fino a Azione e seleziona Modifica contenuto.
-
Nella schermata Messaggio in-app:
-
Seleziona Modale come Layout messaggio.
-
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 Ignora come pulsante #1 testo (primario).
-
Nota come viene aggiornata l’anteprima.
-
Seleziona Rivedi per attivare.
-
-
Nella schermata Rivedi per attivare (Luma - Campagna di messaggistica in-app), seleziona nella sezione Pianifica.
-
Nella schermata Luma - In-App Messaging Campaign, seleziona Modifica trigger.
-
Nella finestra di dialogo Attivatore messaggio in-app, configura i dettagli dell'azione di tracciamento che attiva il messaggio in-app:
-
Per rimuovere Evento di avvio applicazione, selezionare .
-
Utilizza Aggiungi condizione ripetutamente per generare la logica seguente per Mostra messaggio se.
-
Fai clic su Fine.
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"
. -
-
Nella schermata Luma - In-App Messaging Campaign, seleziona Verifica per attivare.
-
Nella schermata Revisione da attivare (Luma - Campagna di messaggistica in-app), seleziona Attiva.
-
Vedi Luma - In-App Messaging Campaign 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"]) }
Convalida tramite l’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.
{width="300"}
Convalida implementazione in Assurance
Puoi convalidare i messaggi in-app nell’interfaccia utente 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.
- Inspect 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