Documentazione Experience Platform Raccolta dati

Panoramica end-to-end sulla raccolta dati

Ultimo aggiornamento: 4 aprile 2025

Argomenti:
ID Acquisto

Creato per:

Sviluppatore

Adobe Experience Platform raccoglie e trasferisce i dati ad altri prodotti Adobe e a destinazioni di terze parti. Per inviare i dati dell’evento dall’applicazione all’Edge Network di Experience Platform, è importante comprendere queste tecnologie di base e configurarle in modo da fornire i dati alle destinazioni richieste, quando necessario.

Questa guida fornisce un tutorial di alto livello su come inviare un evento tramite Edge Network utilizzando le funzionalità di raccolta dati di Experience Platform. In particolare, il tutorial illustra i passaggi necessari per installare e configurare l’estensione tag Adobe Experience Platform Web SDK nell’interfaccia utente di Data Collection (precedentemente Adobe Experience Platform Launch).

NOTE

Se non desideri utilizzare i tag, puoi anche scegliere di installare e configurare manualmente SDK, ma i passaggi successivi devono comunque essere completati come descritto di seguito.

Tutti i passaggi che riguardano l’interfaccia utente di Data Collection possono essere eseguiti anche nell’interfaccia utente di Experience Platform.

Prerequisiti

Questa esercitazione utilizza l’interfaccia utente di Data Collection per creare uno schema, configurare uno stream di dati e installare il Web SDK. Per eseguire queste azioni nell'interfaccia utente, è necessario disporre dell'accesso ad almeno una proprietà Web insieme ai seguenti diritti di proprietà:

Sviluppa
Gestire le estensioni

Per informazioni su come concedere l'accesso a proprietà e diritti di proprietà, consulta la guida su gestione delle autorizzazioni per la raccolta dati.

Per utilizzare i vari prodotti di raccolta dati menzionati in questa guida, devi anche avere accesso agli stream di dati e la possibilità di creare e gestire gli schemi. Se hai bisogno di accedere a una di queste funzioni, contatta il team del tuo account Adobe per ottenere l’accesso necessario. Se non hai acquistato Adobe Experience Platform, Adobe ti fornirà l’accesso necessario per utilizzare SDK senza alcun costo aggiuntivo.

Se disponi già dell'accesso ad Experience Platform, assicurati di disporre di tutte le autorizzazioni per le seguenti categorie abilitate:

Modellazione dati
Identità

Consulta la panoramica dell'interfaccia utente di controllo degli accessi per scoprire come concedere agli utenti le autorizzazioni per le funzionalità di Experience Platform.

Riepilogo del processo

Il processo di configurazione della raccolta dati per il sito web può essere riassunto come segue:

Crea uno schema per determinare la struttura dei dati inviati ad Edge Network.
Crea uno stream di dati per configurare le destinazioni a cui inviare i dati.
Installa e configura Web SDK per inviare dati allo stream di dati quando si verificano determinati eventi sul sito Web.

Una volta che sei in grado di inviare dati ad Edge Network, puoi anche configurare l'inoltro degli eventi se la tua organizzazione dispone di una licenza per questo evento.

Crea uno schema

Experience Data Model (XDM) è una specifica open-source che fornisce strutture e definizioni comuni per i dati sotto forma di schemi. In altre parole, XDM è un modo per strutturare e formattare i dati in modo utilizzabile da Edge Network e altre applicazioni Adobe Experience Cloud.

Il primo passaggio nella configurazione delle operazioni di raccolta dei dati consiste nel creare uno schema XDM per rappresentare i dati. In un passaggio successivo di questa esercitazione, mapperai i dati che desideri inviare alla struttura di questo schema.

NOTE

Gli schemi XDM sono molto personalizzabili. Invece di essere eccessivamente prescrittivi, i passaggi descritti di seguito si concentrano specificamente sui requisiti dello schema per Web SDK. Al di fuori di questi parametri, puoi definire la struttura rimanente dei dati come preferisci.

Nell'interfaccia utente, seleziona Schemi nell'area di navigazione a sinistra. Da qui puoi visualizzare un elenco degli schemi creati in precedenza e appartenenti alla tua organizzazione. Per continuare, seleziona Crea schema, quindi seleziona XDM ExperienceEvent dal menu a discesa.

Area di lavoro Schemi

Viene visualizzata una finestra di dialogo che richiede di iniziare ad aggiungere gruppi di campi allo schema. Per inviare eventi tramite Web SDK, è necessario aggiungere il gruppo di campi Mixin ExperienceEvent di AEP Web SDK. Questo gruppo di campi contiene le definizioni per gli attributi dei dati raccolti automaticamente dalla libreria Web SDK.

Utilizzare la barra di ricerca per limitare l'elenco e semplificare la ricerca di questo gruppo di campi. Dopo averlo trovato, selezionalo dall'elenco prima di selezionare Aggiungi gruppi di campi.

Area di lavoro Schemi

Viene visualizzata l’area di lavoro dello schema, con una struttura ad albero dello schema XDM che include i campi forniti dal gruppo di campi di Web SDK.

Struttura dello schema

Selezionare il campo radice nella struttura per aprire Proprietà schema nella barra a destra, dove è possibile fornire un nome e una descrizione facoltativa per lo schema.

Denomina lo schema

Per aggiungere altri campi allo schema, seleziona Aggiungi nella sezione Gruppi di campi nella barra a sinistra.

Aggiungi gruppi di campi

NOTE

Consulta la guida su aggiunta di gruppi di campi nella documentazione XDM per i passaggi dettagliati su come cercare gruppi di campi diversi in base ai tuoi casi d'uso.

Si consiglia di aggiungere solo campi per i dati che intendi inviare tramite Edge Network. Dopo aver aggiunto i campi a uno schema e averlo salvato, è possibile apportare allo schema solo modifiche aggiuntive. Per ulteriori informazioni, consulta la sezione sulle regole dell'evoluzione dello schema.

Dopo aver aggiunto i campi necessari, seleziona Salva per salvare lo schema.

Salva schema

Creare un flusso di dati

Un flusso di dati è una configurazione che indica all’Edge Network dove desideri che vengano inviati i dati. In particolare, un datastream specifica a quali prodotti Experience Cloud desideri inviare i dati e come desideri che i dati vengano gestiti e memorizzati in ciascun prodotto.

NOTE

Se desideri utilizzare l'inoltro eventi (supponendo che la tua organizzazione disponga della licenza per questa funzionalità), devi abilitarlo per uno stream di dati nello stesso modo in cui abiliti i prodotti Adobe. I dettagli su questo processo sono trattati in una sezione successiva.

Seleziona Flussi di dati nel menu di navigazione a sinistra. Da qui puoi selezionare uno stream di dati esistente dall'elenco da modificare, oppure puoi creare una nuova configurazione selezionando Nuovo stream di dati.

Stream di dati

I requisiti di configurazione per un datastream dipendono dai prodotti e dalle funzionalità a cui invii i dati. Per informazioni dettagliate sulle opzioni di configurazione per ciascun prodotto, consulta la panoramica sugli stream di dati.

Installare e configurare il Web SDK

Dopo aver creato uno schema e un flusso di dati, il passaggio successivo consiste nell’installare e configurare Experience Platform Web SDK per iniziare a inviare dati ad Edge Network.

NOTE

Questa sezione utilizza l’interfaccia utente di Data Collection per configurare l’estensione tag Web SDK, ma puoi anche installarla e configurarla utilizzando codice non elaborato. Per ulteriori informazioni, consulta le seguenti guide:

Inoltre, anche se desideri utilizzare solo l'inoltro degli eventi, devi comunque installare e configurare SDK come descritto prima di configurare l'inoltro degli eventi in un passaggio successivo.

Il processo può essere riassunto come segue:

Installare Adobe Experience Platform Web SDK in una proprietà tag per accedere alle relative funzionalità.
Crea un elemento dati di oggetti XDM per mappare le variabili sul sito Web alla struttura dello schema XDM creato in precedenza.
Crea una regola per indicare a SDK quando deve inviare dati ad Edge Network.
Crea e installa una libreria per implementare la regola nel sito Web.

Installare SDK su una proprietà tag

Seleziona Tag nel menu di navigazione a sinistra per visualizzare un elenco di proprietà dei tag. Puoi scegliere una proprietà esistente da modificare, se lo desideri, oppure selezionare Nuova proprietà.

Proprietà

Se crei una nuova proprietà, fornisci un nome descrittivo e imposta Platform su Web. Fornisci il dominio completo per la proprietà Web, quindi seleziona Salva.

Crea proprietà

Viene visualizzata la pagina della panoramica della proprietà. Da qui, seleziona Estensioni nell'area di navigazione a sinistra, quindi seleziona Catalogo. Individuare l'elenco per Experience Platform Web SDK (se si desidera utilizzare la barra di ricerca per limitare i risultati) e selezionare Installa.

Installa Web SDK

Viene visualizzata la pagina di configurazione per SDK. La maggior parte dei valori richiesti viene compilata automaticamente con i valori predefiniti che puoi scegliere di modificare se lo desideri.

Configurazione del Web SDK

Prima di installare SDK, tuttavia, devi selezionare un flusso di dati in modo che sappia a dove inviare i dati. In Datastreams, utilizza il menu a discesa per selezionare il datastream configurato in un passaggio precedente. Dopo aver impostato lo stream di dati, seleziona Salva per completare l'installazione di SDK nella proprietà.

Imposta lo stream di dati e salva

Creare un elemento dati XDM

Affinché SDK possa inviare dati ad Edge Network, questi devono essere mappati sullo schema XDM creato in un passaggio precedente. Questa mappatura viene eseguita tramite l’utilizzo di un elemento dati.

Nell'interfaccia utente, seleziona Elementi dati, quindi seleziona Crea nuovo elemento dati.

Crea nuovo elemento dati

Nella schermata successiva, seleziona Adobe Experience Platform Web SDK nel menu a discesa Extension, quindi seleziona XDM object per il tipo di elemento dati.

Tipo di oggetto XDM

Viene visualizzata la finestra di dialogo di configurazione per il tipo di oggetto XDM. La finestra di dialogo seleziona automaticamente la sandbox di Experience Platform e da qui puoi visualizzare tutti gli schemi creati in tale sandbox. Seleziona dall’elenco lo schema XDM creato in precedenza.

Tipo di oggetto XDM

Viene visualizzata la struttura dello schema. Tutti i campi con un asterisco (*) indicano i campi che verranno compilati automaticamente quando si attivano gli eventi. Per tutti gli altri campi, puoi esplorare la struttura dello schema e compilare il resto dei dati.

Mappatura dei dati su campi XDM

NOTE

La schermata precedente illustra come mappare una variabile accessibile a livello globale dal lato client del sito Web (cartAbandonsTotal) a un campo XDM facendo riferimento al relativo nome nel campo Valore, circondato dai segni di percentuale (%).

Per compilare questi campi, puoi anche utilizzare altri elementi dati creati in precedenza. Per ulteriori informazioni, vedi il riferimento su elementi dati nella documentazione dei tag.

Dopo aver completato la mappatura dei dati sullo schema, fornisci un nome per l'elemento dati prima di selezionare Salva.

Denomina e salva lelemento dati

Creare una regola

Dopo che hai salvato l’elemento dati, il passaggio successivo consiste nel creare una regola che lo invierà all’Edge Network ogni volta che si verifica un determinato evento sul sito web (ad esempio quando un cliente aggiunge un prodotto a un carrello).

Puoi impostare regole per praticamente qualsiasi evento che possa verificarsi sul sito web. Ad esempio, in questa sezione viene illustrato come creare una regola che verrà attivata quando un cliente invia un modulo. Il seguente HTML rappresenta una semplice pagina web con un modulo "Aggiungi al carrello", che sarà l’oggetto della regola:

<!DOCTYPE html>
<html>
<body>

  <form id="add-to-cart-form">
    <label for="item">Product:</label><br>
    <input type="text" id="item" name="item"><br>
    <label for="amount">Amount:</label><br>
    <input type="number" id="amount" name="amount" value="1"><br><br>
    <input type="submit" value="Add to Cart">
  </form>

</body>
</html>

Nell'interfaccia utente di Data Collection, seleziona Regole nell'area di navigazione a sinistra, quindi seleziona Crea nuova regola.

Regole

Nella schermata successiva, specifica un nome per la regola. Da qui, il passaggio successivo è quello di determinare l’evento per la regola (in altre parole, quando la regola verrà attivata). Seleziona Aggiungi in Eventi.

Regola nome

Viene visualizzata la pagina di configurazione dell’evento. Per configurare un evento, devi innanzitutto selezionare il tipo di evento. I tipi di evento sono forniti dalle estensioni. Per impostare un evento "invio modulo", ad esempio, seleziona l'estensione Core, quindi seleziona il tipo di evento Invia nella categoria Modulo.

NOTE

Per ulteriori informazioni sui diversi tipi di eventi forniti dalle estensioni Web di Adobe, tra cui la relativa configurazione, consulta la Guida di riferimento per le estensioni di Adobe nella documentazione dei tag.

L'evento di invio modulo consente di utilizzare un selettore CSS per fare riferimento a un elemento specifico per la regola su cui attivare. Nell'esempio seguente, l'ID add-to-cart-form viene utilizzato in modo che questa regola venga attivata solo per il modulo "Aggiungi al carrello". Seleziona Mantieni modifiche per aggiungere l'evento alla regola.

Configurazione evento

Viene visualizzata di nuovo la pagina di configurazione della regola dove si vede che l'evento è stato aggiunto. È possibile limitare "If" aggiungendo ulteriori condizioni alla regola.

In caso contrario, il passaggio successivo consiste nell’aggiungere un’azione da eseguire per la regola quando viene attivata. Seleziona Aggiungi in Azioni per continuare.

Aggiungi azione

Viene visualizzata la pagina di configurazione dell’azione. Per ottenere la regola per inviare dati ad Edge Network, selezionare Adobe Experience Platform Web SDK per l'estensione e Send event per il tipo di azione.

Tipo azione

La schermata si aggiorna per mostrare opzioni aggiuntive per configurare l’azione invia evento. In Tipo puoi fornire un valore di tipo personalizzato per compilare il campo XDM eventType. In Dati XDM, fornire il nome del tipo di dati XDM creato in precedenza (racchiuso tra simboli di percentuale) oppure selezionare l'icona del database ( ) per selezionarlo da un elenco. Questi sono i dati che verranno infine inviati ad Edge Network.

Al termine, seleziona Mantieni modifiche.

Configurazione azione

Al termine della configurazione della regola, seleziona Salva per completare il processo.

Salva regola

Creare e installare una libreria

Una volta configurata la regola, puoi aggiungerla a una libreria di tag, generarla in un ambiente e installarla sul sito web.

NOTE

Se non hai ancora configurato un ambiente nell’interfaccia utente di Data Collection, devi farlo prima di poter creare una build. Per ulteriori informazioni, consulta la sezione sulla configurazione di un ambiente per una proprietà Web nella documentazione dei tag.

Per informazioni su come creare una libreria, aggiungere estensioni e regole alla libreria e creare tale libreria in un ambiente, consulta la guida su gestione delle librerie nella documentazione sui tag. Quando crei la libreria, accertati di includere l’estensione Experience Platform Web SDK e le regole di raccolta dati create in precedenza.

Dopo aver creato la libreria e aver assegnato la relativa build a un ambiente, puoi installare tale ambiente sul lato client del sito web. Per ulteriori informazioni, vedere la sezione relativa all'installazione di ambienti.

Dopo aver installato l'ambiente sul sito Web, puoi testare l'implementazione utilizzando Adobe Experience Platform Debugger.

Configurare l’inoltro degli eventi (facoltativo)

NOTE

L’inoltro degli eventi è disponibile solo per le organizzazioni per le quali è stata concessa la licenza.

Dopo aver configurato SDK per l’invio dei dati ad Edge Network, puoi impostare l’inoltro degli eventi per indicare all’Edge Network dove desideri che vengano consegnati i dati.

Per utilizzare l’inoltro degli eventi, devi innanzitutto creare una proprietà di inoltro degli eventi. Seleziona Inoltro eventi nella barra di navigazione a sinistra, quindi seleziona Nuova proprietà. Specifica un nome per la proprietà prima di selezionare Salva.

Dopo aver creato una proprietà di inoltro degli eventi, il passaggio successivo consiste nel creare una regola che determini dove devono essere inviati i dati. Le regole per le proprietà di inoltro degli eventi sono costruite in modo molto simile alle proprietà dei tag, con l’eccezione che non è possibile specificare alcun evento (poiché l’inoltro degli eventi riguarda solo gli eventi che riceve direttamente dallo stream di dati). Per l’azione della regola, puoi utilizzare una delle estensioni di inoltro degli eventi disponibili oppure il codice personalizzato per distribuire l’evento.

Regola di inoltro eventi

Come prima, una volta configurata la regola, devi aggiungerla a una libreria e generarla in un ambiente.

Al termine della compilazione, il passaggio finale consiste nell'aggiornare lo stream di dati configurato in precedenza e abilitare l'inoltro degli eventi. Per iniziare, passa a Datastreams e seleziona lo stream di dati in questione dall'elenco. Da qui, abilita l’interruttore per l’inoltro degli eventi e fornisci i nomi della proprietà e dell’ambiente appena configurati.

Stream dati inoltro eventi

Passaggi successivi

Questa guida fornisce una panoramica end-to-end di alto livello su come inviare dati ad Edge Network utilizzando Experience Platform Web SDK. Per ulteriori informazioni sui vari componenti e servizi coinvolti, consulta la documentazione accessibile dai collegamenti presenti in questa guida.

recommendation-more-help