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).

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à:

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:

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:

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.

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.

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.

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.

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.

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

Dopo aver aggiunto i campi necessari, seleziona Salva per salvare lo 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.

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.

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.

Il processo può essere riassunto come segue:

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à.

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.

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.

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.

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à.

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.

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

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.

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.

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

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.

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.

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.

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.

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.

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.

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 all’Edge Network.

Al termine, seleziona Mantieni modifiche.

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

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.

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

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.

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.

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.