Aggiungere un elemento dati, una regola e una libreria
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.
- 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
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.
-
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.
-
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:
code language-javascript 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:
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.
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!
Se osservi Strumenti per sviluppatori > Console, è necessario visualizzare il testo "Il nome della pagina è home"
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.
Nella pagina Edit Rule, fai clic sul menu a discesa Working Library e seleziona la tua libreria Initial Setup.
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.
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):
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" >