Cosa include il dataLayer del modulo Google Tag Manager?

Il modulo Google Tag Manager per PrestaShop invia eventi ecommerce in formato GA4 dentro dataLayer, così i tag nel tuo container GTM possono leggere dati strutturati del negozio senza modificare i template del tema.

Il modulo emette eventi ecommerce lato browser inclusi view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout e purchase. Supporta anche eventi non ecommerce semplici come ricerca, login e registrazione, oltre a regole dataLayer personalizzate configurabili. Prima di ogni evento ecommerce invia {ecommerce: null}, che è il pattern di reset sicuro per GA4.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({'ecommerce': null});
window.dataLayer.push({
  'event': 'purchase',
  'ecommerce': {
    'transaction_id': 'ABCDXYZ',
    'affiliation': 'Example Shop',
    'value': 129.90,
    'tax': 21.65,
    'shipping': 4.90,
    'currency': 'EUR',
    'coupon': 'WELCOME10',
    'items': [{
      'item_id': '42',
      'item_name': 'Premium Shower Tray',
      'item_brand': 'Example Brand',
      'item_category': 'Bathroom',
      'item_variant': '90x90',
      'price': 125.00,
      'quantity': 1
    }]
  }
});

Lo script container GTM viene iniettato nell'header della pagina, e l'iframe noscript viene iniettato dopo il tag body di apertura quando il tema espone quell'hook. La gestione Consent Mode è progettata per lavorare con mprcookiesrevolution: quando quella CMP è installata, il modulo sposta il proprio hook header dopo la CMP; quando non è presente alcuna CMP, può emettere un fallback Consent Mode v2 default denied prima che GTM venga caricato.

Il tracking viene saltato per richieste non front, bot noti, dipendenti loggati quando l'opzione è abilitata e visitatori con cookie opt-out mpr_notrack=1. Il fallback server-side opzionale Measurement Protocol invia dati acquisto su actionValidateOrder quando sono configurati un GA4 Measurement ID e API Secret validi; GA4 deduplica tramite transaction_id.