Panoramica end-to-end sulla raccolta dati

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

Questa guida fornisce un tutorial di alto livello su come inviare un evento tramite l’Edge Network utilizzando le funzionalità di raccolta dati di 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 l’SDK, ma i passaggi successivi devono ancora 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 l’SDK per web. 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 l’SDK senza costi aggiuntivi.

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

  • Modellazione dati
  • Identità

Per informazioni su come concedere autorizzazioni per le funzionalità di Platform agli utenti, consulta la panoramica dell'interfaccia utente di controllo degli accessi.

Riepilogo del processo

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

  1. Creare uno schema per determinare la struttura dei dati inviati all'Edge Network.
  2. Crea uno stream di dati per configurare le destinazioni a cui inviare i dati.
  3. 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 i dati all'Edge Network, puoi anche configurare l'inoltro degli eventi se la tua organizzazione dispone di una licenza per esso.

Crea uno schema 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 che sia utilizzabile dall’Edge Network e da 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 l’SDK per web. 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 SDK Web.

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 dell’SDK per web.

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 l’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 datastream

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 si desidera utilizzare l'inoltro eventi (presupponendo che l'organizzazione disponga della licenza per la funzionalità), è necessario abilitarla per uno stream di dati nello stesso modo in cui si abilitano 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 Web SDK install

Dopo aver creato uno schema e un flusso di dati, il passaggio successivo consiste nell’installare e configurare Platform Web SDK per iniziare a inviare dati all’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 l'SDK come descritto prima di configurare l'inoltro degli eventi in un passaggio successivo.

Il processo può essere riassunto come segue:

  1. Installa Adobe Experience Platform Web SDK in una proprietà tag per accedere alle funzionalità.
  2. Crea un elemento dati di oggetti XDM per mappare le variabili sul sito Web alla struttura dello schema XDM creato in precedenza.
  3. Crea una regola per indicare all'SDK quando deve inviare i dati all'Edge Network.
  4. Crea e installa una libreria per implementare la regola nel sito Web.

Installare l’SDK su una proprietà tag install-sdk

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. Trovare l'elenco per 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 l’SDK. La maggior parte dei valori richiesti viene compilata automaticamente con i valori predefiniti che puoi scegliere di modificare se lo desideri.

Configurare Web SDK

Prima di installare l’SDK, tuttavia, devi selezionare uno stream 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 dell'SDK nella proprietà.

Imposta lo stream di dati e salva

Creare un elemento dati XDM data-element

Affinché l'SDK possa inviare dati all'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 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 aver 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 Adobe, tra cui la relativa configurazione, vedi il riferimento per le estensioni 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 i dati all'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 ( Icona del database ) per selezionarlo da un elenco. Questi sono i dati che verranno infine inviati all’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 library

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 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) event-forwarding

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

Dopo aver configurato l’SDK per l’invio dei dati all’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 all’Edge Network utilizzando 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
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1