Creare e inviare messaggi in-app
Scopri come creare messaggi in-app per le app mobili con Experienci 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 (vedere Notifiche push Journey Optimizer lezione), 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 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
-
Dalla sezione Interfaccia di Data Collection, seleziona Superfici app 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, seleziona Apple iOS.
-
Immetti l’ID del bundle dell’app mobile in ID app (ID bundle iOS) campo. 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 a Edge Network vengano inoltrati a Journey Optimizer, aggiorna la configurazione di Experience Edge.
-
Nell’interfaccia utente di Data Collection, seleziona Flussi di dati e seleziona il flusso di dati, ad esempio Luma Mobile App.
-
Seleziona per Experience Platform e seleziona Modifica dal menu di scelta rapida.
-
In Flussi di dati > > Adobe Experience Platform schermata, assicurati Adobe Journey Optimizer è selezionato. Consulta Impostazioni Adobe Experience Platform per ulteriori informazioni.
-
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.
- Accedi a Tag > Estensioni > Catalogo.
- Apri la proprietà, ad esempio Luma Mobile App Tutorial.
- Seleziona Catalogo.
- Cerca Adobe Journey Optimizer estensione.
- Installa l’estensione.
Quando solo utilizzo dei messaggi in-app nell’app, in Installa estensione o Configura estensione, non è necessario configurare nulla. Tuttavia, se hai già seguito il Notifiche push nell'esercitazione, questo sarà visibile per Sviluppo ambiente, Set di dati evento di tracciamento push AJO il set di dati è selezionato da Set di dati evento elenco.
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, rivedi Installare gli SDK sezione.
-
In Xcode, assicurati che Messaggistica AEP viene aggiunto all’elenco dei pacchetti in Dipendenze dai pacchetti. Consulta Gestione pacchetti Swift.
-
Accedi a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.
-
Assicurare
AEPMessaging
fa parte dell’elenco delle importazioni.import AEPMessaging
-
Assicurare
Messaging.self
fa parte dell’array di estensioni che si stanno 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
-
Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.
-
Nell’interfaccia utente Assurance, seleziona Configura.
-
Seleziona la pulsante accanto a Messaggistica in-app.
-
Seleziona Salva.
-
Seleziona Messaggistica in-app dal menu di navigazione a sinistra.
-
Seleziona la Convalida scheda. 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 Mobile Core generiche 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.
-
In Crea campagna schermata:
-
Seleziona Messaggio in-app e seleziona una superficie di app dalla sezione Superficie app elenco, ad esempio Luma Mobile App.
-
Seleziona Crea
-
-
Nella schermata di definizione di Campaign, in Proprietà, immetti un Nome per la campagna, ad esempio
Luma - In-App Messaging Campaign
, e un Descrizione, ad esempioIn-app messaging campaign for Luma app
.
-
Scorri verso il basso fino a Azione, e seleziona Modifica contenuto.
-
In Messaggio in-app schermata:
-
Seleziona Modale come Layout messaggio.
-
Invio
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
per URL contenuto multimediale. -
Immetti un Intestazione, ad esempio
Welcome to this Luma In-App Message
e inserisci un Corpo, ad esempioTriggered by pushing that button in the app...
. -
Invio Ignora come Testo #1 pulsante (primario).
-
Nota come viene aggiornata l’anteprima.
-
Seleziona Controlla per attivare.
-
-
In Revisione per l’attivazione (Luma - Campagna di messaggistica in-app) schermata, seleziona nel Pianificazione affiancare.
-
Torna in Luma - In-App Messaging Campaign schermata, seleziona Modifica trigger.
-
In Attivatore messaggio in-app nella finestra di dialogo, configura i dettagli dell’azione di tracciamento che attiva il messaggio in-app:
-
Da rimuovere Evento di avvio dell’applicazione, seleziona .
-
Utilizzare Aggiungi condizione ripetutamente per generare la logica seguente per Mostra messaggio se.
-
Fai clic su Fine.
È stata definita un'azione di tracciamento, in cui Azione è uguale a
in-app
e Dati contestuali con l'azione è una coppia chiave-valore di"showMessage" : "true"
. -
-
Torna in Luma - In-App Messaging Campaign schermata, seleziona Controlla per attivare.
-
In Revisione per l’attivazione (Luma - Campagna di messaggistica in-app) schermata, seleziona Attiva.
-
Vedi il tuo Luma - In-App Messaging Campaign con stato Live nel Campagne elenco.
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. Trova il
func sendTrackAction(action: String, data: [String: Any]?)
e aggiungi il seguente codice, che chiama ilMobileCore.track
funzione, in base ai parametriaction
edata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Vai a Luma > Luma > Views > General > ConfigView nel Navigatore progetti Xcode. 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 .
-
Vai a Impostazioni scheda.
-
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.
- Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.
- Seleziona Messaggistica in-app.
- Seleziona Elenco eventi.
- Seleziona un Visualizza messaggio voce.
- 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