Événements recommandés

Google Analytics envoie certains types d'événements automatiquement. 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 façon dont pour configurer des événements recommandés et personnalisés pour votre site Web ou votre application, consultez la section Configurer événements.

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

traduction: désactivée

add_payment_info

Cet événement signifie qu'un utilisateur a envoyé ses informations de paiement dans un processus de paiement en ligne.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est obligatoire pour que les métriques sur les 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 en tant qu'é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 sont indépendantes les unes des autres.
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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: add_payment_info
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
    • Coupon d'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 de l'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
  • Conditions dans lesquelles le déclencheur est exécuté : Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

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 éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer 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 sont indépendantes les unes des autres.
shipping_tier string Non Rez-de-chaussée Niveau de livraison (par exemple, Ground, Air, Next-day) 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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. 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 des balises:

  • Type de balise : événement GA4
  • Nom de l'événement: add_shipping_info
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
    • Coupon d'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;Niveau de livraison de l'e-commerce&rbrace;&rbrace;
  • Déclencheur: événement est égal(e) à add_shipping_info

Configuration du déclencheur:

  • Type de déclencheur: Événement personnalisé
  • Nom de l'événement: add_shipping_info
  • Ce déclencheur est exécuté sur: 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 signifie qu'un article a été ajouté à un panier pour l'acheter.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: add_to_cart
  • Variables de couche de données (nom) :
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value : &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency : &lbrace;&lbrace;Devise de l'e-commerce&rbrace;&rbrace;
  • Déclencheur: événement est égal(e) à add_to_cart

Configuration du déclencheur:

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

add_to_wishlist

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* 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 en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement : add_to_wishlist
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &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 est exécuté sur: 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é un processus de paiement.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. 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 des balises:

  • Type de balise : événement GA4
  • Nom de l'événement: begin_checkout
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &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: événement est égal(e) àbegin_checkout

Configuration du déclencheur :

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

close_convert_lead

Cet événement mesure le moment où un prospect a été converti et clôturé (par exemple, lors d'un achat).

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise du value de l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer 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 des balises:

  • 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 est enregistré lorsqu'un utilisateur est marqué comme n'étant pas en train de convertir un prospect. 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 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'événement clé, nous vous recommandons de définir value
currency est obligatoire si vous définissez value.
unconvert_lead_reason string Non Sans réponse 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 des balises:

  • 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 est mesuré lorsqu'un utilisateur est marqué comme disqualifié pour devenir un prospect. ainsi que le motif de la disqualification.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise du value de l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 disqualifié.

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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 - Je ne cherche pas à acheter
  • Déclencher l'événement lorsqu'un utilisateur est marqué comme disqualifié pour devenir un prospect pour l'une des nombreuses raisons

earn_virtual_currency

Cet événement est enregistré lorsqu'un utilisateur obtient de la monnaie virtuelle dans un jeu. Consignez-les avec spend_virtual_currency pour mieux comprendre l'é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 des balises:

  • 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'une personne obtient de la monnaie virtuelle

generate_lead

Cet événement est enregistré lorsqu'un prospect a été généré (par exemple, formulaire). Consignez ces données pour évaluer l'efficacité de vos campagnes marketing le nombre de clients qui s'intéressent de nouveau à votre entreprise après avoir procédé au remarketing clients.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise du value de l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer 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 des balises:

  • 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

Consignez cet événement lorsqu'un utilisateur rejoint un groupe, tel qu'une guilde, une équipe ou une famille. Utilisez cet événement afin d'analyser la popularité de certains groupes ou fonctionnalités sociales.

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 des balises:

  • 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 signifie 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 bien été terminé.

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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...
    • succès - true
  • Déclencher lorsqu'un joueur a atteint la fin d'un niveau (par exemple, sur la page de confirmation d'un niveau)

level_start

Cet événement signifie 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 des balises:

  • 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éclencher lorsqu'un utilisateur commence un nouveau niveau (par exemple, sur la page d'accueil des niveaux)

level_up

Cet événement signifie qu'un joueur est passé au niveau supérieur au cours d'un jeu. Utilisez-le pour évaluer les différents niveaux de votre base d'utilisateurs et d'identifier ceux qui sont difficiles à terminé.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
level number Non 5 Niveau du personnage.
character string Non Joueur 1 Le personnage qui est passé au niveau supérieur.

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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éclencher lorsqu'un joueur passe au niveau supérieur

login

Envoyez cet événement pour indiquer qu'un utilisateur s'est connecté à votre site Web ou à votre 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 des balises:

  • 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éclencher lorsqu'un utilisateur s'est connecté

post_score

Envoyez cet événement lorsque l'utilisateur publie un score. Utilisez cet événement pour comprendre les performances des utilisateurs dans votre jeu et 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 qui a obtenu le score.

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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éclencher lorsque l'utilisateur publie un score

purchase

Cet événement signifie qu'un utilisateur achète un ou plusieurs articles.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer 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 sont indépendantes les unes des autres.
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Taxe associée à 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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: purchase
    • Articles d'e-commerce – ecommerce.items
    • ID de la transaction d'e-commerce – ecommerce.transaction_id
    • Valeur e-commerce – ecommerce.value
    • Taxe sur l'e-commerce – ecommerce.tax
    • Livraison en ligne – ecommerce.shipping
    • Devise de l'e-commerce – ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • transaction_id : &lbrace;&lbrace;ID de la transaction d'e-commerce&rbrace;&rbrace;
    • value : &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • tax : &lbrace;&lbrace;Taxe de commerce électronique&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Livraison e-commerce&rbrace;&rbrace;
    • currency : &lbrace;&lbrace;Devise de l'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
  • Déclencheur: événement est égal à achat

Configuration du déclencheur:

  • Type de déclencheur: Événement personnalisé
  • Nom de l'événement: purchase
  • Conditions dans lesquelles le déclencheur est exécuté : Tous les événements personnalisés
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    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 remplissant les critères un prospect qualifié.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise du value de l'événement, au format 3 lettres format ISO 4217.

* 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 des balises:

  • 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éclencher l'événement lorsqu'un utilisateur est marqué comme remplissant les critères pour devenir un prospect qualifié

refund

Cet événement signifie qu'un ou plusieurs articles sont remboursés à un utilisateur.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 sont indépendantes les unes des autres.
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Taxe associée à 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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: refund
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • ID de la transaction d'e-commerce – ecommerce.transaction_id
    • Valeur e-commerce – ecommerce.value
    • Taxe sur l'e-commerce – ecommerce.tax
    • Livraison en ligne – ecommerce.shipping
    • Devise de l'e-commerce – ecommerce.currency
    • Coupon pour l'e-commerce : ecommerce.coupon
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • transaction_id : &lbrace;&lbrace;ID de la transaction d'e-commerce&rbrace;&rbrace;
    • value : &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • tax : &lbrace;&lbrace;Taxe de commerce électronique&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Livraison e-commerce&rbrace;&rbrace;
    • currency : &lbrace;&lbrace;Devise de l'e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Coupon d'e-commerce&rbrace;&rbrace;
  • Déclencheur: événement est égal à remboursement

Configuration du déclencheur :

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement: refund
  • Ce déclencheur s'exécute sur: 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 signifie qu'un article a été supprimé du 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.

* Si vous définissez value, currency est obligatoire pour que les métriques sur les 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

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

Consignez 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. Pour Par exemple, vous pouvez envoyer cet événement lorsqu'un utilisateur consulte une page de résultats de recherche après lors d'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 des balises:

  • 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 des balises:

  • 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éclencher 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: select_content
  • Paramètres d'événement (nom du paramètre - valeur):
    • content_type - produit
    • content_id - C_12345
  • Déclencheur: événement est égal(e) à select_content

select_item

Cet événement signifie 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'élément.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

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

* Le tableau items ne doit comporter qu'un seul représentant l'élément sélectionné. Si plusieurs éléments sont fourni, seul le premier élément de items sera utilisé.

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement : select_item
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • ID de la liste des 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: événement est égal(e) à select_item

Configuration du déclencheur:

  • Type de déclencheur : événement personnalisé
  • Nom de l'événement : select_item
  • Ce déclencheur est exécuté sur: 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 signifie 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'élément.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à .

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
creative_name string Non summer_banner2 Nom de la création promotionnelle.

Si cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée. actuellement.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à élément.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée. actuellement.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
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 cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée. actuellement.
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 des balises:

  • Type de balise: Événement GA4
  • Variables de couche de données (nom) :
    • Nom de la création d'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
    • Articles 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;Emplacement de création d'e-commerce&rbrace;&rbrace;
    • promotion_id : &lbrace;&lbrace;identifiant 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: événement est égal(e) à 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 sur: 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 concerne les intégrations Tag Manager:

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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éclencher lorsqu'un utilisateur a partagé du contenu

Exemple

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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 connectés et non connectés.

Paramètres

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

L'exemple suivant concerne les intégrations Tag Manager:

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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éclencher lorsqu'un utilisateur crée un compte

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • 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éclencher lorsqu'un utilisateur crée un compte

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 Booster de démarrage 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 des balises:

  • 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 : quiz de démarrage
  • Déclencher lorsqu'un utilisateur achète un bien virtuel

tutorial_begin

Cet événement indique le début du processus d'intégration. Utiliser dans un entonnoir avec tutorial_complete pour déterminer combien d'utilisateurs ont terminé le tutoriel.

Paramètres

Aucun paramètre n'est associé à cet événement.

Exemple

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

Montrez-moi la configuration de la balise

Configuration des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement : tutorial_begin
  • Déclencher lorsque quelqu'un commence le processus d'intégration

tutorial_complete

Cet événement signifie que l'utilisateur a terminé votre processus d'intégration. Utiliser ceci dans un entonnoir avec tutorial_begin pour connaître le nombre d'utilisateurs qui terminent 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 des balises:

  • 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

Consigner cet événement lorsque l'utilisateur a déverrouillé une réussite. Cet événement peut vous aider pour comprendre comment les utilisateurs perçoivent 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: unlock_achievement
  • Paramètres d'événement (nom du paramètre - valeur):
    • achievement_id - A_12345
  • Déclenchement lorsqu'un utilisateur a déverrouillé un succès

view_cart

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise des éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: view_cart
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &lbrace;&lbrace;Articles d'e-commerce&rbrace;&rbrace;
    • value : &lbrace;&lbrace;Valeur de l'e-commerce&rbrace;&rbrace;
    • currency : &lbrace;&lbrace;Devise de l'e-commerce&rbrace;&rbrace;
  • Déclencheur: événement est égal(e) à view_cart

Configuration du déclencheur:

  • Type de déclencheur: Événement personnalisé
  • Nom de l'événement: view_cart
  • Ce déclencheur est exécuté sur: 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'une partie du contenu a été présentée à 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 éléments associés à l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise: Événement GA4
  • Nom de l'événement: view_item
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • Valeur e-commerce – ecommerce.value
    • Devise de l'e-commerce – ecommerce.currency
  • Paramètres d'événement (nom du paramètre - valeur):
    • items - &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: événement est égal(e) à view_item

Configuration du déclencheur:

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

view_item_list

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

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'élément.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré 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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Un lieu personnalisé Un ID peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • Type de balise : événement GA4
  • Nom de l'événement: view_item_list
  • Variables de couche de données (nom - nom de la variable de couche de données):
    • Articles d'e-commerce – ecommerce.items
    • ID de la liste des 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: événement est égal(e) à 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 sur: 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'élément.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à .

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

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

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

* Le tableau items ne doit comporter qu'un seul , représentant l'article 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 et ses amis

Nom de l'article.

*Vous devez renseigner l'une des colonnes "item_id" ou "item_name".

affiliation string Non Google Store Une affiliation de produit pour désigner l'entreprise qui fournit la fourniture l'adresse du magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
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 sont indépendantes les unes des autres.
creative_name string Non summer_banner2 Nom de la création promotionnelle.

Si cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée. actuellement.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à élément.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée. actuellement.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans le cadre d'une hiérarchie de catégories ou classification, il s'agira 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 cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée. actuellement.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée. actuellement.
item_variant string Non vert Variante de l'article, ou code unique ou description d'un article supplémentaire détails/options.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, son l'emplacement de votre magasin). Nous vous recommandons d'utiliser la Google ID de lieu correspondant à l'élément associé. Un lieu personnalisé Un ID peut également être utilisé.
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, indiquez le prix unitaire après remise dans price. Spécifiez la remise sur le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
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 cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée. actuellement.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini 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 des balises:

  • 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 d'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
    • Articles 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;Emplacement de création d'e-commerce&rbrace;&rbrace;
    • promotion_id : &lbrace;&lbrace;identifiant 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: événement est égal(e) à 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 sur: 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 est enregistré lorsqu'un utilisateur contacte un représentant ou est contacté par un représentant.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
currency string Oui* USD Devise du value de l'événement, au format 3 lettres format ISO 4217.

* Si vous définissez value, currency est 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 obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant qu'é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 des balises:

  • 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éclencher l'événement lorsqu'un utilisateur contacte un représentant