Eventi e attributi del data layer inviati ai tag manager
Pubblicato il 9 ottobre 2023· Team Andronautic
Introduzione e dettagli tecnici del sistema di gestione dei tag integrato in Andronautic.
Tag manager integrato
Per migliorare e standardizzare la raccolta dei dati di navigazione e conversione dei siti web pubblici dei nostri clienti, e per garantire che ciò avvenga nel rispetto della normativa europea sulla protezione dei dati, questi siti integrano uno strumento chiamato Matomo, che registra, archivia e riporta i dati raccolti e generati.
Questo strumento è installato sulla nostra infrastruttura di server, quindi sia i nostri clienti che i loro visitatori possono navigare sui siti web pubblici con la tranquillità di sapere che i loro dati non escono mai dai nostri server e non saranno mai venduti a terzi né utilizzati per altri scopi. Inoltre, in questo modo eliminiamo la necessità che il visitatore o la visitatrice accetti i cookie di marketing nel consueto banner (sono necessari solo quelli statistici, meno invasivi per il pubblico sensibile alla privacy).
Questo strumento è composto da due parti:
- Matomo Tag Manager, un gestore di tag che cattura i dati delle visite.
- Matomo Analytics, un analizzatore di visite e generatore di report, dove tali dati vengono archiviati.
I dati delle visite generati da Matomo Analytics sono disponibili in una dashboard dedicata, inclusa nell’opzione di menu Dashboard: Web analytics del nostro backoffice.
Altri tag manager
Sebbene l’uso di codici di tracciamento di terze parti, come Google Analytics, Yandex Metrika, Metricool o Meta Pixel, continui a essere supportato direttamente, si consiglia di utilizzarli attraverso i tag manager.
Oltre ai dati che Andronautic raccoglie con il proprio tag manager, e che presenta sotto forma di dashboard nel backoffice, i nostri clienti possono configurare i propri tag manager tramite l’opzione Web analytics and tracking del pannello di controllo del loro sito web pubblico. È sufficiente abilitare il tag manager desiderato e inserire l’identificatore.
Attualmente è possibile utilizzare i seguenti:
- Google Tag Manager.
- Matomo Tag Manager.
Eventi del tag manager
I tag manager utilizzano il concetto di evento per raccogliere i dati. Ogni pagina include almeno un evento, e ogni evento contiene un certo numero di attributi o parametri. L’insieme di eventi e dati inviati è noto come data layer. I dati inviati a questi tag manager esterni sono gli stessi raccolti dal nostro strumento interno, spiegati nella sezione seguente.
Gli eventi attualmente utilizzati si dividono, concettualmente, in due gruppi: navigazione ed e-commerce.
Eventi del tag manager di Andronautic
| Tipo | Nome | Descrizione |
|---|---|---|
| Navigazione | pageview |
Caricamento della pagina. Attivo su tutte le pagine quando vi si accede. |
| E-commerce | view_item_list |
Visualizzazione di un prodotto nella pagina di elenco prodotti. |
| E-commerce | select_item |
Clic su un prodotto dell’elenco. |
| E-commerce | view_item |
Visualizzazione della scheda del prodotto. |
| E-commerce | add_to_cart |
Prodotto aggiunto al carrello. |
| E-commerce | begin_checkout |
Inizio del processo di acquisto. |
| E-commerce | prepurchase |
Completamento del checkout e ingresso nel gateway di pagamento. |
| E-commerce | purchase |
Conferma della prenotazione, sia passata o meno attraverso un gateway di pagamento. |
| E-commerce | contact |
Utilizzo di un modulo di contatto o richiesta di informazioni. |
L’evento pageview viene eseguito su tutte le pagine, sempre per primo e indipendentemente dall’esecuzione di qualsiasi altro evento.
L’evento view_item_list della pagina di elenco prodotti viene eseguito più volte:
- Una prima volta con l’elenco dei prodotti visibili sullo schermo durante il caricamento iniziale della pagina.
- Successivamente, man mano che l’utente naviga o scorre la pagina (scrolls) e visualizza altri prodotti.
- In ogni chiamata vengono inviati uno o più prodotti (per ottimizzare il traffico di rete), in base alla velocità di scorrimento e alle dimensioni dello schermo.
L’evento view_item viene eseguito al caricamento della scheda di un prodotto.
L’evento add_to_cart viene attivato nei seguenti casi:
- Nella scheda del prodotto, quando si preme uno qualsiasi dei pulsanti che avviano l’elaborazione dell’ordine, poiché il prodotto viene aggiunto al carrello.
- Durante l’elaborazione (checkout), dopo l’evento
begin_checkout, se vengono aggiunti ulteriori prodotti al carrello (ad es., viene selezionato un extra).
L’evento begin_checkout viene attivato all’avvio del processo di prenotazione, a cui si può arrivare in tre modi:
- Dalla scheda del prodotto, premendo uno dei pulsanti che appaiono dopo la selezione iniziale dei parametri.
- Dall’area delle opportunità del backoffice.
- Direttamente, passando almeno le date nella stringa di query (query string) dell’URL.
L’evento prepurchase viene attivato nella pagina di checkout, premendo il pulsante Prenota in un modulo di prenotazione. Richiede che sia stato configurato nel sistema il metodo di pagamento, che può essere online (gateway di pagamento) o a posteriori (ad es., bonifico bancario).
L’evento purchase viene attivato solo al ritorno da un gateway di pagamento, dopo che tale pagamento è stato completato con successo.
L’evento contact viene attivato nella pagina di ringraziamento dopo aver compilato un modulo di contatto. Moduli di contatto disponibili:
- Come plug-in del CMS (senza contesto di prodotto), da utilizzare nelle pagine di contenuto.
- Nella scheda di attività e barca, con contesto del prodotto, con due varianti: a) in fondo alla pagina (predefinito), e b) nella colonna di destra, se il prodotto non è disponibile al caricamento della pagina.
- Nel checkout, sia nella scheda Contatto che in quella di Richiesta di informazioni (se abilitate), con contesto del prodotto, delle date e del prezzo.
Dal modulo che accompagna questo evento contact, il sistema può creare due tipi di entità: opportunità e prenotazioni. Per distinguere questo comportamento, viene inclusa una chiave aggiuntiva dataLayer.request_type, che può assumere due valori:
opportunity, quando viene creata un’opportunità.booking, quando viene creata una prenotazione.
Attributi comuni del data layer
In tutti gli eventi sono inclusi i seguenti attributi di contesto all’interno dell’oggetto page:
| Attributo | Descrizione |
|---|---|
pageTitle |
Titolo della pagina (page title) |
pageUrl |
Percorso della pagina (senza il dominio) |
pageType |
Tipo di pagina |
store |
Nome del sito web (site name) |
language |
Lingua di navigazione |
I tipi di pagina (attributo pageType) possono essere i seguenti:
home: pagina iniziale.content: pagina di contenuto del CMS.grid: elenco di prodotti.product: scheda di un prodotto.checkout: una qualsiasi delle pagine del processo di acquisto.account: pagina di creazione o modifica di un account utente.searcher: pagina dedicata esclusivamente a un motore di ricerca di prodotti.
In tutti gli eventi sono inclusi i seguenti attributi utente:
| Attributo | Descrizione |
|---|---|
clientID |
Id di sessione |
login |
Stato dell’utente nella sessione |
email |
Email (cifrata) dell’utente |
Variabili di e-commerce
Negli eventi di e-commerce sono incluse le seguenti variabili di transazione:
| Attributo | Descrizione |
|---|---|
orderID |
ID della transazione |
revenue |
Ricavi totali |
status |
Stato dell’ordine (confermato/non confermato) |
taxes |
Imposte della transazione |
totalProducts |
Numero totale di prodotti inclusi nella transazione |
coupon |
Buono sconto a livello di prodotto o transazione |
perDiscount |
Percentuale di sconto applicata alla transazione |
paymentMethod |
Metodo di pagamento |
locator |
Localizzatore della prenotazione |
request_type |
Tipo di “richiesta” (booking, opportunity…) |
E sono incluse le seguenti variabili di prodotto:
| Attributo | Descrizione |
|---|---|
name |
Nome del prodotto |
id |
SKU del prodotto (riferimento) |
price |
Prezzo di vendita del prodotto |
category |
Destinazione del prodotto (fino al massimo livello di dettaglio) |
variant |
Variante del prodotto (se applicabile) |
list |
Categoria web in cui viene mostrato il prodotto (propagata dall’elenco) |
brand |
Tipo di barca selezionato |
position |
Posizione in cui viene mostrato il prodotto nell’elenco |
date_start |
Data selezionata per l’inizio della prenotazione |
date_end |
Data selezionata per la fine della prenotazione |
days |
Numero totale di giorni di prenotazione |
productType |
Tipo di prodotto (barca, attività) |
subTypeBoat |
Barca con o senza patente (yes/no) |
mainUrlPhoto |
Immagine principale del prodotto (url) |
promoted |
Indica se è un prodotto in evidenza nell’elenco (yes/no) |
quantity |
Numero di passeggeri nella prenotazione |
currency |
Valuta |
index |
Utilizzato negli elenchi di barche/attività, indica la posizione rispetto al resto |
Questo elenco di eventi e dei relativi attributi sarà ampliato nel tempo, man mano che verranno individuate nuove esigenze.