Andronautic
Torna al blog
Website

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.