Mesurer l'e-commerce

Vous pouvez configurer des événements d'e-commerce pour collecter des informations sur le comportement d'achat de vos utilisateurs. Ces événements vous permettent de quantifier vos produits les plus populaires, et de voir l'impact des promotions et des placements de produits sur vos revenus.

Ce document décrit chaque événement d'e-commerce et explique quand le configurer. Pour obtenir un exemple détaillé de la configuration d'un événement d'e-commerce, consultez Configurer un événement d'achat.

Avant de commencer

Ajouter la balise de configuration GA4 à votre site Web

Assurez-vous d'avoir ajouté la balise "Google Analytics : Configuration GA4" à votre site Web et d'avoir accès à Analytics et au code source du site Web.

Mesurer les événements d'e-commerce avec le tag d'événement GA4

Pour envoyer des événements et des paramètres d'e-commerce à votre propriété Google Analytics :

  1. Ouvrez Google Tag Manager.

  2. Dans votre espace de travail, ouvrez le menu Balises.

  3. Créez une balise en cliquant sur Nouveau. Cliquez sur la zone Configuration de la balise et sélectionnez la balise Google Analytics : Événement GA4.

  4. Pour Nom de l'événement, utilisez la variable intégrée {{Event}}. Le nom de l'événement d'e-commerce Google Analytics envoyé à l'aide de l'API gtag.js sera utilisé.

  5. Sous Plus de paramètres > E-commerce, cochez Envoyer des données d'e-commerce.

  6. Pour Source de données, sélectionnez Couche de données. Interface utilisateur Tag Manager affichant la configuration des balises d'e-commerce.

  7. Configurez un déclencheur pour l'événement GA4, par exemple lorsqu'un utilisateur clique sur un bouton de paiement. Consultez tous les types de déclencheurs disponibles.

  8. Attribuez un nom à la balise, puis enregistrez-la.

Recommandations

  • Activez le mode débogage pour afficher les événements en temps réel et résoudre les problèmes.
  • Consultez les limites des dimensions et métriques personnalisées lorsque vous envoyez des paramètres personnalisés avec des événements d'e-commerce.
  • Définissez currency lorsque vous envoyez des données value (revenus) pour vous assurer que les métriques de revenus sont calculées correctement.
  • Définissez chaque paramètre d'e-commerce pour lequel vous disposez de données, qu'il soit facultatif ou non.
  • Utilisez l'exemple de site Web d'e-commerce pour découvrir comment taguer votre site Web.
  • Pour vous assurer que les données s'affichent correctement dans les rapports, respectez le format indiqué dans ce document. Si vous devez définir le tableau "items" en dehors du tableau "ecommerce", définissez le paramètre currency au niveau de l'événement lorsque vous envoyez des données value (revenus).

Implémentation

En général, une implémentation de l'e-commerce mesure une ou plusieurs des actions suivantes :

Les produits et les services que vous vendez se trouvent au cœur de ces actions. Vous pouvez représenter des produits et des services sous la forme d'un tableau d'articles qui peuvent être ajoutés aux événements d'e-commerce. Vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau des éléments, en plus des paramètres prescrits.

L'exemple suivant montre comment créer la collection de items référencée tout au long de ce guide. Le tableau items peut inclure jusqu'à 200 éléments.

items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      quantity: 2
    }
]

Sélectionner un élément dans une liste

Lorsqu'une liste de résultats est présentée à un utilisateur, envoyez un événement view_item_list incluant un paramètre de tableau items contenant les éléments affichés. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : view_item_list
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • ID de la liste d'articles e-commerce : ecommerce.item_list_id
    • Nom de la liste d'articles d'e-commerce : ecommerce.item_list_name
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • item_list_id{{Ecommerce Item List ID}}
    • item_list_name : {{Ecommerce Item List Name}}
  • Déclencheur : événement égal à view_item_list

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : view_item_list
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

Une fois qu'un utilisateur a sélectionné un élément dans la liste, envoyez l'événement select_item avec l'élément sélectionné dans un paramètre de tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : select_item
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • ID de la liste d'articles e-commerce : ecommerce.item_list_id
    • Nom de la liste d'articles d'e-commerce : ecommerce.item_list_name
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • item_list_id{{Ecommerce Item List ID}}
    • item_list_name : {{Ecommerce Item List Name}}
  • Déclencheur : événement égal à select_item

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : select_item
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Afficher les détails d'un élément

Pour mesurer le nombre de fois où les détails d'un article sont consultés, envoyez un événement view_item chaque fois qu'un utilisateur consulte l'écran d'informations détaillées d'un article. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : view_item
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency : {{Ecommerce Currency}}
  • Déclencheur : événement égal à view_item

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : view_item
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Ajouter ou supprimer un article d'un panier

Mesurez l'ajout d'un article à un panier en envoyant un événement add_to_cart avec les articles concernés dans un tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : add_to_cart
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency : {{Ecommerce Currency}}
  • Déclencheur : événement égal à add_to_cart

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : add_to_cart
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Vous pouvez également mesurer le moment où un article est ajouté à une liste de souhaits en envoyant un événement add_to_wishlist avec les articles concernés dans un tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : add_to_wishlist
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency : {{Ecommerce Currency}}
  • Déclencheur : événement égal à add_to_wishlist

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : add_to_wishlist
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Lorsqu'un utilisateur consulte ensuite le panier, envoyez l'événement view_cart avec tous les articles du panier. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : view_cart
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency : {{Ecommerce Currency}}
  • Déclencheur : événement égal à view_cart

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : view_cart
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Pour mesurer le moment où un utilisateur supprime un article d'un panier, envoyez l'événement remove_from_cart. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : remove_from_cart
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency : {{Ecommerce Currency}}
  • Déclencheur : événement égal à remove_from_cart

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : remove_from_cart
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Initier le processus de paiement

Mesurez la première étape d'un processus de règlement en envoyant un événement begin_checkout avec un ou plusieurs articles définis avec les champs appropriés. Un bon de réduction peut également être ajouté à ce stade à l'ensemble de la commande en l'ajoutant à l'événement ou appliqué à un article particulier en l'ajoutant à des éléments spécifiques du tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : begin_checkout
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency{{Ecommerce Currency}}
    • coupon : {{Ecommerce Coupon}}
  • Déclencheur : événement égal à begin_checkout

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : begin_checkout
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Lorsqu'un utilisateur passe à l'étape suivante du processus de règlement et ajoute des informations de livraison, envoyez un événement add_shipping_info. Utilisez le paramètre shipping_tier pour spécifier l'option de livraison de l'utilisateur, par exemple "Ground", "Air" ou "Next-day". Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : add_shipping_info
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
    • Niveau de livraison pour l'e-commerce : ecommerce.shipping_tier
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency{{Ecommerce Currency}}
    • coupon{{Ecommerce Coupon}}
    • shipping_tier : {{Ecommerce Shipping Tier}}
  • Déclencheur : événement égal à add_shipping_info

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : add_shipping_info
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Envoyez l'événement add_payment_info lorsqu'un utilisateur envoie ses informations de paiement. Le cas échéant, incluez payment_type avec cet événement pour le mode de paiement choisi. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : add_payment_info
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • Valeur e-commerce : ecommerce.value
    • Devise de l'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
    • Type de paiement pour l'e-commerce : ecommerce.payment_type
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • value{{Ecommerce Value}}
    • currency{{Ecommerce Currency}}
    • coupon{{Ecommerce Coupon}}
    • payment_type : {{Ecommerce Payment Type}}
  • Déclencheur : événement égal à add_payment_info

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : add_payment_info
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Effectuer un achat ou émettre un remboursement

Mesurez un achat en envoyant un événement purchase avec un ou plusieurs articles définis avec les champs appropriés. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : purchase
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • ID de transaction d'e-commerce : ecommerce.transaction_id
    • Valeur e-commerce : ecommerce.value
    • Taxes sur l'e-commerce : ecommerce.tax
    • Livraison pour l'e-commerce : ecommerce.shipping
    • Devise de l'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • transaction_id{{Ecommerce Transaction ID}}
    • value{{Ecommerce Value}}
    • tax{{Ecommerce Tax}}
    • shipping{{Ecommerce Shipping}}
    • currency{{Ecommerce Currency}}
    • coupon : {{Ecommerce Coupon}}
  • Déclencheur : événement égal à purchase

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : purchase
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    customer_type: "new",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

Mesurez les remboursements en envoyant un événement refund avec le transaction_id correspondant spécifié et un ou plusieurs articles définis avec item_id et quantity. Nous vous recommandons d'inclure des informations sur les articles dans votre événement refund pour afficher les métriques de remboursement au niveau des articles dans Analytics.

Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : refund
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Éléments d'e-commerce : ecommerce.items
    • ID de transaction d'e-commerce : ecommerce.transaction_id
    • Valeur e-commerce : ecommerce.value
    • Taxes sur l'e-commerce : ecommerce.tax
    • Livraison pour l'e-commerce : ecommerce.shipping
    • Devise de l'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre – valeur) :
    • items : {{Ecommerce Items}}
    • transaction_id{{Ecommerce Transaction ID}}
    • value{{Ecommerce Value}}
    • tax{{Ecommerce Tax}}
    • shipping{{Ecommerce Shipping}}
    • currency{{Ecommerce Currency}}
    • coupon : {{Ecommerce Coupon}}
  • Déclencheur : événement égal à refund

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : refund
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Appliquer des promotions

L'e-commerce permet de mesurer les impressions et les clics des promotions internes, comme les bannières affichées pour promouvoir une vente.

Les impressions de promotion sont généralement mesurées avec la vue de l'écran initial en envoyant l'événement view_promotion avec un paramètre "items" pour spécifier l'article promu. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Nom de l'événement : view_promotion
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Nom de la création e-commerce : ecommerce.creative_name
    • Emplacement de création pour l'e-commerce : ecommerce.creative_slot
    • Identifiant de la promotion d'e-commerce : ecommerce.promotion_id
    • Nom de la promotion d'e-commerce : ecommerce.promotion_name
    • Éléments d'e-commerce : ecommerce.items
  • Paramètres d'événement (nom du paramètre – valeur) :
    • creative_name : {{Ecommerce Creative Name}}
    • creative_slot{{Ecommerce Creative Slot}}
    • promotion_id{{Ecommerce Promotion ID}}
    • promotion_name{{Ecommerce Promotion Name}}
    • items : {{Ecommerce Items}}
  • Déclencheur : événement égal à view_promotion

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : view_promotion
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Pour indiquer qu'un utilisateur a cliqué sur une promotion, envoyez un événement select_promotion avec cet article comme paramètre d'article. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.

Affiche-moi la configuration de la balise

Configuration de la balise :

  • Type de balise : Google Analytics : Événement GA4
  • Variables de couche de données (nom : nom de la variable de couche de données) :
    • Nom de la création e-commerce : ecommerce.creative_name
    • Emplacement de création pour l'e-commerce : ecommerce.creative_slot
    • Identifiant de la promotion d'e-commerce : ecommerce.promotion_id
    • Nom de la promotion d'e-commerce : ecommerce.promotion_name
    • Éléments d'e-commerce : ecommerce.items
  • Paramètres d'événement (nom du paramètre – valeur) :
    • creative_name : {{Ecommerce Creative Name}}
    • creative_slot{{Ecommerce Creative Slot}}
    • promotion_id{{Ecommerce Promotion ID}}
    • promotion_name{{Ecommerce Promotion Name}}
    • items : {{Ecommerce Items}}
  • Type de variable : variable de couche de données "ecommerce.items"
  • Déclencheur : événement égal à select_promotion

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : select_promotion
  • Conditions dans lesquelles le déclencheur est exécuté : tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Utiliser une variable JavaScript personnalisée

Si votre site Web n'est pas compatible avec une couche de données, vous pouvez utiliser une variable JavaScript personnalisée pour appeler une fonction qui renvoie l'objet de données d'e-commerce. Cet objet doit utiliser la syntaxe de la couche de données présentée plus haut dans ce guide. Par exemple :

// A Custom JavaScript Variable that returns an ecommerceData object
// that follows the data layer syntax.
function getEcommerceData() {
  var ecommerceProductData = [
    {
      item_name: "Stan and Friends Tee",
      item_id: "SKU_12345",  // ID is required.
      // Rest of the product data should follow the data layer syntax.
    },
    // Multiple products may be included.
  ];
  return ecommerceProductData;
}

Si vous choisissez d'utiliser une variable JavaScript personnalisée, vous pouvez l'utiliser de la même manière que la couche de données. Vous pouvez fournir la valeur du paramètre items en tant que paramètre d'événement dans la configuration de votre balise.

Configuration de la balise :

  • Type de balise : Événement GA4
  • Nom de l'événement : tout
  • Lire les données provenant de la variable : {{gaEcommerceData}}
  • Déclencheur : événement égal à gtm.dom

Paramètres de la variable {{gaEcommerceData}} :

  • Type de variable : JavaScript personnalisé
  • Corps de la fonction : utilisez l'exemple précédent.