Événements

add_payment_info

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
coupon string Non SUMMER_FUN Nom/code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
coupon string Non SUMMER_FUN Nom/code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
coupon string Non SUMMER_FUN Nom/code du bon de réduction associé à l'événement.

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

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 Summer_fun Nom utilisé pour identifier une promotion ou une campagne stratégique spécifiques.
source string Non google Source de trafic de la campagne (par exemple, Google, e-mail, etc.)
medium string Non cpc Support de la campagne (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 réseau de contenu afin de différencier les annonces ou liens qui renvoient vers la même URL.

Envoyer l'événement

Essayer 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 est comptabilisé lorsqu'un utilisateur reçoit de la monnaie virtuelle dans un jeu. Consignez ces informations ainsi 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ésors Nom de la devise virtuelle.
value number Non 5 Valeur de la devise virtuelle.

Envoyer l'événement

Essayer 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 évaluer l'efficacité de vos campagnes marketing et connaître le nombre de clients qui réengagent votre entreprise après avoir remarketé les clients.

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.

Envoyer l'événement

Essayer 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 de réseaux sociaux.

Paramètres

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

Envoyer l'événement

Essayer 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 qu'un 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 à atteindre.

Paramètres

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

Envoyer l'événement

Essayer 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 application.

Paramètres

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

Envoyer l'événement

Essayer 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 corréler les scores élevés avec les audiences ou les 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 qui a remporté le score.

Envoyer l'événement

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
transaction_id string Yes T_12345 Identifiant unique d'une transaction.

Le paramètre transaction_id vous permet d'éviter de recevoir des événements en double pour un achat.
coupon string Non SUMMER_FUN Nom/code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
transaction_id string Yes T_12345 Identifiant unique d'une transaction.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
coupon string Non SUMMER_FUN Nom/code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 30.03,
        "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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Consignez cet événement pour indiquer quand l'utilisateur a effectué une recherche. Vous pouvez utiliser cet événement pour identifier ce que les utilisateurs recherchent sur votre site Web ou dans votre application. Par exemple, vous pouvez l'envoyer 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 l'événement

Essayer 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 les catégories et les contenus populaires sur votre site Web ou dans 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 l'événement

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

Ignorée si elle est définie 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ée si elle est définie au niveau de l'article.
items Array<Item> Oui* Éléments de l'événement

* Le tableau items doit comporter un seul élément, représentant l'élément sélectionné. Si plusieurs éléments sont fournis, seul le premier élément de items 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 l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
creative_name string Non summer_banner2 Nom de la création promotionnelle.

Ignorée si elle est définie au niveau de l'article.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

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

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

Ignorée si elle est définie au niveau de l'article.
items Array<Item> Non Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 l'événement

Essayer 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 déconnectés.

Paramètres

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

Envoyer l'événement

Essayer 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 biens 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 devise virtuelle.
virtual_currency_name string Yes Trésors Nom de la devise virtuelle.
item_name string Non Booster de démarrage Nom de l'article pour lequel la devise virtuelle est utilisée.

Envoyer l'événement

Essayer 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 marque le début du processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_complete pour déterminer le nombre d'utilisateurs qui terminent le tutoriel.

Paramètres

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

Aucun paramètre pour cet événement.

Envoyer l'événement

Essayer 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 signifie que l'utilisateur a terminé votre processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_begin pour comprendre combien d'utilisateurs terminent le tutoriel.

Paramètres

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

Envoyer l'événement

Essayer 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é une réussite. Cet événement peut vous aider à comprendre l'expérience des utilisateurs avec votre jeu.

Paramètres

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

Envoyer l'événement

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

Cet événement signifie qu'une partie du contenu a été présentée à l'utilisateur. Utilisez cet événement pour découvrir les éléments les plus populaires consultés.

Paramètres

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

* Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est requis si vous définissez value.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

Consignez cet événement lorsque l'utilisateur reçoit une liste d'éléments d'une certaine catégorie.

Paramètres

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

Ignorée si elle est définie 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ée si elle est définie au niveau de l'article.
items Array<Item> Yes Éléments de l'événement

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
creative_name string Non summer_banner2 Nom de la création promotionnelle.

Ignorée si elle est définie au niveau de l'article.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.

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

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

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

Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 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 Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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 pour des détails/options supplémentaires sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, 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 : "location id" n'est disponible qu'au niveau de la portée article.
price number Non 10,01 Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, 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, le promotion_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity number Non 3

Quantité d'articles

Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

Essayer 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": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

Consignez cet événement lorsque les résultats d'une recherche ont été présentés à l'utilisateur. Notez que vous pouvez activer la collecte automatique de l'événement "view_search_results" grâce à la mesure améliorée des événements de Google Analytics.

Paramètres

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

Envoyer l'événement

Essayer 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"
      }
    }]
  })
});