Acquisire dati tramite Web SDK

Ultimo aggiornamento: 17 aprile 2025

Creato per:

  • Amministratore

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.

NOTE
Questa guida rapida è una guida semplificata su come acquisire in Adobe Experience Platform i dati raccolti dal sito e utilizzarli in Customer Journey Analytics. Ti consigliamo vivamente di esaminare le informazioni aggiuntive quando vi fai riferimento.

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:

  1. Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Schemas (Schemi) all’interno di DATA MANAGEMENT (GESTIONE DATI).

  2. Selezionare Create schema.
    .

  3. Nel passaggio Selezionare una classe della procedura guidata Crea schema:

    1. Seleziona Experience Event.

      Creare uno schema che evidenzia l’evento esperienza

      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.

    2. Seleziona Next.

  4. In Name and review step della procedura guidata Create schema:

    1. Immetti un Schema display name per lo schema e (facoltativamente) una Description.

      Finestra Crea schema che mostra i campi Denomina lo schema

    2. Seleziona Finish.

  5. Nella scheda Struttura dello schema di esempio:

    1. Seleziona + Add (Aggiungi) in Field groups (Gruppi di campi).

      Aggiungere un gruppo di campi

      I gruppi di campi sono raccolte riutilizzabili di oggetti e attributi che consentono di estendere facilmente lo schema.

    2. Nella finestra di dialogo Add fields groups (Aggiungi gruppi di campi) seleziona il gruppo di campi AEP Web SDK ExperienceEvent dall’elenco.

      AEP Web SDK ExperienceEvent fieldgroup

      Puoi selezionare il pulsante di anteprima per visualizzare un’anteprima dei campi che fanno parte del gruppo di campi, ad esempio web > webPageDetails > name.

      Anteprima AEP Web SDK ExperienceEvent fieldgroup

      Seleziona Back (Indietro) per chiudere l’anteprima.

    3. Seleziona Add field groups (Aggiungi gruppi di campi).

  6. Seleziona + accanto al nome dello schema nel pannello Structure (Struttura).

    Pulsante per l’aggiunta di campi nello schema di esempio

  7. Nel pannello Field Properties (Proprietà campo), inserisci Identification come nome, Identification (Identificazione) come Display name (Nome di visualizzazione), seleziona Object (Oggetto) come Type (Tipo) e seleziona ExperienceEvent Core v2.1 come Field Group (Gruppo di campo).

    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, crmId e altri di cui hai bisogno) al gruppo di campi e seleziona il nuovo gruppo di campi.

    Oggetto di identificazione

    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 Apply (Applica) per aggiungere questo oggetto allo schema.

  8. Seleziona il campo ecid nell’oggetto di identificazione appena aggiunto e seleziona Identity (Identità) e Primary Identity (Identità principale) e ECID dall’elenco Identity namespace (Spazio dei nomi dell’identità) nel pannello di destra.

    Specificare ECID come identità

    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 Apply (Applica). Nell’attributo ecid viene visualizzata l’icona di un’impronta digitale.

  9. Seleziona il campo email nell’oggetto di identificazione appena aggiunto e seleziona Identity (identità) e Email dall’elenco Identity namespace (Spazio dei nomi dell’identità) nel pannello Field Properties (Proprietà campo).

    Specificare l’e-mail come identità

    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 Apply (Applica). Nell’attributo e-mail viene visualizzata l’icona di un’impronta digitale.

    Seleziona Save (Salva).

  10. Seleziona l’elemento principale dello schema che visualizza il nome dello schema, quindi seleziona il pulsante Profile (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.

    IMPORTANT
    Una volta salvato uno schema abilitato per il profilo, non è più possibile disattivarlo per il profilo.

    Abilitare lo schema per il profilo

  11. Seleziona Save (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. Attivando 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:

  1. Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Datasets (Set di dati) all’interno di DATA MANAGEMENT (GESTIONE DATI).

  2. Seleziona Create dataset (Crea set di dati).

    Creare un set di dati

  3. Seleziona Create dataset from schema (Crea set di dati da schema).

    Creare un set di dati da uno schema

  4. Seleziona lo schema creato in precedenza e seleziona Next (Avanti).

  5. Assegna un nome al set di dati e (facoltativamente) fornisci una descrizione.

    Assegnare un nome al set di dati

  6. Seleziona Finish (Fine).

  7. Seleziona il pulsante Profile (Profilo).

    Viene richiesto di abilitare il set di dati per il profilo. Una volta attivato, il set di dati arricchisce i profili dei clienti in tempo reale con i relativi dati inseriti.

    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.

    Abilitare lo schema 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:

  1. Nell’interfaccia utente di Adobe Experience Platform, seleziona Datastreams (Flussi di dati) da DATA COLLECTION (RACCOLTE DATI) nella barra a sinistra.

  2. Seleziona New Datastream (Nuovo flusso di dati).

  3. Assegna un nome e una descrizione al tuo flusso di dati. Seleziona lo schema dall’elenco Event Schema (Schema eventi).

    Nuovo flusso di dati

  4. Seleziona Save (Salva).

  5. Seleziona Add Service (Aggiungi servizio).

  6. Nella schermata Add Service screen (Aggiungi servizio):

    1. Seleziona Adobe Experience Platform dall’elenco Service (Servizio).

    2. Assicurati di aver selezionato Enabled (Abilitato).

    3. Seleziona il set di dati dall’elenco Event Dataset (Set di dati evento).

      Servizio AEP del flusso di dati

    4. Abbandona le altre impostazioni e seleziona Save per salvare il flusso 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

  1. Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Tags (Tag) all’interno di DATA COLLECTION (GESTIONE DATI).

  2. Seleziona New Property (Nuova proprietà).

    Assegna un nome al tag, seleziona Web e immetti un nome di dominio. Seleziona Save (Salva) per continuare.

    Creare una proprietà

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 Tag Properties (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:

  1. Seleziona Extensions (Estensioni) nella barra a sinistra.

  2. Seleziona Catalog (Catalogo) nella barra superiore.

  3. Cerca o scorri fino all’estensione Adobe Experience Platform Web SDK e seleziona Install (Installa) per installarlo.

  4. Seleziona la sandbox e il flusso di dati creato in precedenza per il tuo Production Environment (Ambiente di produzione) e (facoltativamente) Staging Environment (Ambiente di gestione temporanea) e Development Environment (Ambiente di sviluppo).

    Configurazione dell’estensione AEP Web SDK

    Seleziona Save (Salva).

Per ulteriori informazioni, consulta la sezione Configurare l’estensione Adobe Experience Platform Web SDK.

Web SDK include Adobe Experience Cloud ID Service in modo nativo e, pertanto, non è necessario aggiungere al tag l’estensione del servizio ID.

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:

  1. Seleziona Data Elements (Elementi dati) nella barra a sinistra.

  2. Seleziona Add Data Element (Aggiungi elemento dati).

  3. Nella finestra di dialogo Create Data Element (Crea elemento dati):

    • Assegna un nome all’elemento dati, ad esempio Page Name (Nome pagina).

    • Seleziona Core dall’elenco Extension (Estensioni).

    • Seleziona Page Info (Info pagina) dall’elenco Data Element Type (Tipo di elemento dati).

    • Seleziona Title (Titolo) dall’elenco Attribute (Attributo).

      Creare un elemento dati utilizzando le informazioni della pagina

      In alternativa, puoi usare il valore da una variabile del livello dati, ad esempio pageName e il tipo di elemento dati JavaScript Variable (Variabile JavaScript) per definire l’elemento dati.

      Creare un elemento dati utilizzando una variabile Javascript

    • Seleziona Save (Salva).

Ora immagina di voler impostare un elemento dati che faccia riferimento all’ID Experience Cloud fornito automaticamente dall’SDK per Web Adobe Experience Platform e disponibile tramite l’estensione Experience Cloud ID Service.

Per definire un elemento dati ECID:

  1. Seleziona Data Elements (Elementi dati) nella barra a sinistra.

  2. Seleziona Add Data Element (Aggiungi elemento dati).

  3. Nella finestra di dialogo Create Data Element (Crea elemento dati):

    • Assegna un nome all’elemento dati, ad esempio ECID (Nome pagina).

    • Seleziona Experience Cloud ID Service dall’elenco Extension (Estensioni).

    • Seleziona ECID dall’elenco Data Element Type (Tipo di elemento dati).

      Elemento dati ECID

    • Seleziona Save (Salva).

Infine, ora immagina di voler 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:

  1. Seleziona Data Elements (Elementi dati) nella barra a sinistra.

  2. Seleziona Add Data Element (Aggiungi elemento dati).

  3. Nella finestra di dialogo Create Data Element (Crea elemento dati):

    • Assegna un nome all’elemento dati, ad esempio XDM - Page View (Nome pagina).

    • Seleziona Adobe Experience Platform Web SDK dall’elenco Extension (Estensioni).

    • Seleziona XDM Object (Oggetto XDM) dall’elenco Data Element Type (Tipo di elemento dati).

    • Seleziona la sandbox dall’elenco Sandbox.

    • Seleziona lo schema dall’elenco Schema.

    • Mappa l’attributo identification > core > ecid all’elemento dati ECID, definito nello schema. Seleziona l’icona del cilindro per scegliere facilmente l’elemento dati ECID dall’elenco degli elementi dati.

      Scegli l’elemento dati ECID

      Mappa l’elemento dati ECID

    • Mappa l’attributo web > webPageDetails > name all’elemento dati Page Name (Nome pagina), definito nello schema.

      Mappa l’elementi dati Page Name (Nome pagina)

    • Seleziona Save (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:

  1. Seleziona Rules (Regole) nella barra a sinistra.

  2. Seleziona Create New Rule (Aggiungi elemento dati).

  3. Nella finestra di dialogo Create Rule (Crea regola):

    • Assegna un nome alla regola, ad esempio Page View.

    • Seleziona + Add (Aggiungi) sotto Events (Eventi).

    • Nella finestra di dialogo Event Configuration (Configurazione evento):

      • Seleziona Core dall’elenco Extension (Estensioni)

      • Seleziona Window Loaded (Finestra caricata) dall’elenco Event Type (Estensioni)

        Regola - Configurazione evento

      • Seleziona Keep Changes (Mantieni modifiche).

    • Seleziona + Add (Aggiungi) sotto Actions (Azioni).

    • Nella finestra di dialogo Action Configuration (Configurazione evento):

      • Seleziona Adobe Experience Platform Web SDK dall’elenco Extension (Estensioni)

      • Seleziona Send Event (Info pagina) dall’elenco Action Type (Tipo di elemento dati).

      • Seleziona web.webpagedetails.pageViews dall’elenco Type (Tipo)

      • Seleziona l’icona del cilindro accanto a XDM data (Dati XDM) e seleziona XDM - Page View (XDM - Vista pagina) dall’elenco degli elementi dati.

      Regola - Configurazione azione

      • Seleziona Keep Changes (Mantieni modifiche).

    • L’aspetto della regola dovrebbe essere il seguente:

      Crea regola

    • Seleziona Save (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:

  1. Seleziona Publishing Flow (Flusso di pubblicazione) nella barra a sinistra.

  2. Seleziona Select a working library (Seleziona una libreria di lavoro) e poi Add Library… (Aggiungi libreria…).

  3. Nella finestra di dialogo Create Library (Crea libreria):

    • Assegna un nome alla libreria.

    • Seleziona Development (development) dall’elenco.Environment

    • Seleziona + Add All Changed Resources (Crea set di dati).

      Pubblica - Crea libreria

    • Seleziona Save & Build to Development (Salva e crea per lo 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.

  4. È possibile selezionare … per ricreare la libreria o spostarla in un ambiente di gestione temporanea o produzione.

    Pubblica - Libreria di compilazione

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.