Acquisire dati tramite Web SDK
Questa guida introduttiva spiega come inserire i dati di tracciamento dei siti Web direttamente in Adobe Experience Platform utilizzando l’SDK per Web di Adobe Experience Platform e la rete Edge e quindi utilizzarli in 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.
-
Usare i tag per configurare facilmente regole ed elementi dati rispetto ai dati presenti nel livello dati sul sito Web. 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 acquisire i dati in Adobe Experience Platform, devi innanzitutto 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 questa 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
Immagina di voler tenere traccia di alcuni dati minimi provenienti dai profili che visitano il tuo sito Web, ad esempio il nome della pagina o 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 Schemi in GESTIONE DATI.
-
Seleziona Crea schema.
-
Nel passaggio Selezionare una classe della procedura guidata Crea schema:
-
Seleziona Evento esperienza.
note info INFO Per modellare il comportamento di un profilo (come nome di scena, premere il pulsante per aggiungere al carrello) viene utilizzato uno schema evento esperienza. Per modellare gli attributi del profilo (come nome, e-mail, genere) viene utilizzato uno schema Individual Profile. -
Seleziona Avanti.
-
-
Nel passaggio Nome e revisione della procedura guidata Crea schema:
-
Immetti un nome visualizzato dello schema per lo schema e (facoltativo) una Descrizione.
-
Seleziona Fine.
-
-
Nella scheda Struttura dello schema di esempio:
-
Selezionare + Aggiungi in 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 Aggiungi gruppi di campi, seleziona il gruppo di campi AEP Web 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
web > webPageDetails > name.
Seleziona Indietro per chiudere l’anteprima.
-
Seleziona Aggiungi gruppi di campi.
-
-
Seleziona + accanto al nome dello schema nel pannello Struttura.
-
Nel pannello Proprietà campo, immetti
Identificationcome nome, Identificazione come Nome visualizzato, seleziona Oggetto come Tipo e seleziona Core ExperienceEvent v2.1 come Gruppo campi.note NOTE Se tale gruppo di campi non è disponibile, cercane un altro contenente campi di identità. Oppure crea un nuovo gruppo di campi e aggiungi nuovi campi di identità (come ecid,crmIde altri di cui hai bisogno) al gruppo di campi e seleziona il nuovo gruppo di campi.
L’oggetto di identificazione aggiunge funzionalità di individuazione dello schema. Nel tuo caso, immagina di voler identificare i profili che visitano il tuo sito utilizzando l’ID Experience Cloud e l’indirizzo e-mail. Sono disponibili molti altri attributi per monitorare l’identificazione del visitatore (ad esempio, ID cliente, ID di fidelizzazione).
Seleziona Applica per aggiungere questo oggetto allo schema.
-
Seleziona il campo ecid nell’oggetto di identificazione appena aggiunto, quindi seleziona Identità e Identità primaria e ECID dall’elenco Spazio dei nomi 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 Applica. Nell’attributo ecid viene visualizzata l’icona di un’impronta digitale.
-
Seleziona il campo email nell’oggetto di identificazione appena aggiunto, quindi seleziona Identity e Email dall’elenco Identity namespace nel pannello Field Properties.
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 Applica. Nell’attributo e-mail viene visualizzata l’icona di un’impronta digitale.
Seleziona Salva.
-
Seleziona l’elemento principale dello schema con il nome dello schema, quindi seleziona l’opzione 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 Salva per salvare lo schema.
Hai creato uno schema minimo che modella i dati che puoi acquisire dal tuo sito Web. Lo schema consente di identificare i profili utilizzando Experience Cloud Identity e l’indirizzo e-mail. Abilitando lo schema per il profilo, garantisci che i dati acquisiti dal tuo sito web vengano aggiunti a Real-Time Customer Profile.
Accanto ai dati sul comportamento, puoi anche acquisire i dati degli attributi del profilo dal sito (ad esempio i dettagli dei profili che si abbonano a una newsletter).
Per acquisire questi 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 l’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, che viene eseguito tramite set di dati.
Per configurare il set di dati:
-
Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Set di dati in GESTIONE DATI.
-
Seleziona Crea set di dati.
-
Seleziona Crea set di dati dallo schema.
-
Seleziona lo schema creato in precedenza e seleziona Successivo.
-
Assegna un nome al set di dati e (facoltativamente) fornisci una descrizione.
-
Seleziona Fine.
-
Selezionare l’opzione Profilo.
Viene richiesto di abilitare il set di dati per il profilo. Una volta abilitato, 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. È il flusso di dati che determina a quali servizi vengono inoltrati i dati.
Nella configurazione, desideri che i dati raccolti dal sito Web 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 da DATA COLLECTION nella barra a sinistra.
-
Seleziona Nuovo flusso di dati.
-
Assegna un nome e una descrizione al tuo flusso di dati. Seleziona lo schema dall’elenco Schema evento.
-
Seleziona Salva.
-
Selezionare Aggiungi servizio.
-
Nella schermata Aggiungi servizio:
-
Selezionare Adobe Experience Platform dall’elenco Service.
-
Assicurarsi che Enabled sia selezionato.
-
Seleziona il set di dati dall’elenco Set di dati evento.
-
Lascia le altre impostazioni e seleziona Salva per salvare lo stream di dati.
-
Il flusso di dati è ora configurato per inoltrare i dati raccolti dal sito Web 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 diretta con Adobe Experience Platform tramite l’estensione dell’SDK per Web di Adobe Experience Platform.
Creare il tag
-
Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Tag in RACCOLTA DATI.
-
Seleziona Nuova proprietà.
Assegna un nome al tag, seleziona Web e immetti un nome di dominio. Seleziona 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 a Adobe Experience Platform.
Seleziona il tag appena creato dall’elenco di Proprietà tag per aprirlo.
Estensioni
Per garantire che sia possibile inviare dati a Adobe Experience Platform (tramite lo stream di dati), aggiungi l’estensione Adobe Platform Web SDK al tag.
Per creare e configurare l’estensione Adobe Experience Platform Web SDK:
-
Seleziona Estensioni nella barra a sinistra.
-
Seleziona Catalogo nella barra superiore.
-
Cerca o scorri fino all’estensione Adobe Experience Platform Web SDK e seleziona Installa per installarla.
{width="35%"}
-
Seleziona la sandbox e lo stream di dati creato in precedenza per il tuo ambiente di produzione e (facoltativo) ambiente di staging e ambiente di sviluppo.
Seleziona Salva.
Per ulteriori informazioni, consulta la sezione Configurare l’estensione Adobe Experience Platform Web SDK.
Il Web SDK include il servizio Experience Platform Identity, pertanto non è necessario aggiungere l’estensione tag Servizio Experience Cloud ID alla proprietà.
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 elementi dati nel tag che leggono dal livello dati e possono essere utilizzati per inviare dati ad Adobe Experience Platform.
Esistono diversi tipi di elementi dati. Devi innanzitutto impostare un elemento dati per acquisire il nome della pagina che le persone visualizzano sul tuo sito.
Per definire un elemento dati nome pagina:
-
Seleziona Elementi dati nella barra a sinistra.
-
Selezionare Aggiungi elemento dati.
-
Nella finestra di dialogo Crea elemento dati:
-
Assegna un nome all’elemento dati, ad esempio
Page Name(Nome pagina). -
Seleziona Core dall’elenco Estensione.
-
Selezionare Informazioni pagina dall’elenco Tipo elemento dati.
-
Selezionare Titolo dall’elenco Attributo.
In alternativa, è possibile utilizzare il valore di una variabile del livello dati, ad esempio
pageNamee il tipo di elemento dati Variabile JavaScript per definire l’elemento dati.
-
Seleziona Salva.
-
Ora vuoi mappare uno qualsiasi degli elementi dati specifici allo schema definito in precedenza. Puoi definire un altro elemento dati che fornisce una rappresentazione dello schema XDM.
Per definire un elemento dati oggetto XDM:
-
Seleziona Elementi dati nella barra a sinistra.
-
Selezionare Aggiungi elemento dati.
-
Nella finestra di dialogo Crea elemento dati:
-
Assegna un nome all’elemento dati, ad esempio
XDM - Page View(Nome pagina). -
Selezionare Adobe Experience Platform Web SDK dall’elenco Estensione.
-
Selezionare Oggetto XDM dall’elenco Tipo elemento dati.
-
Seleziona la sandbox dall’elenco Sandbox.
-
Seleziona lo schema dall’elenco Schema.
-
Mappa l’attributo
web > webPageDetails > nameall’elemento dati Page Name (Nome pagina), definito nello schema.
-
Seleziona Salva.
-
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 Adobe Experience Platform Web SDK.
Per definire una regola:
-
Seleziona Regole nella barra a sinistra.
-
Seleziona Crea nuova regola.
-
Nella finestra di dialogo Crea regola:
-
Assegna un nome alla regola, ad esempio
Page View. -
Seleziona + Aggiungi sotto Eventi.
-
Nella finestra di dialogo Configurazione evento:
-
Seleziona Core dall’elenco Estensione.
-
Selezionare Window Loaded dall’elenco Event Type.
-
Seleziona Mantieni modifiche.
-
-
Seleziona + Aggiungi sotto Azioni.
-
Nella finestra di dialogo Configurazione azione:
-
Selezionare Adobe Experience Platform Web SDK dall’elenco Estensione.
-
Selezionare Invia evento dall’elenco Tipo azione.
-
Selezionare web.webpagedetails.pageViews dall’elenco Type.
-
Seleziona l’icona del cilindro accanto a dati XDM e seleziona XDM - Visualizzazione pagina dall’elenco degli elementi dati.
- Seleziona Mantieni modifiche.
-
-
L’aspetto della regola dovrebbe essere il seguente:
-
Seleziona Salva.
-
Quanto sopra è solo un esempio di definizione di una regola che invia a Adobe Experience Platform dati XDM, contenenti valori da altri elementi di dati.
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 da incorporare univoco che consente di integrare la build assegnata nel sito.
Per generare e pubblicare il tag:
-
Seleziona Flusso di pubblicazione dalla barra a sinistra.
-
Seleziona Seleziona una libreria di lavoro, seguita da Aggiungi libreria….
-
Nella finestra di dialogo Crea libreria:
-
Assegna un nome alla libreria.
-
Selezionare Sviluppo (sviluppo) dall’elenco Ambiente.
-
Selezionare + Aggiungi tutte le risorse modificate.
-
Seleziona Salva e genera in sviluppo.
Il tag viene salvato e quindi creato per il tuo ambiente di sviluppo. Un punto verde indica la corretta compilazione del tag nell’ambiente di sviluppo.
-
-
È possibile selezionare … per ricompilare la libreria o spostarla in un ambiente di staging o produzione.
I tag Adobe Experience Platform supportano flussi di lavoro di pubblicazione semplici o complessi che devono adattarsi alla distribuzione dell’SDK Web di Adobe Experience Platform.
Per ulteriori informazioni, consulta la sezione Panoramica di pubblicazione.
Recuperare il codice del tag
Infine, devi installare il tag sul sito web di cui desideri tenere traccia, il che implica il posizionamento di codice nel tag di intestazione del modello del sito web.
Per ottenere il codice che fa riferimento al tag:
-
Seleziona Ambienti nella barra a sinistra.
-
Dall’elenco degli ambienti, seleziona il pulsante di installazione (casella) corretto.
Nella finestra di dialogo Istruzioni di installazione Web, seleziona il pulsante Copia accanto al codice di script che dovrebbe essere simile al seguente:
code language-none <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
-
Seleziona Chiudi.
Invece del codice per l’ambiente di sviluppo, potresti aver selezionato un altro ambiente (gestione temporanea, produzione) in base al punto in cui stai distribuendo l’SDK Web di Adobe Experience Platform.
Per ulteriori informazioni, consulta la sezione Ambienti.
Distribuire e convalidare
Ora puoi distribuire il codice nella versione di sviluppo del tuo sito Web all’interno del tag <head>. Una volta implementato, il sito Web inizia a raccogliere dati in Adobe Experience Platform.
Convalida l’implementazione, correggila laddove necessario e una volta corretta, implementala nell’ambiente di staging e di produzione utilizzando la funzione di flusso di lavoro di pubblicazione dei tag.
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 Connessioni, facoltativamente da Gestione dati, nel menu principale.
-
Seleziona Crea nuova connessione.
-
Nella schermata Connessione senza titolo:
Denomina e descrivi la connessione in Impostazioni connessione.
Selezionare la sandbox corretta dall’elenco Sandbox in Impostazioni dati e selezionare il numero di eventi giornalieri dall’elenco Numero medio di eventi giornalieri.
Seleziona Aggiungi set di dati.
Nel passaggio Seleziona set di dati in Aggiungi set di dati:
-
Seleziona il set di dati creato in precedenza (
Example dataset(Set di dati di fidelizzazione di esempio)) e qualsiasi altro set di dati da includere nella connessione.
-
Seleziona Avanti.
Nel passaggio Impostazioni set di dati in Aggiungi set di dati:
-
Per ogni set di dati:
-
Seleziona un ID persona dalle identità disponibili definite negli schemi di set di dati in Adobe Experience Platform.
-
Selezionare l’origine dati corretta dall’elenco Tipo origine dati. Se si specifica Altro, aggiungere una descrizione per l’origine dati.
-
Imposta Importa tutti i nuovi dati e Recupera i dati esistenti del set di dati in base alle tue preferenze.
-
-
Seleziona Aggiungi set di dati.
Seleziona 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 Visualizzazioni dati, facoltativamente da Gestione dati, nel menu principale.
-
Selezionare Crea nuova visualizzazione dati.
-
Nel passaggio Configura:
Selezionare la connessione dall’elenco Connessione.
Assegna un nome e (facoltativamente) una descrizione alla connessione.
Seleziona Salva e continua.
-
Nel passaggio Componenti:
Aggiungi qualsiasi campo schema e/o componente standard da includere nelle caselle dei componenti METRICS o DIMENSIONS.
Seleziona Salva e continua.
-
Nel passaggio Impostazioni:
Lasciare le impostazioni immutate e selezionare Salva e termina.
Consulta Panoramica delle visualizzazioni dati per ulteriori informazioni su come creare e modificare una visualizzazione dati, quali componenti sono disponibili per l’utilizzo nella visualizzazione dati e come utilizzare le impostazioni di segmenti e sessioni.
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 Progetti nel menu principale.
-
Seleziona Progetti nel menu di navigazione a sinistra.
-
Seleziona Crea progetto.
Seleziona Progetto vuoto.
-
Seleziona la visualizzazione dati dall’elenco.
.
-
Per creare il primo rapporto, inizia a trascinare dimensioni e metriche sulla tabella a forma libera nel pannello. Ad esempio, trascina
Program Points BalanceePage Viewcome metriche eemailcome dimensione per ottenere una panoramica rapida dei profili che hanno visitato il tuo sito Web e che fanno parte del programma di fidelizzazione per la raccolta di punti di fidelizzazione.
Per ulteriori informazioni su come creare progetti e generare analisi utilizzando componenti, visualizzazioni e pannelli, consulta la sezione Panoramica di Analysis Workspace.