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.
- 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 di canale in Journey Optimizer
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, quindi selezionare Crea configurazione canale.
-
Immetti un nome e una descrizione (facoltativa) per la configurazione.
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.
-
Seleziona la Piattaforma per la quale vuoi definire le impostazioni. Questo 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 verrà distribuito a entrambi, indipendentemente dalla piattaforma selezionata nella configurazione canale. -
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. 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. 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 ]
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, mantenendo un elenco di estensioni registrate e moduli interni, un elenco di listener di eventi registrati e un database a 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, 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 schermata Luma - In-App Messaging Campaign, seleziona
-
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
-
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.
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