E-commerce amélioré

Cette page explique comment utiliser gtag.js pour collecter des données d'e-commerce amélioré. Si vous avez configuré Google Analytics dans gtag.js et que vous avez activé l'e-commerce amélioré dans Google Analytics, vous pouvez utiliser gtag.js pour envoyer à Google Analytics des données sur les impressions, les produits, les promotions et les actions.

Types de données et actions d'e-commerce amélioré

Vous pouvez envoyer plusieurs types de données d'e-commerce:

Données sur les impressions

Représente les informations relatives à un produit consulté. Il est appelé impressionFieldObject et contient les valeurs suivantes:

Clé Type de valeur Obligatoire Description
id text *Oui

Identifiant produit ou SKU (par exemple, P67890).

* Vous devez définir id ou name.

name text *Oui

Nom du produit (par exemple, "T-shirt Android").

* Vous devez définir id ou name.

list text Non Liste ou collection à laquelle appartient le produit (par exemple, les résultats de recherche)
list_name text Non Liste ou collection à laquelle appartient le produit (par exemple, les résultats de recherche)
brand text Non Marque associée au produit (par exemple, Google).
category text Non Catégorie à laquelle appartient le produit (par exemple, "Vêtements"). Utilisez / comme délimiteur pour spécifier jusqu'à cinq niveaux de hiérarchie (par exemple, Vêtements/Hommes/T-shirts).
variant text Non Variante du produit (par exemple, noir).
position integer Non Position du produit dans une liste ou une collection (par exemple, 2).
list_position integer Non Position du produit dans une liste ou une collection (par exemple, 2).
price Nombre Non Prix d'un produit (par exemple, 29.20).

Données relatives aux produits

Les données produit représentent des produits individuels qui ont été consultés, ajoutés au panier, etc. Elles sont appelées productFieldObject et contiennent les valeurs suivantes:

Clé Type de valeur Obligatoire Description
id text *Oui

Identifiant produit ou SKU (par exemple, P67890).

* Vous devez définir l'ID ou name.

name text *Oui

Nom du produit (par exemple, "T-shirt Android").

* Vous devez définir l'ID ou name.

brand text Non Marque associée au produit (par exemple, Google).
category text Non Catégorie à laquelle appartient le produit (par exemple, "Vêtements"). Utilisez / comme délimiteur pour spécifier jusqu'à cinq niveaux de hiérarchie (par exemple, Vêtements/Hommes/T-shirts).
variant text Non Variante du produit (par exemple, noir).
price Nombre Non Prix d'un produit (par exemple, 29.20).
quantity integer Non Quantité d'un produit (par exemple, 2).
coupon text Non Code promotionnel associé à un produit (par exemple, SUMMER_SALE13).
position integer Non Position du produit dans une liste ou une collection (par exemple, 2).
list_position integer Non Position du produit dans une liste ou une collection (par exemple, 2).

Données de promotion

Représente les informations sur une promotion ayant été consultée. Il est appelé promoFieldObject et contient les valeurs suivantes:

Clé Type de valeur Obligatoire Description
id text *Oui

Identifiant de la promotion (par exemple, PROMO_1234).

* Vous devez définir id ou name.

name text *Oui

Nom de la promotion (par exemple, "Soldes d'été").

* Vous devez définir id ou name.

creative text Non Création associée à la promotion (par exemple, bannière_été2).
creative_name text Non Nom de la création (par exemple, bannière_été2).
position text Non Position de la création (par exemple, "Banner_slot_1").
creative_slot text Non Nom de l'emplacement de la création (par exemple, espace_bannière_1).

Données d'action

Représente les informations sur une action effectuée concernant l'e-commerce. Il est appelé actionFieldObject et contient les valeurs suivantes:

Clé Type de valeur Obligatoire Description
id text *Oui

ID de la transaction (par exemple, T1234).

* Obligatoire si le type d'action est purchase ou refund

affiliation text Non Magasin ou affiliation à partir duquel la transaction a été effectuée (par exemple, Google Store).
revenue Nombre Non

Spécifie le revenu total ou le total général associé à la transaction (par exemple, 11,99). Cette valeur peut inclure les frais de livraison, les frais fiscaux ou d'autres ajustements au revenu total que vous souhaitez inclure dans votre calcul de revenus.

valeur Nombre Non Valeur (revenus) associée à l'événement.
tax Nombre Non Montant total des taxes associées à la transaction.
shipping Nombre Non Frais de port associés à la transaction.
coupon text Non Bon de réduction utilisé lors de la transaction.
list text Non Liste à laquelle appartiennent les produits associés. Facultatif.
items tableau Non Tableau contenant les produits associés.
step integer Non Numéro représentant une étape du processus de règlement. Facultatif pour les actions de paiement.
checkout_step integer Non Numéro représentant une étape du processus de règlement.
option text Non Champ supplémentaire pour les actions checkout et checkout_option pouvant décrire les informations des options sur la page de paiement, comme le mode de paiement sélectionné.
checkout_option text Non Option de paiement (mode de paiement sélectionné).
Clé Type de valeur Obligatoire Description
coupon chaîne Non Code promotionnel d'un article pouvant être acheté.

Actions liées aux produits et à la promotion

Les actions spécifient comment interpréter les données sur les produits et les promotions que vous envoyez à Google Analytics.

Action Événement Description
click Clic sur un produit ou un lien de produit pour un ou plusieurs produits.
detail Affichage des informations détaillées sur le produit.
add Ajout d'un ou plusieurs produits à un panier
remove Supprimer un ou plusieurs produits d'un panier
checkout Lancement du processus de règlement pour un ou plusieurs produits...
checkout_option Envoi de la valeur de l'option pour une étape de règlement donnée.
purchase La vente d'un ou de plusieurs produits
refund Remboursement d'un ou de plusieurs produits.
promo_click Clic sur une promotion interne.
add_to_cart Un utilisateur ajoute un ou plusieurs produits à son panier.
begin_checkout Un utilisateur commence le processus de paiement pour un ou plusieurs produits.
checkout_progress Un utilisateur finalise le règlement après la première étape.
purchase Un utilisateur effectue un achat.
refund Un ou plusieurs produits sont remboursés à l'utilisateur.
remove_from_cart Un utilisateur supprime un ou plusieurs produits d'un panier.
select_content Un utilisateur clique sur un produit ou un lien de produit.
set_checkout_option Étape de règlement effectuée par un utilisateur.
view_item Un utilisateur consulte les détails d'un produit.
view_item_list Un utilisateur consulte une liste d'un ou plusieurs produits.
view_promotion Un utilisateur clique sur une promotion interne.
view_refund Un utilisateur consulte un remboursement pour un ou plusieurs produits.

Exemples

Mesurer les impressions des produits

Pour mesurer les impressions de produits, envoyez une view_item_list avec les informations sur les produits:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Mesurer les clics sur les produits

Pour mesurer un clic sur un produit, envoyez un événement select_content, spécifiez product comme content_type et fournissez les informations sur le produit:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Mesurer les vues des informations détaillées sur les produits

Après avoir cliqué sur une fiche produit, l'utilisateur peut afficher la page d'informations détaillées sur le produit. Pour mesurer les vues des informations détaillées sur le produit, envoyez un événement view_item avec les informations détaillées sur le produit:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Mesurer les ajouts et les suppressions de paniers

Pour mesurer l'ajout d'un produit au panier, envoyez un événement add_to_cart avec les informations sur le produit:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Pour mesurer le retrait d'un produit d'un panier, envoyez un événement remove_from_cart avec les informations sur le produit:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Mesurer les paiements

Pour mesurer chaque étape d'un processus de paiement:

  1. Ajoutez un code de mesure pour mesurer chaque étape du processus de paiement.
  2. Le cas échéant, ajoutez un code de mesure pour enregistrer les options de paiement.

1. Mesurer les étapes de paiement

Pour mesurer la première étape de règlement, envoyez un événement begin_checkout avec les articles du règlement:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

Pour mesurer chaque étape de règlement ultérieure, envoyez un événement checkout_progress avec les articles du règlement:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. Mesurer les options de paiement

Pour mesurer une option de paiement, envoyez un événement set_checkout_option avec l'option de paiement:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

Mesurer les impressions de promotion

Pour mesurer les impressions de promotion, envoyez un événement view_promotion contenant des informations sur la promotion:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Mesurer les clics sur les promotions

Pour mesurer un clic sur une promotion, envoyez un événement select_content et indiquez la promotion:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Mesurer les achats

Pour mesurer une transaction, envoyez un événement purchase avec les articles inclus dans la transaction:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

Mesurer les remboursements

Pour mesurer le remboursement total d'une transaction, envoyez un événement refund avec l'ID de transaction:

gtag('event', 'refund', { "transaction_id": "T12345" })

Pour mesurer un remboursement partiel, envoyez un événement refund avec l'ID de transaction et les articles à rembourser:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});