Essayez le serveur MCP pour Google Analytics. Installez-le depuis GitHub et consultez l'annonce pour en savoir plus.

Événements recommandés

Google Analytics envoie automatiquement certains types d'événements. Cette page décrit les événements supplémentaires facultatifs que vous pouvez configurer pour mesurer davantage de comportements et générer des rapports plus utiles pour votre entreprise. Ces événements supplémentaires demandent plus d'efforts de configuration avant de pouvoir être utilisés. Google Analytics 4 ne peut donc pas les envoyer automatiquement. Pour obtenir des instructions détaillées sur la configuration d'événements recommandés et personnalisés pour votre site Web ou votre application, consultez Configurer des événements.

Pour afficher les détails de chaque événement que vous pouvez utiliser, sélectionnez votre plate-forme de gestion des balises :

`add_payment_info`

Cet événement indique qu'un utilisateur a envoyé ses informations de paiement lors d'un processus de règlement d'e-commerce.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`payment_type`	`string`	Non	Carte de crédit	Le mode de paiement choisi.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}
coupon – {{Ecommerce Coupon}}
payment_type : {{Ecommerce Payment Type}}

Déclencheur : événement "add_payment_info"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : add_payment_info
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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).

`add_shipping_info`

Cet événement indique qu'un utilisateur a envoyé ses informations de livraison lors d'un processus de règlement d'e-commerce.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`shipping_tier`	`string`	Non	Rez-de-chaussée	Niveau de livraison (par exemple, `Ground`, `Air`, `Next-day`) sélectionné pour la livraison de l'article acheté.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}
coupon – {{Ecommerce Coupon}}
shipping_tier - {{Ecommerce Shipping Tier}}

Déclencheur : événement "add_shipping_info"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : add_shipping_info
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`add_to_cart`

Cet événement indique qu'un article a été ajouté au panier pour être acheté.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
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
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`add_to_wishlist`

Cet événement indique qu'un article a été ajouté à une liste de souhaits. Utilisez cet événement pour identifier les articles cadeaux populaires dans votre application.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
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
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`begin_checkout`

Cet événement indique qu'un utilisateur a commencé le processus de paiement.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}
coupon – {{Ecommerce Coupon}}

Déclencheur : événement "begin_checkout"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : begin_checkout
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`close_convert_lead`

Cet événement est enregistré lorsqu'un prospect a été converti et clôturé (par exemple, par le biais d'un achat).

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : close_convert_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03

Déclenchez l'événement lorsque l'utilisateur est devenu un prospect converti (un client).

`close_unconvert_lead`

Cet événement est enregistré lorsqu'un utilisateur est marqué comme n'étant pas devenu un prospect converti, ainsi que la raison.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`unconvert_lead_reason`	`string`	Non	N'a jamais répondu	Raison pour laquelle le prospect n'a pas été converti.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : close_unconvert_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03

Déclenchez l'événement lorsqu'un utilisateur est marqué comme n'étant pas devenu un lead converti pour l'une des différentes raisons applicables.

`disqualify_lead`

Cet événement est enregistré lorsqu'un utilisateur est marqué comme lead non qualifié, ainsi que la raison de la disqualification.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`disqualified_lead_reason`	`string`	Non	Je ne cherche pas à acheter	Raison pour laquelle un lead a été marqué comme disqualifié.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : disqualify_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03
disqualified_lead_reason : ne cherche pas à acheter

Déclenchez l'événement lorsqu'un utilisateur est marqué comme non éligible à devenir un prospect pour l'une des différentes raisons applicables.

`earn_virtual_currency`

Cet événement est enregistré lorsqu'un utilisateur reçoit de la monnaie virtuelle dans un jeu. Enregistrez cet événement avec spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`virtual_currency_name`	`string`	Non	Gems	Nom de la devise virtuelle.
`value`	`number`	Non	5	Valeur de la devise virtuelle.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : earn_virtual_currency
Paramètres d'événement (nom du paramètre – valeur) :

virtual_currency_name – Gems
value – 5

Déclencher l'événement lorsqu'un utilisateur reçoit de la monnaie virtuelle

`generate_lead`

Cet événement est enregistré lorsqu'un prospect a été généré (par exemple, via un formulaire). Enregistrez cet événement pour comprendre l'efficacité de vos campagnes marketing et le nombre de clients qui interagissent à nouveau avec votre entreprise après avoir été remarketés.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`lead_source`	`string`	Non	Salon professionnel	Source du prospect.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : generate_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03
lead_source – Salon professionnel

Déclencher l'événement lorsqu'un prospect a été généré

`join_group`

Enregistrez cet événement lorsqu'un utilisateur rejoint un groupe tel qu'une guilde, une équipe ou une famille. Utilisez cet événement pour analyser la popularité de certains groupes ou de certaines fonctionnalités sur les réseaux sociaux.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`group_id`	`string`	Non	G_12345	ID du groupe.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : join_group
Paramètres d'événement (nom du paramètre – valeur) :

group_id - G_12345

Déclenchez l'événement lorsqu'un utilisateur rejoint un groupe.

`level_end`

Cet événement indique qu'un joueur a terminé un niveau dans un jeu.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`level_name`	`string`	Non	L'aventure commence…	Nom du niveau.
`success`	`boolean`	Non	true	Défini sur `true` si le niveau a été terminé avec succès.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : level_end
Paramètres d'événement (nom du paramètre – valeur) :

level_name : le voyage commence…
success : true

Déclenchement lorsqu'un joueur a terminé un niveau (par exemple, la page de confirmation du niveau)

`level_start`

Cet événement indique qu'un joueur a commencé un niveau dans un jeu.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`level_name`	`string`	Non	L'aventure commence…	Nom du niveau.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : level_start
Paramètres d'événement (nom du paramètre – valeur) :

level_name : le voyage commence…

Déclenchement lorsqu'un utilisateur commence un nouveau niveau (par exemple, la page de début du niveau)

`level_up`

Cet événement indique qu'un joueur est passé à un niveau supérieur dans un jeu. Utilisez-la pour évaluer la distribution des niveaux de votre base d'utilisateurs et identifier les niveaux difficiles à terminer.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`level`	`number`	Non	5	Niveau du personnage.
`character`	`string`	Non	Joueur 1	Le personnage qui a gagné un niveau.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : level_up
Paramètres d'événement (nom du paramètre – valeur) :

level – 5
character – Joueur 1

Déclenchement lorsqu'un joueur passe au niveau supérieur

`login`

Envoyez cet événement pour indiquer qu'un utilisateur s'est connecté à votre site Web ou application.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`method`	`string`	Non	Google	Méthode utilisée pour se connecter.

Exemple

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : login
Paramètres d'événement (nom du paramètre – valeur) :

method - Google

Déclenchement lorsqu'un utilisateur s'est connecté

`post_score`

Envoyez cet événement lorsque l'utilisateur publie un score. Utilisez cet événement pour comprendre les performances des utilisateurs dans votre jeu et corréler les meilleurs scores avec les audiences ou les comportements.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`score`	`number`	Oui	10000	Score à publier.
`level`	`number`	Non	5	Niveau du score.
`character`	`string`	Non	Joueur 1	Personnage ayant obtenu le score.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : post_score
Paramètres d'événement (nom du paramètre – valeur) :

score - 10 000
level – 5
character – Joueur 1

Déclenchement lorsque l'utilisateur publie un score

`purchase`

Cet événement se produit lorsqu'un utilisateur achète un ou plusieurs articles.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`customer_type`	`string` (`new` / `returning`)	Non	nouveau	La conversion provient-elle d'un nouveau client ou d'un client connu ? `new` : nouveau client n'ayant effectué aucun achat au cours d'une période donnée (une durée de 540 jours est recommandée et définie par défaut, mais elle n'est pas obligatoire). `returning` : client connu ayant effectué un achat au cours de la période donnée. Ne spécifiez pas de valeur en cas d'incertitude (par exemple, si l'utilisateur a effectué le règlement en tant qu'invité).
`transaction_id`	`string`	Oui	T_12345	Identifiant unique d'une transaction. Le paramètre `transaction_id` vous aide à éviter de recevoir des événements en double pour un achat.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`shipping`	`number`	Non	3,33	Frais de port associés à une transaction.
`tax`	`number`	Non	1.11	Montant des taxes associées à une transaction.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : purchase

Éléments d'e-commerce : ecommerce.items
ID de la 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 : {{ID de la transaction e-commerce}}
value – {{Valeur e-commerce}}
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
Ce déclencheur est exécuté pour 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
    }]
  }
});

`qualify_lead`

Cet événement est enregistré lorsqu'un utilisateur est marqué comme répondant aux critères pour devenir un prospect qualifié.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : qualify_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03

Déclenchez l'événement lorsqu'un utilisateur est marqué comme répondant aux critères pour devenir un prospect qualifié.

`refund`

Cet événement se produit lorsqu'un ou plusieurs articles sont remboursés à un utilisateur.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`transaction_id`	`string`	Oui	T_12345	Identifiant unique d'une transaction.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`shipping`	`number`	Non	3,33	Frais de port associés à une transaction.
`tax`	`number`	Non	1.11	Montant des taxes associées à une transaction.
`items`	`Array<Item>`	Non*		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 la 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 : {{ID de la transaction e-commerce}}
value – {{Valeur e-commerce}}
tax : {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency : {{Ecommerce Currency}}
coupon – {{Ecommerce Coupon}}

Déclencheur : événement "remboursement"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : refund
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`remove_from_cart`

Cet événement indique qu'un article a été supprimé d'un panier.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}

Déclencheur : événement "remove_from_cart"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : remove_from_cart
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`search`

Enregistrez cet événement pour indiquer quand l'utilisateur a effectué une recherche. Vous pouvez utiliser cet événement pour identifier ce que les utilisateurs recherchent sur votre site Web ou dans votre application. Par exemple, vous pouvez envoyer cet événement lorsqu'un utilisateur consulte une page de résultats de recherche après avoir effectué une recherche.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`search_term`	`string`	Oui	t-shirts	Terme recherché.

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : search
Paramètres d'événement (nom du paramètre – valeur) :

search_term : t-shirts

Déclenchement lorsqu'un utilisateur effectue une recherche sur votre site Web

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : search
Paramètres d'événement (nom du paramètre – valeur) :

search_term : t-shirts

Déclenchement lorsqu'un utilisateur effectue une recherche sur votre site Web

`select_content`

Cet événement indique qu'un utilisateur a sélectionné du contenu d'un certain type. Cet événement peut vous aider à identifier les contenus et les catégories de contenus populaires sur votre site Web ou votre application.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`content_type`	`string`	Non	produit	Type de contenu sélectionné.
`content_id`	`string`	Non	C_12345	Identifiant du contenu sélectionné.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : select_content
Paramètres d'événement (nom du paramètre – valeur) :

content_type – produit
content_id – C_12345

Déclencheur : événement "select_content"

`select_item`

Cet événement indique qu'un élément a été sélectionné dans une liste.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Ignoré s'il est défini au niveau de l'élément.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Ignoré s'il est défini au niveau de l'élément.
`items`	`Array<Item>`	Oui*		Éléments de l'événement. * Le tableau `items` doit comporter un seul élément, représentant l'élément sélectionné. Si plusieurs éléments sont fournis, seul le premier élément de `items` sera utilisé.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 : {{ID de la liste d'articles e-commerce}}
item_list_name : {{Ecommerce Item List Name}}

Déclencheur : événement "select_item"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : select_item
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`select_promotion`

Cet événement indique qu'une promotion a été sélectionnée dans une liste.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`creative_name`	`string`	Non	summer_banner2	Nom de la création promotionnelle. Ignoré s'il est défini au niveau de l'élément.
`creative_slot`	`string`	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`promotion_id`	`string`	Non	P_12345	ID de la promotion associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`promotion_name`	`string`	Non	Soldes d'été	Nom de la promotion associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`items`	`Array<Item>`	Non		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`creative_name`	`string`	Non	summer_banner2	Nom de la création promotionnelle. Si ce paramètre est défini, le `creative_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `creative_name` au niveau de l'événement est utilisée, le cas échéant.
`creative_slot`	`string`	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'article. Si ce paramètre est défini, le `creative_slot` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `creative_slot` au niveau de l'événement est utilisée, le cas échéant.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`promotion_id`	`string`	Non	P_12345	ID de la promotion associée à l'article. Si ce paramètre est défini, le `promotion_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `promotion_id` au niveau de l'événement est utilisée, le cas échéant.
`promotion_name`	`string`	Non	Soldes d'été	Nom de la promotion associée à l'article. Si ce paramètre est défini, le `promotion_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `promotion_name` au niveau de l'événement est utilisée, le cas échéant.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 : {{ID de la promotion e-commerce}}
promotion_name : {{Nom de la promotion e-commerce}}
items : {{Ecommerce Items}}

Type de variable : variable de couche de données "ecommerce.items"
Déclencheur : événement "select_promotion"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : select_promotion
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`share`

Utilisez cet événement lorsqu'un utilisateur a partagé du contenu.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`method`	`string`	Non	Twitter	Méthode de partage du contenu.
`content_type`	`string`	Non	image	Type de contenu partagé.
`item_id`	`string`	Non	C_12345	ID du contenu partagé.

L'exemple suivant concerne les implémentations Tag Manager :

Exemple

`sign_up`

Cet événement indique qu'un utilisateur s'est inscrit à un compte. Utilisez cet événement pour comprendre les différents comportements des utilisateurs (qu'ils soient connectés ou non).

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`method`	`string`	Non	Google	Méthode utilisée pour l'inscription.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : sign_up
Paramètres d'événement (nom du paramètre – valeur) :

method - Google

Déclenchement lorsqu'un utilisateur s'est inscrit pour créer un compte

`spend_virtual_currency`

Cet événement mesure la vente de biens virtuels dans votre application et vous aide à identifier les biens virtuels les plus populaires.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`value`	`number`	Oui	5	Valeur de la devise virtuelle.
`virtual_currency_name`	`string`	Oui	Gems	Nom de la devise virtuelle.
`item_name`	`string`	Non	Boost de départ	Nom de l'article pour lequel la devise virtuelle est utilisée.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : spend_virtual_currency
Paramètres d'événement (nom du paramètre – valeur) :

value – 5
virtual_currency_name – Gems
item_name – Starter Boost

Déclencher lorsqu'un utilisateur achète un bien virtuel

`tutorial_begin`

Cet événement marque le début du processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_complete pour comprendre le nombre d'utilisateurs qui terminent le tutoriel.

Paramètres

Il n'existe aucun paramètre pour cet événement.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : tutorial_begin
Déclenchement lorsqu'un utilisateur commence le processus d'intégration

`tutorial_complete`

Cet événement indique que l'utilisateur a terminé votre processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_begin pour comprendre le nombre d'utilisateurs qui terminent le tutoriel.

Paramètres

Aucun paramètre n'est suggéré pour cet événement.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : tutorial_complete
Déclencher lorsqu'un utilisateur termine le processus d'intégration

`unlock_achievement`

Enregistrez cet événement lorsque l'utilisateur a débloqué une réussite. Cet événement peut vous aider à comprendre l'expérience des utilisateurs dans votre jeu.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`achievement_id`	`string`	Oui	A_12345	Identifiant du résultat obtenu.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : unlock_achievement
Paramètres d'événement (nom du paramètre – valeur) :

achievement_id – A_12345

Déclenchement lorsqu'un utilisateur a déverrouillé une réussite

`view_cart`

Cet événement indique qu'un utilisateur a consulté son panier.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}

Déclencheur : événement "view_cart"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : view_cart
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`view_item`

Cet événement indique qu'un contenu a été présenté à l'utilisateur. Utilisez cet événement pour découvrir les éléments les plus consultés.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * Définissez `value` sur la somme de `(price * quantity)` pour tous les éléments de `items`. N'incluez pas `shipping` ni `tax`. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 – {{Valeur e-commerce}}
currency : {{Ecommerce Currency}}

Déclencheur : événement "view_item"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : view_item
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`view_item_list`

Enregistrez cet événement lorsque l'utilisateur a vu une liste d'éléments d'une certaine catégorie.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. Les métriques de valeur de l'événement `view_item` ne contribuent pas aux revenus. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Ignoré s'il est défini au niveau de l'élément.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Ignoré s'il est défini au niveau de l'élément.
`items`	`Array<Item>`	Oui		Éléments de l'événement.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 : {{ID de la liste d'articles e-commerce}}
item_list_name : {{Ecommerce Item List Name}}

Déclencheur : événement "view_item_list"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : view_item_list
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      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",
      google_business_vertical: "retail",
      quantity: 2
    }]
  }
});

`view_promotion`

Cet événement indique qu'une promotion a été consultée à partir d'une liste.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`creative_name`	`string`	Non	summer_banner2	Nom de la création promotionnelle. Ignoré s'il est défini au niveau de l'élément.
`creative_slot`	`string`	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`promotion_id`	`string`	Non	P_12345	ID de la promotion associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`promotion_name`	`string`	Non	Soldes d'été	Nom de la promotion associée à l'événement. Ignoré s'il est défini au niveau de l'élément.
`items`	`Array<Item>`	Oui*		Éléments de l'événement. * Le tableau `items` doit comporter un seul élément, représentant l'article associé à la promotion. Si plusieurs éléments sont fournis, seul le premier élément de `items` sera utilisé.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
`item_id`	`string`	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`item_name`	`string`	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer `item_id` ou `item_name`.
`affiliation`	`string`	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : `affiliation` n'est disponible qu'au niveau de l'élément.
`coupon`	`string`	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres `coupon` au niveau de l'événement et de l'article sont indépendants.
`creative_name`	`string`	Non	summer_banner2	Nom de la création promotionnelle. Si ce paramètre est défini, le `creative_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `creative_name` au niveau de l'événement est utilisée, le cas échéant.
`creative_slot`	`string`	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'article. Si ce paramètre est défini, le `creative_slot` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `creative_slot` au niveau de l'événement est utilisée, le cas échéant.
`discount`	`number`	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
`index`	`number`	Non	5	Index/position de l'élément dans une liste.
`item_brand`	`string`	Non	Google	Marque de l'article.
`item_category`	`string`	Non	Habillement	Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
`item_category2`	`string`	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
`item_category3`	`string`	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
`item_category4`	`string`	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
`item_category5`	`string`	Non	Manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
`item_list_id`	`string`	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_id` au niveau de l'événement est utilisée, le cas échéant.
`item_list_name`	`string`	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce paramètre est défini, le `item_list_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `item_list_name` au niveau de l'événement est utilisée, le cas échéant.
`item_variant`	`string`	Non	vert	Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
`location_id`	`string`	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (l'identifiant Google Places pour San Francisco)	Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Remarque : `location id` n'est disponible qu'au niveau de l'élément.
`price`	`number`	Non	10,01	Prix unitaire de l'article (unité monétaire) dans l'unité du paramètre de devise spécifié. Si une remise s'applique à l'article, définissez `price` sur le prix unitaire remisé et spécifiez la remise sur le prix unitaire dans le paramètre `discount`.
`promotion_id`	`string`	Non	P_12345	ID de la promotion associée à l'article. Si ce paramètre est défini, le `promotion_id` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `promotion_id` au niveau de l'événement est utilisée, le cas échéant.
`promotion_name`	`string`	Non	Soldes d'été	Nom de la promotion associée à l'article. Si ce paramètre est défini, le `promotion_name` au niveau de l'événement est ignoré. Si ce paramètre n'est pas défini, la valeur `promotion_name` au niveau de l'événement est utilisée, le cas échéant.
`quantity`	`number`	Non	3	Quantité d'articles. Si elle n'est pas définie, `quantity` est définie sur 1.

En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : É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 : {{ID de la promotion e-commerce}}
promotion_name : {{Nom de la promotion e-commerce}}
items : {{Ecommerce Items}}

Déclencheur : événement "view_promotion"

Configuration du déclencheur :

Type de déclencheur : événement personnalisé
Nom de l'événement : view_promotion
Ce déclencheur est exécuté pour 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`working_lead`

Cet événement est enregistré lorsqu'un utilisateur contacte un représentant ou est contacté par un représentant.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
`currency`	`string`	Oui*	USD	Devise de la `value` de l'événement, au format ISO 4217 à trois lettres. * Si vous définissez `value`, `currency` est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
`value`	`number`	Oui*	30.03	Valeur monétaire de l'événement. * `value` est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir `value`. * `currency` est obligatoire si vous définissez `value`.
`lead_status`	`string`	Non	Conversations commencées	État du prospect.

Exemple

L'exemple suivant concerne les implémentations Tag Manager :

Affiche-moi la configuration de la balise

Configuration de la balise :

Type de balise : Événement GA4
Nom de l'événement : working_lead
Paramètres d'événement (nom du paramètre – valeur) :

currency – USD
value - 30.03
lead_status : conversations commencées

Déclenchez l'événement lorsqu'un utilisateur contacte un représentant ou est contacté par un représentant.

Événements recommandés Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

add_payment_info

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

add_shipping_info

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

add_to_cart

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

add_to_wishlist

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

begin_checkout

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

close_convert_lead

Paramètres

Exemple

Affiche-moi la configuration de la balise

close_unconvert_lead

Paramètres

Exemple

Affiche-moi la configuration de la balise

disqualify_lead

Paramètres

Exemple

Affiche-moi la configuration de la balise

earn_virtual_currency

Paramètres

Exemple

Affiche-moi la configuration de la balise

generate_lead

Paramètres

Exemple

Affiche-moi la configuration de la balise

join_group

Paramètres

Exemple

Affiche-moi la configuration de la balise

level_end

Paramètres

Exemple

Affiche-moi la configuration de la balise

level_start

Paramètres

Exemple

Affiche-moi la configuration de la balise

level_up

Paramètres

Exemple

Affiche-moi la configuration de la balise

login

Paramètres

Exemple

Affiche-moi la configuration de la balise

post_score

Paramètres

Exemple

Affiche-moi la configuration de la balise

purchase

Paramètres

Paramètres d'élément

Exemple

Affiche-moi la configuration de la balise

qualify_lead

Paramètres

Exemple

Affiche-moi la configuration de la balise

refund

Événements recommandés

`add_payment_info`

`add_shipping_info`

`add_to_cart`

`add_to_wishlist`

`begin_checkout`

`close_convert_lead`

`close_unconvert_lead`

`disqualify_lead`

`earn_virtual_currency`

`generate_lead`

`join_group`

`level_end`

`level_start`

`level_up`

`login`

`post_score`

`purchase`

`qualify_lead`

`refund`

`remove_from_cart`

`search`

`select_content`

`select_item`

`select_promotion`

`share`

`sign_up`

`spend_virtual_currency`

`tutorial_begin`

`tutorial_complete`

`unlock_achievement`

`view_cart`

`view_item`

`view_item_list`

`view_promotion`