Documentazione Experience Platform Tutorial web

Aggiungere un elemento dati, una regola e una libreria

Ultimo aggiornamento: 5 maggio 2025

Argomenti:

Creato per:

Principiante
Intermedio
Sviluppatore

In questa lezione, creerai i tuoi primi elemento dati, regola e libreria.

Gli elementi e le regole di dati sono gli elementi costitutivi di base dei tag. Gli elementi dati memorizzano gli attributi che desideri inviare alle tue soluzioni di marketing e pubblicitarie, mentre le richieste a tali soluzioni vengono inviate dalle Regole in giuste condizioni. Le librerie sono file JavaScript caricati nella pagina per eseguire tutto il lavoro. In questa lezione, utilizzerai tutti e tre per fare in modo che la nostra pagina di esempio esegua un’operazione.

NOTA

Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto quando si utilizza questo contenuto:

Il platform launch (lato client) è ora tags
Platform Launch Server Side è ora event forwarding
Le configurazioni di Edge sono ora datastreams

Finalità di apprendimento

Alla fine di questa lezione, potrai:

Creare un elemento dati
Creare una regola
Creare una libreria
Aggiungere modifiche a una libreria
Convalidare il caricamento della libreria nel browser Web
Utilizzare la funzione “Working Library” per lavorare in modo più efficiente

Creare elementi dati per Nome pagina

Gli elementi dati sono versioni di tag di un livello dati. Essi possono memorizzare i valori del tuo oggetto livello dati, dei cookie, degli oggetti di memorizzazione locali, dei parametri delle stringhe query, degli elementi pagina, dei metatag, ecc. In questo esercizio, creerai un elemento dati per Nome pagina, che utilizzerai successivamente nelle implementazioni di Target e Analytics.

Per creare un elemento dati

Nel menu di navigazione a sinistra, fai clic su Elementi dati
Poiché in questa proprietà non hai ancora creato elementi dati, viene visualizzato un breve video con informazioni aggiuntive su questo argomento. Se lo desideri, guarda questo video.
Fai clic sul pulsante Crea nuovo elemento dati:
Denomina l’elemento dati, ad es. Page Name
Utilizza il tipo di elemento dati Variabile JavaScript per puntare a un valore nel livello dati della pagina di esempio: digitalData.page.pageInfo.pageName
Seleziona le caselle per Forza valori minuscoli e Pulisci testo per standardizzare il caso e rimuovere spazi estranei
Lascia None come impostazione Storage Duration poiché questo valore è in genere diverso in ogni pagina
Fai clic sul pulsante Salva per salvare l'elemento dati

.

NOTA

Le funzionalità degli elementi dati possono essere estese con le estensioni. Ad esempio, l’estensione ContextHub consente di aggiungere elementi dati utilizzando le funzioni dell’estensione.

Creare una regola

Successivamente, utilizzerai questo elemento dati in una regola semplice. Le regole sono una delle funzioni più potenti nei tag e consentono di specificare cosa deve accadere quando il visitatore interagisce con il sito web. Quando i criteri descritti nelle regole vengono soddisfatti, la regola attiva l’azione specificata.

Genererai una regola che restituisce il valore dell’elemento Nome pagina alla console del browser.

Per creare una regola

Nel menu di navigazione a sinistra, fai clic su Regole
Poiché non hai ancora creato regole in questa proprietà, viene visualizzato un breve video con ulteriori informazioni sull’argomento. Se lo desideri, guarda questo video.
Fai clic sul pulsante Crea nuova regola:
Denomina la regola All Pages - Library Loaded. Questa convenzione per i nomi indica dove e quando verrà attivata la regola, facilitando l’identificazione e il riutilizzo con la maturazione della proprietà tag.
In Eventi, fare clic su Aggiungi. L’evento indica ai tag quando la regola dovrebbe attivarsi e può essere molte cose, inclusi il caricamento di una pagina, un clic, un evento JavaScript personalizzato, ecc.
1. In Tipo evento, seleziona Libreria caricata (Pagina in alto). Tieni presente che quando selezioni Tipo evento, i tag precompilano un nome per l’evento utilizzando la selezione. Inoltre, l’ordine predefinito per l’evento è 50. L’ordinamento è una funzione potente nei tag che offre un controllo preciso sulla sequenza di azioni quando più regole vengono attivate dallo stesso evento. Questa funzione verrà utilizzata più avanti nell’esercitazione.
2. Fai clic sul pulsante Mantieni modifiche
Poiché questa regola deve essere attivata su tutte le pagine, lascia vuoto Condizioni. Se apri la modale Condizioni, vedrai che le condizioni possono aggiungere restrizioni ed esclusioni in base a un’ampia gamma di opzioni, inclusi URL, valori degli elementi dati, intervalli di date e molto altro.
In Azioni, fai clic su Aggiungi
Seleziona Tipo azione > Codice personalizzato, che a questo punto è l'unica opzione. Più avanti nell’esercitazione, quando si aggiungono estensioni saranno disponibili più opzioni.
Seleziona </> Apri editor per aprire l'editor di codice
Aggiungi quanto segue all’editor di codice. Questo codice invia il valore dell’elemento dati Nome pagina alla console del browser, in modo da permetterti di confermare il funzionamento:
console.log('The page name is '+_satellite.getVar('Page Name'));
Salva l’editor di codice.
Nella schermata di configurazione dell'azione fai clic su Mantieni modifiche
Fai clic su Salva per salvare la regola

Nella pagina Regole dovresti visualizzare la nuova regola:
La regola viene visualizzata a pagina

Salvare le modifiche in una libreria

Dopo aver configurato una raccolta di estensioni, elementi dati e regole nell’interfaccia di Data Collection, devi creare un pacchetto di tali funzionalità e logica in un set di codice JavaScript da distribuire sul sito web, in modo che i tag di marketing vengano attivati quando i visitatori arrivano sul sito. Una libreria è il set di codice JavaScript che esegue questa operazione.

In una lezione precedente, hai implementato il codice di incorporamento dell’ambiente di sviluppo nella pagina di esempio. Quando si caricava la pagina di esempio, veniva restituito un errore 404 per l’URL del codice di incorporamento, poiché una libreria di tag non era stata ancora generata e assegnata all’ambiente. Ora, inserirai il nuovo elemento dati e la regola in una libreria in modo che la pagina di esempio possa fare qualcosa.

Aggiungere e creare una libreria

Nel menu di navigazione a sinistra, fai clic su Flusso di pubblicazione
Fai clic su Aggiungi nuova libreria
Denomina la libreria, ad esempio Initial Setup
Seleziona Ambiente > Sviluppo
Fai clic su Aggiungi tutte le risorse modificate
Dopo aver fatto clic su Aggiungi tutte le risorse modificate, i tag riepilogano le modifiche appena apportate.
Fai clic su Salva e genera per sviluppo

Dopo alcuni istanti, il punto dello stato diventa verde per indicare che la libreria è stata creata correttamente.

Libreria generata

Convalidare il lavoro

Ora verifica che la regola funzioni come previsto.

Ricarica la pagina di esempio. Se osservi la scheda Strumenti per sviluppatori > Rete, ora dovresti vedere una risposta di 200 per la tua libreria di tag!

Caricamenti della libreria con risposta 200

Se osservi Strumenti per sviluppatori > Console, è necessario visualizzare il testo "Il nome della pagina è home"

Messaggio della console

Congratulazioni, hai creato il tuo primo elemento dati e la prima regola e generato la tua prima libreria di tag.

Usare la funzione Working Library

Quando effettui molte modifiche nei tag, è scomodo aprire la scheda Pubblicazione, aggiungere modifiche e generare la libreria ogni volta che desideri visualizzare il risultato. Ora che hai creato la libreria “Initial Setup”, puoi utilizzare la funzione Working Library per salvare rapidamente le modifiche e ricrearle in un singolo passaggio.

Effettua una piccola modifica alla regola “All Pages - Library Loaded”. Nel menu di navigazione a sinistra, fai clic su Regole, quindi fai clic sulla regola All Pages - Library Loaded per aprirla.

Riaprire la regola

Nella pagina Edit Rule, fai clic sul menu a discesa Working Library e seleziona la tua libreria Initial Setup.

Seleziona Initial Setup come libreria di lavoro

Dopo aver selezionato la libreria, il pulsante Salva è ora Salva nella libreria. Quando effettui una modifica nei tag, puoi utilizzare questa opzione per aggiungere automaticamente la modifica direttamente nella libreria di lavoro e/o ricrearla.

Esegui il test. Apri l’azione Codice personalizzato e aggiungi un due punti dopo il testo "Il nome della pagina è", in modo che l’intero blocco di codice reciti:

console.log('The page name is: '+_satellite.getVar('Page Name'));

Salva il codice, mantieni le modifiche nell'azione, quindi fai clic sul pulsante Salva nella libreria e genera.

L’opzione Salva e genera esiste già

Attendi che il punto verde venga nuovamente visualizzato accanto al menu a discesa Working Library. A questo punto, ricarica la pagina di esempio e dovresti visualizzare le modifiche riportate nel messaggio della console (per visualizzare la modifica alla pagina potrebbe essere necessario cancellare la cache del browser e ricaricare):

Messaggio della console con due punti

Si tratta di un metodo di lavoro molto più veloce: userai questo approccio per il resto dell’esercitazione.

Avanti "Cambiare ambienti con il Experience Cloud Debugger" >

recommendation-more-help