Declencheur : Custom Event (avance)

Ce qu'on va faire sur cette page

On va aller plus loin avec le Custom Event : evenements structures avec des parametres riches, des variables Data Layer imbriquees, et des patterns de nommage professionnels.

  1. Ouvrir GTM Preview
  2. Tester les differents events structures ci-dessous
  3. Observer la structure des donnees dans le dataLayer
  4. Creer des variables Data Layer pour extraire les parametres imbriques

Events structures avec parametres riches

Event avec donnees imbriquees

Ce bouton push un objet complexe dans le dataLayer :

Structure imbriquee et variables Data Layer 
// Event avec structure imbriquee (e-commerce GA4) :
window.dataLayer.push({
    event: "purchase_demo",
    ecommerce: {
        transaction_id: "T-12345",
        value: 297,
        currency: "EUR",
        items: [{
            item_id: "SKU-001",
            item_name: "Formation GTM",
            price: 297,
            quantity: 1
        }]
    }
});

// Pour extraire "transaction_id" dans GTM :
// Creer une variable Data Layer :
//   Name: ecommerce.transaction_id
//   Data Layer Version: Version 2
//
// Pour extraire le premier item :
//   Name: ecommerce.items.0.item_name
//   -> Retourne "Formation GTM"
Convention de nommage des events 
// Bonnes pratiques de nommage des events :

// GA4 recommande le snake_case :
"generate_lead"      // pas "Generate Lead" ou "generateLead"
"file_download"      // pas "FileDownload"
"add_to_cart"        // pas "add-to-cart"

// Events recommandes par GA4 (utiliser ceux-la en priorite) :
// Engagement :     page_view, scroll, click, file_download, video_start, video_complete
// E-commerce :     view_item, add_to_cart, begin_checkout, purchase
// Lead gen :       generate_lead, sign_up, login
// Custom :         prefixer avec le contexte -> "form_submit_contact", "cta_click_hero"

// EVITER :
// - Les noms generiques : "click", "event", "action"
// - Les noms avec des espaces ou majuscules
// - Les noms trop specifiques : "button_red_homepage_top_right"

Pro tips

1. Toujours utiliser les noms d'events GA4 recommandes quand ils existent (generate_lead, purchase, etc.) - les rapports GA4 les reconnaissent automatiquement.
2. Version 2 des variables Data Layer pour les objets imbriques.
3. Pas plus de 25 parametres par event dans GA4 (limite technique).