Acquisire dati tramite Mobile SDK
Questa guida rapida spiega come acquisire i dati di tracciamento delle app mobili direttamente in Adobe Experience Platform utilizzando l’SDK Adobe Experience Platform Mobile e un Edge Network. Quindi usa quei dati nel Customer Journey Analytics.
A questo scopo, è necessario:
-
Configurare uno schema e un set di dati in Adobe Experience Platform per definire il modello (schema) dei dati da raccogliere e dove raccogliere effettivamente i dati (set di dati).
-
Configurare un flusso di dati per configurare la rete Edge di Adobe Experience Platform in modo che i dati raccolti vengano indirizzati al set di dati configurato in Adobe Experience Platform.
-
Utilizza i tag per configurare facilmente regole ed elementi dati in base ai dati presenti nell'app mobile. Quindi assicurati che i dati siano inviati al flusso di dati configurato sulla rete Edge di Adobe Experience Platform.
-
Distribuire e convalidare. Disporre di un ambiente in cui puoi eseguire iterazioni sullo sviluppo dei tag e, una volta convalidato tutto, pubblicarlo in diretta nell’ambiente di produzione.
-
Impostare una connessione in Customer Journey Analytics. Questa connessione deve includere almeno il set di dati di Adobe Experience Platform.
-
Configurare una visualizzazione dati in Customer Journey Analytics per definire le metriche e le dimensioni da utilizzare in Analysis Workspace.
-
Configurare un progetto in Customer Journey Analytics per generare rapporti e visualizzazioni.
Configurare uno schema e un set di dati
Per inserire i dati in Adobe Experience Platform, innanzitutto devi definire quali dati desideri raccogliere. Tutti i dati inseriti in Adobe Experience Platform devono essere conformi a una struttura standard e denormalizzata affinché vengano riconosciuti e utilizzati dalle capacità e funzionalità a valle. Experience Data Model (XDM) è il framework standard che fornisce una struttura sotto forma di schemi.
Una volta definito uno schema, utilizza uno o più set di dati per memorizzare e gestire la raccolta di dati. Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati (in genere una tabella) che contiene uno schema (colonne) e dei campi (righe).
Tutti i dati inseriti in Adobe Experience Platform devono essere conformi a uno schema predefinito prima di poter essere memorizzati come set di dati.
Configurare uno schema
Desideri tenere traccia di alcuni dati minimi dai profili che utilizzano la tua app mobile, ad esempio il nome della scena e l’identificazione.
Devi innanzitutto definire uno schema che modella questi dati.
Per configurare lo schema:
-
Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Schemas (Schemi) all’interno di DATA MANAGEMENT (GESTIONE DATI).
-
Selezionare Create schema.
. -
Nel passaggio Selezionare una classe della procedura guidata Crea schema:
-
Seleziona Experience Event.
note info INFO Lo schema Experience Event viene utilizzato per modellare il comportamento di un profilo (come nome di scena, pulsante da aggiungere al carrello). Per modellare gli attributi del profilo (come nome, e-mail, genere) viene utilizzato uno schema Individual Profile. -
Seleziona Next.
-
-
In Name and review step della procedura guidata Create schema:
-
Immetti Schema display name per lo schema e (facoltativo) Description.
-
Seleziona Finish.
-
-
Nella scheda Struttura dello schema di esempio:
-
Seleziona + Add (Aggiungi) in Field groups (Gruppi di campi).
I gruppi di campi sono raccolte riutilizzabili di oggetti e attributi che consentono di estendere facilmente lo schema.
-
Nella finestra di dialogo Add fields groups (Aggiungi gruppi di campi) seleziona il gruppo di campi AEP Mobile SDK ExperienceEvent dall’elenco.
Puoi selezionare il pulsante di anteprima per visualizzare un’anteprima dei campi che fanno parte del gruppo di campi, ad esempio
application > name
.Seleziona Back (Indietro) per chiudere l’anteprima.
-
Seleziona Add field groups (Aggiungi gruppi di campi).
-
-
Seleziona + accanto al nome dello schema nel pannello Structure (Struttura).
-
Nel pannello Field Properties, immetti
identification
come Field name, Identification come Display name, seleziona Object come Type e seleziona ExperienceEvent Core v2.1 come Field Group.note note NOTE Se tale gruppo di campi non è disponibile, cercare un altro gruppo di campi contenente campi di identità. Oppure crea un nuovo gruppo di campi e aggiungi nuovi campi di identità (come ecid
,crmId
e altri necessari) al gruppo di campi e seleziona il nuovo gruppo di campi.L’oggetto di identificazione aggiunge funzionalità di identificazione allo schema. Nel tuo caso, vuoi identificare i profili utilizzando la tua app mobile utilizzando l’ID Experience Cloud e l’indirizzo e-mail. Sono disponibili molti altri attributi per tenere traccia dell’identificazione della persona (ad esempio ID cliente, ID fedeltà).
Seleziona Apply (Applica) per aggiungere questo oggetto allo schema.
-
Seleziona il campo ecid nell’oggetto di identificazione appena aggiunto e seleziona Identity (Identità) e Primary Identity (Identità principale) e ECID dall’elenco Identity namespace (Spazio dei nomi dell’identità) nel pannello di destra.
Stai specificando l’Experience Cloud Identity come identità principale che il servizio Adobe Experience Platform Identity può utilizzare per combinare (unire) il comportamento dei profili con lo stesso ECID.
Seleziona Apply (Applica). Nell’attributo ecid viene visualizzata l’icona di un’impronta digitale.
-
Seleziona il campo email nell’oggetto di identificazione appena aggiunto e seleziona Identity (identità) e Email dall’elenco Identity namespace (Spazio dei nomi dell’identità) nel pannello Field Properties (Proprietà campo).
Stai specificando l’indirizzo e-mail come un’altra identità che il servizio Adobe Experience Platform Identity può utilizzare per combinare (unire) il comportamento dei profili.
Seleziona Apply (Applica). Nell’attributo e-mail viene visualizzata l’icona di un’impronta digitale.
Seleziona Save (Salva).
-
Seleziona l’elemento principale dello schema che visualizza il nome dello schema, quindi seleziona il pulsante Profile (Profilo).
Viene richiesto di abilitare lo schema per il profilo. Una volta abilitato, quando i dati vengono inseriti in set di dati basati su questo schema, tali dati vengono uniti su Real-Time Customer Profile.
Per ulteriori informazioni, consulta la sezione Abilitare lo schema per l’utilizzo in Real-Time Customer Profile.
note important IMPORTANT Una volta salvato uno schema abilitato per il profilo, non è più possibile disattivarlo per il profilo. -
Seleziona Save (Salva) per salvare lo schema.
Hai creato uno schema minimo che modella i dati che puoi acquisire dall’app mobile. Lo schema consente di identificare i profili utilizzando Experience Cloud Identity e l’indirizzo e-mail. Attivando lo schema per il profilo, puoi garantire che i dati acquisiti dall’app mobile vengano aggiunti al Profilo cliente in tempo reale.
Oltre ai dati sul comportamento, puoi anche acquisire i dati degli attributi del profilo dalla tua app mobile (ad esempio i dettagli dei profili che si abbonano a una newsletter).
Per acquisire i dati del profilo:
-
Crea uno schema basato sulla classe di profilo individuale XDM.
-
Aggiungi il gruppo di campi Profile Core v2 allo schema.
-
Aggiungi un oggetto di identificazione basato sul gruppo di campi Profile Core v2.
-
Definisci l’ID Experience Cloud come identificatore principale e invia un’e-mail come identificatore.
-
Abilitare lo schema per il profilo
Per ulteriori informazioni sull’aggiunta e la rimozione di gruppi di campi e singoli campi a uno schema, consulta la sezione Creare e modificare schemi nell’interfaccia utente.
Configurare un set di dati
Con lo schema, hai definito il modello dati. Ora devi definire il costrutto per memorizzare e gestire tali dati utilizzando i set di dati.
Per configurare il set di dati:
-
Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Datasets (Set di dati) all’interno di DATA MANAGEMENT (GESTIONE DATI).
-
Seleziona Create dataset (Crea set di dati).
-
Seleziona Create dataset from schema (Crea set di dati da schema).
-
Seleziona lo schema creato in precedenza e seleziona Next (Avanti).
-
Assegna un nome al set di dati e (facoltativamente) fornisci una descrizione.
-
Seleziona Finish (Fine).
-
Seleziona il pulsante Profile (Profilo).
Viene richiesto di abilitare il set di dati per il profilo. Una volta attivato, il set di dati arricchisce i profili dei clienti in tempo reale con i relativi dati inseriti.
note important IMPORTANT Puoi abilitare un set di dati per il profilo solo quando lo schema a cui aderisce il set di dati è abilitato anche per il profilo.
Per ulteriori informazioni su come visualizzare, visualizzare in anteprima, creare, eliminare un set di dati, consulta la sezione Guida all’interfaccia utente dei set di dati. E come abilitare un set di dati per Real-Time Customer Profile.
Configurare un flusso di dati
Un flusso di dati rappresenta la configurazione lato server quando si implementano gli SDK per Web e dispositivi mobili di Adobe Experience Platform. Durante la raccolta di dati con gli SDK di Adobe Experience Platform, i dati vengono inviati alla rete Edge di Adobe Experience Platform. È lo stream di dati che determina a quali servizi vengono inoltrati i dati.
Nella configurazione, desideri che i dati raccolti dall’app mobile vengano inviati al set di dati in Adobe Experience Platform.
Per impostare il flusso di dati:
-
Nell’interfaccia utente di Adobe Experience Platform, seleziona Datastreams (Flussi di dati) da DATA COLLECTION (RACCOLTE DATI) nella barra a sinistra.
-
Seleziona New Datastream (Nuovo flusso di dati).
-
Assegna un nome e una descrizione al tuo flusso di dati. Seleziona lo schema dall’elenco Event Schema (Schema eventi).
-
Seleziona Save (Salva).
-
Seleziona Add Service (Aggiungi servizio).
-
Nella schermata Add Service screen (Aggiungi servizio):
-
Seleziona Adobe Experience Platform dall’elenco Service (Servizio).
-
Assicurati di aver selezionato Enabled (Abilitato).
-
Seleziona il set di dati dall’elenco Event Dataset (Set di dati evento).
-
Abbandona le altre impostazioni e seleziona Save per salvare il flusso di dati.
-
Lo stream di dati è ora configurato per inoltrare i dati raccolti dall’app mobile al set di dati in Adobe Experience Platform.
Per ulteriori informazioni su come configurare un flusso di dati e come gestire i dati sensibili consulta la sezione Panoramica dei flussi di dati.
Usare i tag
Per implementare il codice sul sito per raccogliere effettivamente i dati, utilizza la funzione Tag in Adobe Experience Platform. Questa soluzione per la gestione dei tag consente di implementare il codice e altri requisiti di assegnazione dei tag. I tag offrono un’integrazione perfetta con Adobe Experience Platform tramite l’estensione Adobe Experience Platform Mobile SDK.
Creare il tag
-
Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Tags (Tag) all’interno di DATA COLLECTION (GESTIONE DATI).
-
Seleziona New Property (Crea set di dati).
Assegnare un nome al tag, quindi selezionare Mobile. Seleziona Save (Salva) per continuare.
Configurare il tag
Dopo aver creato il tag, devi configurarlo con le estensioni corrette e configurare elementi dati e regole in base a come desideri tenere traccia del sito e inviare dati ad Adobe Experience Platform.
Per configurare, seleziona il tag appena creato dall'elenco di Tag Properties.
Estensioni
Aggiungi l’estensione di Edge Network Adobe Platform al tag per garantire che tu possa inviare dati a Adobe Experience Platform (tramite lo stream di dati).
Per creare e configurare l'estensione Adobe Experience Platform Mobile SDK:
-
Seleziona Extensions nella barra a sinistra. Puoi vedere che le estensioni Mobile Core e Profile sono già disponibili.
-
Seleziona Catalog (Catalogo) nella barra superiore.
-
Cercare o scorrere fino all'estensione Adobe Experience Platform Edge Network e selezionare Install nel riquadro di destra per installarla.
-
Seleziona la sandbox e il flusso di dati creato in precedenza per il tuo Production Environment (Ambiente di produzione) e (facoltativamente) Staging Environment (Ambiente di gestione temporanea) e Development Environment (Ambiente di sviluppo).
-
Immetti Edge Network domain sotto Domain configuration. In genere utilizza
<organizationName>.data.adobedc.net
. -
Seleziona Save.
Per ulteriori informazioni, vedere Configurare l'estensione dell'Edge Network di Adobe Experience Platform.
Desideri anche impostare le seguenti estensioni aggiuntive dal catalogo:
- Identità.
- AEP ASSURANCE
- Consenso.
Per ulteriori informazioni sulle estensioni e sulla relativa configurazione, consulta Configurare una proprietà tag nell'esercitazione per app mobili su Experience Platform.
Elementi dati
Gli elementi dati sono i blocchi costitutivi per il dizionario dati (o mappa dati). Utilizza elementi dati per raccogliere, organizzare e distribuire dati in tutta la tecnologia marketing e pubblicitaria. Puoi impostare nel tag elementi di dati che leggono da dati o eventi dell’app mobile e che possono essere utilizzati per inviare dati a Adobe Experience Platform.
Ad esempio, desideri raccogliere il nome dell’operatore dall’app mobile.
Per definire un elemento dati del nome di un vettore:
-
Seleziona Data Elements (Elementi dati) nella barra a sinistra.
-
Seleziona Add Data Element (Aggiungi elemento dati).
-
Nella finestra di dialogo Create Data Element (Crea elemento dati):
-
Assegna un nome all’elemento dati, ad esempio
Carrier Name
(Nome pagina). -
Seleziona Mobile Core dall’elenco Extension (Estensioni).
-
Seleziona Carrier Name (Titolo) dall’elenco Data Element Type (Attributo).
-
Seleziona Save.
-
Puoi creare tutti gli elementi dati desiderati e utilizzarli nelle regole.
Regole
I tag in Adobe Experience Platform seguono un sistema basato su regole. Cercano le interazione degli utenti e i relativi dati. Quando i criteri descritti nelle tue regole vengono soddisfatti, la regola attiva l’estensione, lo script o il codice lato client identificato. Puoi utilizzare le regole per inviare dati (come un oggetto XDM) in Adobe Experience Platform utilizzando l’estensione di Edge Network Adobe Experience Platform.
Ad esempio, desideri inviare i dati dell’evento quando l’app mobile viene utilizzata (in primo piano) e quando l’app mobile non viene utilizzata (viene rimandata in background).
Per definire una regola:
-
Seleziona Rules (Regole) nella barra a sinistra.
-
Seleziona Create New Rule (Aggiungi elemento dati).
-
Nella finestra di dialogo Create Rule (Crea regola):
-
Assegna un nome alla regola, ad esempio
Application Status
. -
Seleziona + Add (Aggiungi) sotto Events (Eventi).
-
Nella finestra di dialogo Event Configuration (Configurazione evento):
-
Seleziona Mobile Core dall’elenco Extension (Estensioni)
-
Seleziona Foreground (Info pagina) dall’elenco Event Type (Tipo di elemento dati).
-
Seleziona Keep Changes (Crea set di dati).
-
-
Fai clic su accanto a Mobile Core - Foreground.
-
Seleziona Mobile Core dall’elenco Extension (Estensioni).
-
Seleziona Background (Info pagina) dall’elenco Event Type (Tipo di elemento dati).
-
Seleziona Keep Changes (Crea set di dati).
-
-
Fai clic su Aggiungi sotto ACTIONS. Nella finestra di dialogo Action Configuration (Configurazione evento):
-
Seleziona Adobe Experience Platform Edge Network dall’elenco Extension (Estensioni)
-
Seleziona Forward event to Edge Network (Info pagina) dall’elenco Action Type (Tipo di elemento dati).
-
Seleziona Keep Changes (Mantieni modifiche).
-
-
L’aspetto della regola dovrebbe essere il seguente:
-
Seleziona Save (Salva).
-
Quanto sopra è solo un esempio di definizione di una regola che invia dati XDM, contenenti lo stato dell’applicazione, alla rete Adobe Edge e a Adobe Experience Platform.
Puoi utilizzare le regole in vari modi nel tag per manipolare le variabili (utilizzando gli elementi dati).
Per ulteriori informazioni, consulta la sezione Regole per ulteriori informazioni.
Creare e pubblicare il tag
Dopo aver definito elementi dati e regole, devi generare e pubblicare il tag. Quando crei una build della libreria, devi assegnarla a un ambiente. Le estensioni, le regole e gli elementi dati della build vengono quindi compilati e inseriti nell’ambiente assegnato. Ogni ambiente fornisce un codice di incorporamento univoco che consente di integrare la build assegnata nel sito.
Per generare e pubblicare il tag:
-
Seleziona Publishing Flow (Flusso di pubblicazione) nella barra a sinistra.
-
Seleziona Select a working library (Seleziona una libreria di lavoro) e poi Add Library… (Aggiungi libreria…).
-
Nella finestra di dialogo Create Library (Crea libreria):
-
Assegna un nome alla libreria.
-
Seleziona Development (development) dall’elenco.Environment
-
Seleziona + Add All Changed Resources (Crea set di dati).
-
Seleziona Save & Build to Development (Salva e crea per lo sviluppo).
Il tag viene salvato e generato per l’ambiente di sviluppo. Un punto verde indica la corretta compilazione del tag nell’ambiente di sviluppo.
-
-
È possibile selezionare … per ricreare la libreria o spostarla in un ambiente di gestione temporanea o produzione.
I tag Adobe Experience Platform supportano flussi di lavoro di pubblicazione semplici o complessi che dovrebbero adattarsi alla distribuzione dell’Edge Network di Adobe Experience Platform.
Per ulteriori informazioni, consulta la sezione Panoramica di pubblicazione.
Recuperare il codice del tag
Infine, devi utilizzare il tag all’interno dell’app mobile di cui desideri tenere traccia.
Per ottenere istruzioni sul codice che spiegano come configurare l’app mobile e utilizzare il tag nell’app:
-
Seleziona Environments (Elementi dati) nella barra a sinistra.
-
Dall'elenco degli ambienti, selezionare il pulsante di installazione corretto.
Nella finestra di dialogo Mobile Install Instructions, selezionare la piattaforma appropriata (iOS, Android). Quindi utilizza il pulsante Copia accanto a ciascuno dei frammenti di codice pertinenti che desideri utilizzare per configurare e inizializzare l'app mobile:
-
Seleziona Close (Chiudi).
Invece del codice per l’ambiente di sviluppo, potresti aver selezionato un altro ambiente (staging, produzione) in base alla posizione in cui stai distribuendo l’SDK di Adobe Experience Platform Mobile.
Per ulteriori informazioni, consulta la sezione Ambienti.
Distribuire e convalidare
Ora puoi distribuire il codice all’interno dell’app mobile. Una volta implementata, l’app mobile inizia a raccogliere dati in Adobe Experience Platform.
Convalida l’implementazione, correggila laddove necessario e una volta corretta, distribuiscila nel tuo ambiente di gestione temporanea e produzione utilizzando la funzione di flusso di lavoro di pubblicazione dei tag.
Per informazioni molto più dettagliate, consulta l'esercitazione sull'implementazione di Adobe Experience Cloud nelle app per dispositivi mobili.
Configurare una connessione
Per utilizzare i dati di Adobe Experience Platform in Customer Journey Analytics, crea una connessione che include i dati risultanti dalla configurazione dello schema, del set di dati e del flusso di lavoro.
Una connessione consente di integrare set di dati da Adobe Experience Platform in Workspace. Per creare rapporti su questi set di dati, devi prima stabilire una connessione tra i set di dati in Adobe Experience Platform e Workspace.
Per creare la connessione:
-
Nell’interfaccia utente di Customer Journey Analytics, seleziona Connections (Connessioni) nel pannello di navigazione superiore.
-
Seleziona Create new connection (Crea uova connessione).
-
Nella schermata Untitled connection (Connessione senza titolo):
Assegna un nome e una descrizione alla connessione in Connection Settings (Impostazioni della connessione).
Seleziona la sandbox corretta dall’elenco Sandbox in Data settings (Impostazioni dati) e seleziona il numero di eventi giornalieri dall’elenco Average number of daily events (Numero medio di eventi giornalieri).
Seleziona Add datasets (Aggiungi set di dati).
Nel passaggio Select datasets (Seleziona set di dati) in Add datasets (Aggiungi set di dati):
-
Seleziona i set di dati creati in precedenza e/o altri set di dati rilevanti che desideri includere nella connessione (ad esempio i dati degli eventi di esperienza di tracciamento push e i dati del profilo push di Adobe Journey Optimizer)
-
Seleziona Next (Avanti).
Nel passaggio Datasets settings (Impostazioni set di dati) in Add datasets (Aggiungi set di dati):
-
Per ogni set di dati:
-
Seleziona un Person ID (ID persona) tra le identità disponibili definite negli schemi di set di dati in Adobe Experience Platform.
-
Seleziona l’origine dati corretta dall’elenco Data source type (Tipo di origine dati). Se specifichi Other (Altro), aggiungi una descrizione per l’origine dati.
-
Imposta Import all new data (Importa tutti i nuovi dati) e Dataset backfill existing data (Dati esistenti di backfill del set di dati) secondo le tue preferenze.
-
-
Seleziona Add datasets (Aggiungi set di dati).
Seleziona Save (Salva).
-
Per ulteriori informazioni su come creare e gestire una connessione e come selezionare e combinare i set di dati, consulta la sezione Panoramica delle connessioni.
Configurare una visualizzazione dati
Una visualizzazione dati è un contenitore specifico di Customer Journey Analytics che consente di determinare come interpretare i dati da una connessione. Specifica tutte le dimensioni e le metriche disponibili in Analysis Workspace, e da quali colonne tali dimensioni e metriche ottengono i loro dati. Le visualizzazioni dati sono definite in preparazione alle attività di reporting in Analysis Workspace.
Per creare la visualizzazione dati:
-
Nell’interfaccia utente di Customer Journey Analytics, seleziona Data views (Visualizzazioni dati) nel pannello di navigazione superiore.
-
Seleziona Create new data view (Crea nuova visualizzazione dati).
-
Nel passaggio Configure (Configura):
Seleziona la connessione dall’elenco Connection (Connessioni).
Assegna un nome e (facoltativamente) una descrizione alla connessione.
Seleziona Save and continue (Salva e continua).
-
Nel passaggio Components (Componenti):
Aggiungi qualsiasi campo dello schema e/o componente standard che desideri includere nelle caselle dei componenti METRICS (METRICHE) o DIMENSIONS (DIMENSIONI).
Seleziona Save and continue (Salva e continua).
-
Nel passaggio Settings (Impostazioni):
Lascia le impostazioni così come sono e seleziona Save and finish (Salva e fine).
Per ulteriori informazioni su come creare e modificare una visualizzazione dati, quali componenti sono disponibili per la visualizzazione dati e come utilizzare le impostazioni di filtro e sessioni, consulta la sezione Panoramica delle visualizzazioni dati.
Configurare un progetto
Analysis Workspace è uno strumento basato su browser flessibile che consente di creare rapidamente le analisi e condividere i dati rilevati sulla base dei tuoi dati. Usa i progetti Workspace per combinare componenti dati, tabelle e visualizzazioni per sviluppare analisi da condividere con altri nella tua organizzazione.
Per creare il progetto:
-
Nell’interfaccia utente di Customer Journey Analytics, seleziona Projects (Progetti) nel pannello di navigazione superiore.
-
Seleziona Projects (Progetti) nel pannello di navigazione a sinistra.
-
Seleziona Create project (Crea progetto).
Seleziona Blank project (Progetto vuoto).
-
Seleziona la visualizzazione dati dall’elenco.
.
-
Per creare il primo rapporto, inizia a trascinare dimensioni e metriche su Freeform table in Panel. Ad esempio, trascina
Events
come metrica ePush Title
come dimensione, suddivisi perEvent Type
per ottenere una panoramica delle notifiche push per la tua app mobile e di ciò che è successo a loro.
Per ulteriori informazioni su come creare progetti e generare analisi utilizzando componenti, visualizzazioni e pannelli, consulta la sezione Panoramica di Analysis Workspace.