DocumentazioneCustomer Journey AnalyticsGuida di Customer Journey Analytics

Aggiungere la logica di raccolta dati XDM al tag upgrade-tag-xdm

Last update: Wed Oct 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
NOTE
Segui i passaggi descritti in questa pagina solo dopo aver completato tutti i passaggi di aggiornamento precedenti. Puoi seguire i passaggi di aggiornamento consigliati (per la maggior parte delle organizzazioni), oppure puoi seguire i passaggi generati in modo dinamico per la tua organizzazione con la Guida all’aggiornamento di Customer Journey Analytics.

  • Passaggi di aggiornamento consigliati (per la maggior parte delle organizzazioni)

    Serie di passaggi per un’implementazione ideale di Customer Journey Analytics.

    Per informazioni dettagliate, consulta Aggiornamento da Adobe Analytics a Customer Journey Analytics.

  • Guida all’aggiornamento di Customer Journey Analytics (passaggi personalizzati per le esigenze specifiche della tua organizzazione)

    È disponibile una nuova guida per l’aggiornamento che genera in modo dinamico passaggi di aggiornamento personalizzati per la situazione specifica della tua organizzazione.

    Per accedere alla guida da Customer Journey Analytics, seleziona la scheda Workspace, quindi seleziona Aggiorna a Customer Journey Analytics nel pannello a sinistra. Segui le istruzioni visualizzate sullo schermo.

Dopo aver creato il tag e aggiunto l’estensione Web SDK, devi effettuare la configurazione con elementi dati e regole in base a come desideri tenere traccia del sito e inviare dati ad Adobe Experience Platform. Dopo aver configurato gli elementi dati e le regole per il tag, puoi generarlo e pubblicarlo.

Configurare gli 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. Per ulteriori informazioni sugli elementi dati, consulta Elementi dati nella documentazione dei tag.

Le sezioni seguenti descrivono gli elementi dati consigliati e altri elementi dati comuni che puoi configurare.

Esistono diversi tipi di elementi dati. Due elementi dati comuni che potresti voler configurare sono: uno che acquisisce il nome della pagina che le persone stanno visualizzando sul tuo sito e un altro che acquisisce l’ID Experience Cloud di ogni persona che visita il tuo sito.

Dopo aver configurato questi due elementi dati, puoi configurare elementi dati aggiuntivi per i dati specifici che desideri acquisire.

Infine, dopo aver definito tutti gli elementi dati desiderati, devi assegnare gli elementi dati allo schema creato in precedenza. A questo scopo, definisci un elemento dati XDM che fornisce una rappresentazione dello schema XDM.

Creare gli elementi dati suggeriti

Le sezioni seguenti descrivono come creare elementi dati comuni applicabili alla maggior parte delle organizzazioni.

Elemento dati Nome pagina

Un elemento dati comune che si applica alla maggior parte delle organizzazioni è un elemento dati che acquisisce il nome della pagina visualizzata dalle persone.

Per creare un elemento dati Nome pagina:

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, passa a Data Collection > Tags.

  3. Nella pagina Tag Properties, seleziona il tag appena creato dall’elenco delle proprietà per aprirlo.

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

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

  6. Nella finestra di dialogo Create Data Element, fornisci le seguenti informazioni:

    • Name: il nome del tuo elemento dati. Ad esempio Page Name.

    • Extension: seleziona Core dall’elenco.

    • Data Element Type: seleziona Page Info dall’elenco.

    • Attribute: seleziona Title dall’elenco.

      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

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

  8. Continua con elemento dati ECID.

Elemento dati ECID

Un elemento dati comune che si applica alla maggior parte delle organizzazioni è un elemento dati che acquisisce l’Experience Cloud ID di ogni persona che visita il sito.

Per creare un elemento dati ECID:

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, passa a Data Collection > Tags.

  3. Seleziona il tag appena creato dall’elenco Tag Properties (Proprietà tag) per aprirlo.

  4. (Condizionale) Installa l’estensione del servizio Experience Cloud ID se non è già installata:

    1. Seleziona Extensions (Elementi dati) nella barra a sinistra.

    2. La scheda Installed è selezionata per impostazione predefinita. Se il riquadro Experience Cloud ID Service è elencato, procedi al passaggio 5.

    3. Se il riquadro Experience Cloud ID Service non è elencato, seleziona la scheda Catalog.

    4. Nel campo di ricerca, cerca Experience Cloud ID Service, quindi seleziona il riquadro visualizzato.

    5. Seleziona Install > Save.

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

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

  7. Nella finestra di dialogo Create Data Element, fornisci le seguenti informazioni:

    • Name: il nome del tuo elemento dati. Ad esempio ECID.

    • Extension: seleziona Experience Cloud ID Service dall’elenco.

    • Data Element Type: seleziona ECID dall’elenco.

      Elemento dati ECID

  8. Seleziona Save (Salva).

  9. Continua con Creare elementi dati aggiuntivi.

Creare elementi dati aggiuntivi

Crea un elemento dati per ogni tipo di dati che desideri raccogliere. Utilizza lo stesso processo descritto in Elemento dati Nome pagina e Elemento dati ECID per creare ogni elemento dati aggiuntivo.

Per ogni elemento dati creato deve essere presente un campo correlato nello schema.

Gli elementi dati comuni variano a seconda dei requisiti aziendali e di settore. Considera i seguenti elementi dati comuni, organizzati per settore:

Elementi dati per la vendita al dettaglio

  • Prodotti

  • Aggiunte al carrello

  • Pagamenti

Elementi dati finanziari

  • ID transazione

  • Data transazione

  • Tipo di servizio

Elementi dati per l’assistenza sanitaria

  • ID provider

  • Data della visita

  • Tipo di trattamento

Dopo aver creato tutti gli elementi dati necessari per l’implementazione della tua organizzazione, continua con Elemento dati oggetto XDM.

Elemento dati oggetto XDM

Infine, immagina ora di voler mappare uno degli elementi dati creati allo schema creato in precedenza. A questo scopo, definisci un elemento dati oggetto XDM che fornisca una rappresentazione dello schema XDM.

Per definire un elemento dati oggetto XDM:

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, passa a Data Collection > Tags.

  3. Seleziona il tag appena creato dall’elenco Tag Properties (Proprietà tag) per aprirlo.

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

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

  6. Nella finestra di dialogo Create Data Element, fornisci le seguenti informazioni:

    • Name: il nome del tuo elemento dati. Ad esempio XDM - Page View.

    • Extension: seleziona Adobe Experience Platform Web SDK dall’elenco.

    • Data Element Type: seleziona XDM Object dall’elenco.

    • Sandbox: seleziona la sandbox dall’elenco.

    • Schema: seleziona lo schema dall’elenco.

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

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

    Mappa l’elementi dati Page Name (Nome pagina)

  9. Seleziona Save (Salva).

  10. Continua con Configura regole.

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

NOTE
I passaggi seguenti sono un esempio di definizione di una regola che invia dati XDM, contenenti valori da altri elementi di dati, a Adobe Experience Platform.
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.

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, passa a Data Collection > Tags.

  3. Seleziona il tag appena creato dall’elenco Tag Properties (Proprietà tag) per aprirlo.

  4. Seleziona Rules (Elementi dati) nella barra a sinistra.

  5. Seleziona Add Rule (Aggiungi elemento dati).

  6. Nella finestra di dialogo Create Rule, specifica le seguenti informazioni:

    • Name: il nome della regola. Ad esempio Page View.

    • Events: seleziona + Add. Quindi, nella finestra di dialogo Event Configuration, specifica le seguenti informazioni. Al termine, seleziona Keep Changes.

      • Extension: seleziona Core dall’elenco.

      • Event Type: seleziona Window Loaded dall’elenco.

        Regola - Configurazione evento

    • Actions: seleziona + Add. Quindi, nella finestra di dialogo Action Configuration, specifica le seguenti informazioni. Al termine, seleziona Keep Changes.

      • Extension: seleziona Adobe Experience Platform Web SDK dall’elenco.

      • Action Type: seleziona Send event dall’elenco.

      • Type: seleziona Web Webpagedetails Page Views dall’elenco.

      • XDM data: seleziona l’icona cilindro quindi seleziona XDM - Page View dall’elenco degli elementi di dati.

        Regola - Configurazione azione

        L’aspetto della regola dovrebbe essere il seguente:

        Crea regola

  7. Seleziona Save (Salva).

  8. Ripeti questo processo per ogni regola da aggiungere al sito.

    Per ulteriori informazioni sulle regole, consulta Regole nella documentazione dei tag.

  9. Continua con Creare e pubblicare il tag.

Creare e pubblicare il tag

Dopo aver definito gli elementi dati e le regole, devi creare 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.

I tag Adobe Experience Platform supportano flussi di lavoro di pubblicazione semplici o complessi che devono adattarsi alla distribuzione di Adobe Experience Platform Web SDK. Per ulteriori informazioni, consulta la sezione Panoramica di pubblicazione.

Per generare e pubblicare il tag:

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, passa a Data Collection > Tags.

  3. Seleziona il tag appena creato dall’elenco Tag Properties (Proprietà tag) per aprirlo.

  4. Seleziona Publishing Flow nella barra a sinistra.

  5. Seleziona Add Library.

  6. Nella finestra di dialogo Create Library, specifica le seguenti informazioni:

    • Name: il nome della libreria.

    • Environment: seleziona Development (development) dall’elenco.

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

    Pubblica - Crea libreria

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

  9. È possibile selezionare … per ricreare la libreria o spostarla in un ambiente di staging o di produzione.

    Pubblica - Libreria di compilazione

  10. Continua a seguire i passaggi consigliati per l’aggiornamento o i passaggi generati dinamicamente, descritti nella Guida all’aggiornamento di Customer Journey Analytics. Per accedere alla guida da Customer Journey Analytics, seleziona la scheda Workspace, quindi seleziona Aggiorna a Customer Journey Analytics nel pannello a sinistra. Segui le istruzioni visualizzate sullo schermo.

recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79