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 alla rete Edge di Experienci 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 la rete Edge 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, devi disporre dell’accesso ad almeno una proprietà web insieme ai seguenti elementi diritti di proprietà:

Consulta la guida su gestione delle autorizzazioni per la raccolta dati per scoprire come concedere l’accesso a proprietà e diritti di proprietà.

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, devi assicurarti di disporre di tutte le autorizzazioni nelle seguenti categorie abilitate:

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

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 dati alla rete Edge, puoi anche, facoltativamente configurare l’inoltro degli eventi se la tua organizzazione dispone di una licenza per questo prodotto.

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 utilizzabile dalla rete Edge 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 nel menu 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 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 da aprire Proprietà dello schema nella barra a destra, dove puoi fornire un nome e una descrizione facoltativa per lo schema.

Per aggiungere altri campi allo schema, seleziona Aggiungi sotto 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 alla rete Edge 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 flusso 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 di ciascun prodotto, consulta 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 alla rete Edge.

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

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

Viene visualizzata la pagina della panoramica della proprietà. Da qui, seleziona Estensioni nel menu di navigazione a sinistra, seleziona quindi Catalogo. Trova l’elenco per Platform Web SDK (facoltativamente utilizzando la barra di ricerca per limitare i risultati) e seleziona 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. Sotto Flussi di dati, utilizza il menu a discesa per selezionare lo stream di dati 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 alla rete Edge, 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 Creare un nuovo elemento dati.

Nella schermata successiva, seleziona Adobe Experience Platform Web SDK sotto Estensione a discesa, quindi seleziona Oggetto XDM 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 si compilano 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à alla rete Edge 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 nel menu di navigazione a sinistra, seleziona quindi 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 di "invio modulo", ad esempio, seleziona la Core , quindi seleziona la Invia tipo di evento sotto Modulo categoria.

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. Puoi restringere il "Se" 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 alla rete Edge, seleziona Adobe Experience Platform Web SDK per l'estensione, e Invia evento per il tipo di azione.

La schermata si aggiorna per mostrare opzioni aggiuntive per configurare l’azione invia evento. Sotto Tipo, puoi fornire un valore di tipo personalizzato per compilare il eventType Campo XDM. Sotto 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 alla rete Edge.

Seleziona Mantieni modifiche al termine.

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 generarla 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. Consulta la sezione su installazione di ambienti per ulteriori informazioni.

Dopo aver installato l’ambiente sul sito web, puoi testare l’implementazione utilizzando Adobi Experience Platform Debugger.

Configurare l’inoltro degli eventi (facoltativo) event-forwarding

Dopo aver configurato l’SDK per l’invio dei dati alla rete Edge, puoi impostare l’inoltro degli eventi per indicare alla rete Edge 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, seleziona quindi Nuova proprietà. Immetti 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.

Una volta completata la build, il passaggio finale consiste nell’aggiornare lo stream di dati configurato in precedenza e abilita l’inoltro degli eventi. Per iniziare, passa a Flussi di dati 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 a 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.