Estensione Google Data Layer
L’estensione Google Data Layer consente di utilizzare un livello dati Google nell’implementazione dei tag. L'estensione può essere utilizzata in modo indipendente o simultaneo con le soluzioni Google e con la Libreria helper del livello dati open source di Google.
La libreria helper fornisce funzionalità basate su eventi simili a quelle di Adobe Client Data Layer (ACDL). Gli elementi dati, le regole e le azioni dell'estensione Google Data Layer forniscono funzionalità simili a quelle dell'estensione ACDL.
Installazione
Per installare l'estensione, passa al catalogo delle estensioni nell'interfaccia utente di Data Collection e seleziona Google Data Layer.
Una volta installata, l’estensione crea o accede a un livello dati a ogni caricamento della libreria Tag di Adobe Experience Platform.
Vista dell’estensione
La configurazione dell’estensione può essere utilizzata per definire il nome del livello dati utilizzato dall’estensione. Se al momento del caricamento dei tag Adobe Experience Platform non è presente alcun livello di dati con il nome configurato, l’estensione ne crea uno.
Il nome predefinito del livello dati è il nome predefinito di Google dataLayer
.
Eventi
- Eventi tag Adobe Experience Platform (libreria caricata e così via).
- Eventi JavaScript.
- Dati inviati al livello dati con la parola chiave event.
L’estensione consente di ascoltare le modifiche sul livello dati.
Leggi la documentazione di Google o fai ricerche se non sei sicuro su questo punto.
Tipi di evento Google
Google supporta due metodi di push degli eventi: Google Tag Manager, con il metodo push()
, e Google Analytics 4, con il metodo gtag()
.
Le versioni di Google Data Layer precedenti alla 1.2.1 supportavano solo gli eventi creati da push()
, come mostrato negli esempi di codice in questa pagina.
Le versioni 1.2.1 e successive supportano gli eventi creati con gtag()
. Questo è facoltativo e può essere abilitato nella finestra di dialogo di configurazione dell’estensione.
Per ulteriori informazioni sugli eventi push()
e gtag()
, vedere la documentazione di Google. Le informazioni sono fornite anche nelle finestre di dialogo di configurazione e regola dell’estensione.
Ascolta tutti i push al livello dati
Se selezioni questa opzione, il listener di eventi ascolta qualsiasi modifica apportata al livello dati.
Ascolto di push con esclusione di eventi
Se selezioni questa opzione, il listener di eventi ascolta qualsiasi invio di dati al livello dati, esclusi gli eventi.
Il listener tiene traccia degli eventi push di esempio seguenti:
dataLayer.push({"data":"something"})
Il listener non tiene traccia degli eventi push di esempio seguenti:
dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})
Ascolta tutti gli eventi
Se selezioni questa opzione, il listener di eventi ascolta qualsiasi evento inviato al livello dati.
Il listener tiene traccia degli eventi push di esempio seguenti:
dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})
Il listener non tiene traccia dell’evento push di esempio seguente:
dataLayer.push({"data":"something"})
Ascolta un evento specifico
Se specifichi un evento, il listener di eventi tiene traccia di tutti gli eventi che corrispondono a una stringa specifica.
Ad esempio, l’impostazione myEvent
quando si utilizza questa configurazione determina il tracciamento del solo evento push seguente da parte del listener:
dataLayer.push({"event":"myEvent"})
È possibile utilizzare un regex (ECMAScript / JavaScript) per far corrispondere i nomi di evento.
Ad esempio, impostando 'myEvent\d' si tiene traccia di myEvent
con una cifra (\d):
dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})
Azioni
Invia a livello dati push-to-data-layer
L’estensione fornisce due azioni per inviare JSON al livello dati: un campo di testo libero per creare manualmente il JSON da inviare e, dalla versione 1.2.0, una finestra di dialogo con più campi chiave-valore.
JSON per testo libero
L’azione testo libero consente di utilizzare gli elementi dati direttamente nel JSON. All’interno dell’editor JSON, è necessario fare riferimento agli elementi dati utilizzando la notazione percentuale. Ad esempio, %dataElementName%
.
{
"page": {
"url": "%url%",
"previous_url": "%previous_url%",
"concatenated_values": "static string %dataElement%"
}
}
Multifield chiave-valore
La nuova finestra di dialogo a più campi chiave-valore è un’interfaccia più intuitiva che consente di configurare un push senza scrivere manualmente JSON.
Ripristino di Google DL allo stato calcolato
L’estensione fornisce un’azione per ripristinare il livello dati. Se utilizzato in una regola che elabora una modifica del livello dati di Google, il livello dati viene reimpostato sullo stato calcolato del livello dati nel momento in cui la regola è stata attivata. Se l’azione viene utilizzata in una regola che non elabora una modifica del livello dati di Google, l’azione svuota il livello dati.
Elementi dati
L’elemento dati fornito può essere utilizzato durante l’esecuzione di una regola attivata da una modifica del livello dati di Google (evento push) o in una regola non correlata, ad esempio Library Loaded. Nel primo caso, l’elemento dati restituisce un valore tratto dallo stato calcolato al momento della modifica del livello dati. In quest’ultimo caso, viene utilizzato lo stato calcolato al momento dell’esecuzione della regola.
Un interruttore consente di selezionare se l’elemento dati deve restituire valori dall’intero stato calcolato o solo dalle informazioni sull’evento (se utilizzato in una regola attivata da una modifica del livello dati).
L’elemento dati può quindi restituire:
- Campo vuoto: stato calcolato del livello dati.
- Campo con chiave (come page.previous_url nell’esempio precedente): valore della chiave nell’oggetto evento o nello stato calcolato.
Informazioni aggiuntive
L’elemento dati e le finestre di dialogo degli eventi dell’estensione contengono informazioni di utilizzo ed esempi dettagliati.
Ulteriori informazioni generali sono disponibili nel file README del progetto