DocumentazioneCustomer Journey AnalyticsGuida di Customer Journey Analytics

Aggiungere la logica di raccolta dati XDM al tag

Last update: Mon Nov 11 2024 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, oppure puoi seguire i passaggi di aggiornamento generati in modo dinamico per la tua organizzazione con il questionario di aggiornamento da Adobe Analytics a Customer Journey Analytics.
Dopo aver completato i passaggi descritti in questa pagina, continua seguendo i passaggi di aggiornamento consigliati o generati in modo dinamico.

Dopo la creazione del tag e l'aggiunta dell'estensione Web SDK, è necessario configurarlo con elementi dati e regole, in base alla modalità di tracciamento del sito e di invio dei dati a 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.

Esistono diversi tipi di elementi dati. Innanzitutto, imposta un elemento dati per acquisire il nome della pagina che le persone visualizzano sul tuo sito. Quindi, imposta un elemento dati che fa riferimento all’ID Experience Cloud. Infine, definisci un elemento dati dell’oggetto XDM.

Elemento dati Nome pagina

Per definire un elemento dati nome pagina:

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

  2. In Adobe Experience Platform, vai 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, specifica le seguenti informazioni:

    • Name: nome dell'elemento dati. Ad esempio Page Name.

    • Extension: selezionare Core dall'elenco.

    • Data Element Type: selezionare Page Info dall'elenco.

    • Attribute: selezionare 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

Per definire un elemento dati ECID:

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

  2. In Adobe Experience Platform, vai 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, specifica le seguenti informazioni:

    • Name: nome dell'elemento dati. Ad esempio ECID.

    • Extension: selezionare Experience Cloud ID Service dall'elenco.

    • Data Element Type: selezionare ECID dall'elenco.

      Elemento dati ECID

  7. Seleziona Save (Salva).

  8. Continua con elemento dati oggetto XDM.

Elemento dati oggetto XDM

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. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.

  2. In Adobe Experience Platform, vai 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, specifica le seguenti informazioni:

    • Name: nome dell'elemento dati. Ad esempio XDM - Page View.

    • Extension: selezionare Adobe Experience Platform Web SDK dall'elenco.

    • Data Element Type: selezionare XDM Object dall'elenco.

    • Sandbox: seleziona la sandbox dall'elenco.

    • Schema: selezionare 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 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.

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

  2. In Adobe Experience Platform, vai 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 Create New Rule (Aggiungi elemento dati).

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

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

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

      • Extension: selezionare Core dall'elenco.

      • Event Type: selezionare Window Loaded dall'elenco.

        Regola - Configurazione evento

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

      • Extension: selezionare Adobe Experience Platform Web SDK dall'elenco.

      • Action Type: selezionare Send Event dall'elenco.

      • Type: selezionare web.webpagedetails.pageViews dall'elenco.

      • XDM data: selezionare l'icona del cilindro, quindi selezionare XDM - Page View dall'elenco degli elementi dati.

        Regola - Configurazione azione

        L’aspetto della regola dovrebbe essere il seguente:

        Crea regola

  7. Seleziona Save (Salva).

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 di incorporamento 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 dovrebbero adattarsi alla distribuzione dell’SDK web per Adobe Experience Platform. 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, vai a Data Collection > Tags.

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

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

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

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

    • Name: nome della libreria.

    • Environment: selezionare 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 generato per l’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 gestione temporanea o produzione.

    Pubblica - Libreria di compilazione

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