Événements

add_payment_info

Cet événement signifie qu'un utilisateur a envoyé ses informations de paiement via un processus de règlement 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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN_FUN Nom/code du bon de réduction associé à l'événement.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
payment_type string Non Credit Card Mode de paiement choisi.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "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",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_shipping_info

Cet événement signifie qu'un utilisateur a envoyé ses informations de livraison lors du règlement 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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN_FUN Nom/code du bon de réduction associé à l'événement.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping_tier string Non Rez-de-chaussée Niveau de livraison (Ground, Air ou Next-day, par exemple) sélectionné pour la livraison de l'article acheté.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Paramètres

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

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

begin_checkout

Cet événement signifie qu'un utilisateur a commencé le règlement.

Paramètres

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

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN_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> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

détails_campagne

Utilisez cet événement pour envoyer des informations sur la campagne qui seront appliquées aux futurs événements.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
campaign_id string Non google_1234 ID de la campagne.
campaign string Non Promos_estivales Nom utilisé pour identifier une promotion ou une campagne stratégique spécifique.
source string Non google Source du trafic de la campagne (par exemple, Google, e-mail, etc.).
medium string Non cpc Support de la campagne (par exemple, e-mail, coût par clic, etc.)
term string Non ete+voyage Terme de campagne utilisé avec la recherche sponsorisée pour fournir les mots clés des annonces.
content string Non logolink Contenu de la campagne utilisé pour les tests A/B et les annonces ciblées sur le contenu afin de différencier les annonces ou les liens qui redirigent vers la même URL.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

earn_virtual_currency

Cet événement mesure le moment où un utilisateur reçoit une monnaie virtuelle dans un jeu. Enregistrez ce montant en même temps que spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
virtual_currency_name string Non Trésor Nom de la devise virtuelle.
value number Non 5 Valeur de la monnaie virtuelle.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

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

Paramètres

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

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 99.99
      }
    }]
  })
});

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 pour analyser la popularité de certains groupes ou de certaines fonctionnalités sur les réseaux sociaux.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

Cet événement signifie que le joueur est passé au niveau supérieur dans un jeu. Utilisez-la pour évaluer la répartition des niveaux de votre base d'utilisateurs et identifier les niveaux difficiles à compléter.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

connexion

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.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

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 faire le lien entre les scores élevés et les audiences ou comportements.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

purchase

Cet événement signifie qu'un ou plusieurs articles sont achetés par 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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
transaction_id string Yes T_12345 Identifiant unique d'une transaction.

Le paramètre transaction_id vous permet d'éviter d'obtenir des événements en double pour un achat.
value number Oui* 12.21 Valeur monétaire de l'événement.

* value est obligatoire pour créer des rapports pertinents et renseigner l'audience prédictive acheteurs.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN_FUN Nom/code du bon de réduction associé à l'événement.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Coût des taxes associés à une transaction.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 12.21,
        "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",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
transaction_id string Yes T_12345 Identifiant unique d'une transaction.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN_FUN Nom/code du bon de réduction associé à l'événement.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Coût des taxes associés à une transaction.
items Array<Item> Non* Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 12.21,
        "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",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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. Par exemple, vous pouvez envoyer cet événement lorsqu'un utilisateur consulte une page de résultats de recherche après avoir effectué une recherche.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
search_term string Yes T-shirts Terme recherché.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Cet événement signifie qu'un utilisateur a sélectionné un certain type de contenu. Cet événement peut vous aider à identifier le contenu populaire et les catégories de contenu de votre site Web ou de votre application.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré s'il est défini au niveau de l'article.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Oui* Éléments associés à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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 bannière_été2 Nom de la création promotionnelle.

Ignoré s'il est défini au niveau de l'article.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Non Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

partager

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Cet événement indique qu'un utilisateur a créé 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 d'inscription utilisée.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
value number Yes 5 Valeur de la monnaie virtuelle.
virtual_currency_name string Yes Trésor Nom de la devise virtuelle.
item_name string Non Boost Starter Nom de l'article pour lequel la monnaie virtuelle est utilisée.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Cet événement correspond au début du processus d'intégration. Utilisez cette valeur dans un entonnoir avec tutorial_complete pour connaître le nombre d'utilisateurs ayant terminé le tutoriel.

Paramètres

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

Aucun paramètre pour cet événement.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

Cet événement indique que l'utilisateur a terminé le processus d'intégration. Utilisez cette valeur dans un entonnoir avec tutorial_begin pour déterminer le nombre d'utilisateurs qui ont terminé le tutoriel.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

Consignez cet événement lorsque l'utilisateur a déverrouillé un succès. Cet événement peut vous aider à comprendre l'expérience des utilisateurs dans votre jeu.

Paramètres

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

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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 articles 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 ISO 4217 à trois lettres.

* Si vous définissez value, currency est nécessaire pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 7,77 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 que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré s'il est défini au niveau de l'article.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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",
            "currency": "USD",
            "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

Cet événement signifie qu'une promotion a été vue depuis une liste.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Ignoré s'il est défini au niveau de l'article.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'événement.

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Oui* Éléments associés à l'événement.

* Le tableau items ne doit comporter qu'un seul élément, qui représente l'élément associé à la promotion. Si plusieurs éléments sont fournis, seul le premier élément de items sera utilisé.

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau de l'article.
coupon string Non ÉTÉ_FUN_FUN Nom/Code du bon de réduction associé à l'article.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name string Non bannière_été2 Nom de la création promotionnelle.

Si ce champ est défini, creative_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot string Non application_sélectionnée1 Nom de l'emplacement de la création promotionnelle associée à l'élément.

Si ce champ est défini, creative_slot est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire 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 fait partie d'une hiérarchie de catégories ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts 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 produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name string Non Produits associés Nom de la liste dans laquelle l'article a été présenté à l'utilisateur

Si ce champ est défini, item_list_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place pour San Francisco) Adresse physique associée à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé.
Remarque: L'attribut "location_id" n'est disponible qu'au niveau de l'article.
price number Non 9,99 EUR Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, promotion_id est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si ce champ est défini, promotion_name est ignoré au niveau de l'événement.
Si ce champ n'est pas défini, l'élément promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 1

Quantité d'articles

Si aucune valeur n'est spécifiée, quantity est défini sur 1.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

Consignez cet événement lorsque l'utilisateur a vu les résultats d'une recherche. Notez que vous pouvez activer l'événement view_search_results pour la collecte automatique via la mesure améliorée des événements dans Google Analytics.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
search_term string Non Vêtements Terme utilisé pour la recherche.

Envoyer un événement

Essayez cet événement dans l'outil de création d'événements GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});