Événements recommandés

Google Analytics envoie automatiquement certains types d'événements. Cette page décrit les événements facultatifs supplémentaires que vous pouvez configurer pour mesurer davantage de comportements et générer des rapports plus utiles pour votre entreprise. La configuration de ces événements supplémentaires avant de pouvoir les utiliser est plus complexe. 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 paiement 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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 Credit Card 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'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 - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
    • payment_type - &lbrace;&lbrace;Type de paiement d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à 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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

Cet événement indique qu'un utilisateur a envoyé ses informations de livraison lors d'un processus de paiement 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'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 - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
    • shipping_tier - &lbrace;&lbrace;Ecommerce Shipping Tier&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à 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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

Cet événement indique qu'un article a été ajouté à un 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est é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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

L'é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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est é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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

Cet événement signifie 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à begin_checkout

Configuration du déclencheur:

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

close_convert_lead

Cet événement mesure quand un prospect a été converti et clôturé (par exemple, via un achat).

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise de l'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 est destiné aux implémentations de Tag Manager:

Montrez-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éclencher l'événement lorsque l'utilisateur est devenu un prospect converti (un client)

close_unconvert_lead

Cet événement mesure le moment où un utilisateur est marqué comme ne devenant pas un prospect converti, ainsi que la raison.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise de l'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 est destiné aux implémentations de Tag Manager:

Montrez-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 ne devenant pas un prospect converti pour l'une des raisons suivantes :

disqualify_lead

Cet événement mesure le moment où un utilisateur est marqué comme non éligible à devenir un prospect, ainsi que la raison de cette exclusion.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise de l'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 prospect a été marqué comme non éligible.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 raisons suivantes :

earn_virtual_currency

Cet événement mesure le moment où un utilisateur reçoit de la monnaie virtuelle dans un jeu. Enregistrez-le avec spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

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

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 : gemmes
    • value - 5
  • Déclencher l'événement lorsqu'un utilisateur reçoit de la monnaie virtuelle

generate_lead

Cet événement mesure le moment où un prospect a été généré (par exemple, via un formulaire). Enregistrez-les pour comprendre l'efficacité de vos campagnes marketing et le nombre de clients qui réengagent votre entreprise après avoir été ciblés par le remarketing.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise de l'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 commercial Source du prospect.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 commercial
  • 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 est destiné aux implémentations de Tag Manager:

Montrez-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éclencher l'événement lorsqu'un utilisateur rejoint un groupe

level_end

Cet événement indique qu'un joueur a atteint la fin d'un niveau dans un jeu.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
level_name string Non Le voyage 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 est destiné aux implémentations de Tag Manager:

Montrez-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 atteint la fin d'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 Le voyage commence… Nom du niveau.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 signifie qu'un joueur a atteint 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 Personnage ayant gagné un niveau.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 à un 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

Montrez-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 se connecte

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 mettre en corrélation les scores élevés 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 est destiné aux implémentations de Tag Manager:

Montrez-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 indique qu'un ou plusieurs articles ont été achetés par 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.
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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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 transaction d'e-commerce : ecommerce.transaction_id
    • Valeur de l'e-commerce : ecommerce.value
    • Taxe sur l'e-commerce : ecommerce.tax
    • Livraison e-commerce : ecommerce.shipping
    • Devise d'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;ID de transaction d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Taxe sur l'e-commerce&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Livraison e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "purchase"

Configuration du déclencheur:

  • Type de déclencheur: événement personnalisé
  • Nom de l'événement: purchase
  • Ce déclencheur s'exécute dans les conditions suivantes: 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",
    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 l'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 est destiné aux implémentations de Tag Manager:

Montrez-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 indique qu'un ou plusieurs articles ont été 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • ID de transaction d'e-commerce : ecommerce.transaction_id
    • Valeur de l'e-commerce : ecommerce.value
    • Taxe sur l'e-commerce : ecommerce.tax
    • Livraison e-commerce : ecommerce.shipping
    • Devise d'e-commerce : ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;ID de transaction d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Taxe sur l'e-commerce&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Livraison e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement correspond au remboursement

Configuration du déclencheur:

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

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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

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

Montrez-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 est destiné aux implémentations de Tag Manager:

Montrez-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 signifie 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 dans 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 est destiné aux implémentations de Tag Manager:

Montrez-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: l'événement est égal à "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é si défini au niveau de l'article.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré si défini au niveau de l'article.
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 est utilisé.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui* SKU_12345

Identifiant de l'article.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • ID de la liste d'articles d'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 - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • item_list_id : &lbrace;&lbrace;ID de la liste d'articles d'e-commerce&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Nom de la liste d'articles d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "select_item"

Configuration du déclencheur:

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

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é si défini au niveau de l'article.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

Ignoré si défini au niveau de l'article.
promotion_id string Non P_12345 ID de la promotion associée à l'événement.

Ignoré si défini au niveau de l'article.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'événement.

Ignoré si défini au niveau de l'article.
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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 défini, creative_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si défini, creative_slot au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 défini, promotion_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'article.

Si défini, promotion_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, promotion_name au niveau de l'événement est utilisé, 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 est destiné aux implémentations de Tag Manager:

Montrez-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 création pour l'e-commerce : ecommerce.creative_name
    • Emplacement de la création d'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 - &lbrace;&lbrace;Nom de la création d'e-commerce&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;ID de la promotion d'e-commerce&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Nom de la promotion d'e-commerce&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
  • Type de variable: variable de couche de données - "ecommerce.items"
  • Déclencheur: l'événement est égal à "select_promotion"

Configuration du déclencheur:

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

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 est destiné aux implémentations de Tag Manager:

Montrez-moi la configuration de la balise

Configuration de la balise:

  • Type de balise: événement GA4
  • Nom de l'événement: share
  • Paramètres d'événement (nom du paramètre - valeur):
    • method – Twitter
    • content_type : image
    • item_id - C_12345
  • Déclenchement lorsqu'un utilisateur a partagé du contenu

Exemple

Montrez-moi la configuration de la balise

Configuration de la balise:

  • Type de balise: événement GA4
  • Nom de l'événement: share
  • Paramètres d'événement (nom du paramètre - valeur):
    • method – Twitter
    • content_type : image
    • item_id - C_12345
  • Déclenchement lorsqu'un utilisateur a partagé du contenu

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.

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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

spend_virtual_currency

Cet événement mesure la vente de produits virtuels dans votre application et vous aide à identifier les produits 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 Gemmes Nom de la devise virtuelle.
item_name string Non Starter Boost Nom de l'élément pour lequel la devise virtuelle est utilisée.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 : gemmes
    • item_name : boost de démarrage
  • 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 connaître le nombre d'utilisateurs qui ont suivi le tutoriel.

Paramètres

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

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 combien d'utilisateurs terminent le tutoriel.

Paramètres

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

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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é un succès. Cet événement peut vous aider à comprendre comment les utilisateurs vivent 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 est destiné aux implémentations de Tag Manager:

Montrez-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ébloqué un succès

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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "view_cart"

Configuration du déclencheur:

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

view_item

Cet événement signifie qu'un contenu a été présenté à l'utilisateur. Utilisez cet événement pour découvrir les éléments les plus populaires 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.

Métriques de valeur sur l'événement view_item pour qu'elles 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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • Valeur de l'e-commerce : ecommerce.value
    • Devise d'e-commerce : ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Devise d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "view_item"

Configuration du déclencheur:

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

view_item_list

Enregistrez cet événement lorsqu'une liste d'éléments d'une certaine catégorie est présentée à l'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.

Métriques de valeur sur l'événement view_item pour qu'elles 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é si défini au niveau de l'article.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré si défini au niveau de l'article.
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.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 est destiné aux implémentations de Tag Manager:

Montrez-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):
    • Éléments d'e-commerce : ecommerce.items
    • ID de la liste d'articles d'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 - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • item_list_id : &lbrace;&lbrace;ID de la liste d'articles d'e-commerce&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Nom de la liste d'articles d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "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 s'exécute dans les conditions suivantes: Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

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é si défini au niveau de l'article.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

Ignoré si défini au niveau de l'article.
promotion_id string Non P_12345 ID de la promotion associée à l'événement.

Ignoré si défini au niveau de l'article.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'événement.

Ignoré si défini au niveau de l'article.
items Array<Item> Oui* Éléments de l'événement.

* Le tableau items doit contenir un seul élément, représentant l'élément associé à la promotion. Si plusieurs éléments sont fournis, seul le premier élément de items est utilisé.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui* SKU_12345

Identifiant de l'article.

*L'une des valeurs item_id ou item_name est requise.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*L'une des valeurs item_id ou item_name est requise.

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'étendue 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 défini, creative_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si défini, creative_slot au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Indice/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 défini, item_list_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_id au niveau de l'événement est utilisé, 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 défini, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, item_list_name au niveau de l'événement est utilisé, 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 (ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "location id" n'est disponible qu'au niveau de l'étendue de l'élément.
price number Non 10,01 Prix de l'article en unités monétaires, dans les unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit 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 défini, promotion_id au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'article.

Si défini, promotion_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, promotion_name au niveau de l'événement est utilisé, 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 est destiné aux implémentations de Tag Manager:

Montrez-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 création pour l'e-commerce : ecommerce.creative_name
    • Emplacement de la création d'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 - &lbrace;&lbrace;Nom de la création d'e-commerce&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;ID de la promotion d'e-commerce&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Nom de la promotion d'e-commerce&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
  • Déclencheur: l'événement est égal à "view_promotion"

Configuration du déclencheur:

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

working_lead

Cet événement mesure le moment où un utilisateur contacte un représentant ou est contacté par celui-ci.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise de l'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 démarrées État du prospect.

Exemple

L'exemple suivant est destiné aux implémentations de Tag Manager:

Montrez-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 démarrées
  • Déclenchez l'événement lorsqu'un utilisateur contacte un représentant ou est contacté par celui-ci.