Événements

ad_impression

Utilisez cet événement lorsqu'un utilisateur voit une impression d'annonce.

  • Un ad_impression envoyé à l'aide du protocole de mesure ne sera pas inclus dans les exportations vers d'autres plates-formes publicitaires telles que Google Ads.
  • L'envoi d'événements ad_impression à l'aide du protocole de mesure peut entraîner des impressions en double si vous avez configuré le taggage ou le SDK pour vos produits publicitaires Google associés. N'envoyez un événement ad_impression à l'aide du protocole de mesure que si l'événement n'a pas été capturé par le taggage ou le SDK.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
ad_platform string Non MoPub Plate-forme publicitaire
ad_source string Non AdColony Source de l'annonce.
ad_format string Non Bannière Format d'annonce.
ad_unit_name string Non Banner_03 Nom du bloc d'annonces.
currency string Non USD Devise des articles associés à l'événement, au format ISO 4217 à trois lettres.

* Si vous définissez value, currency est requis pour que les métriques sur les revenus soient calculées avec précision.
value number Non 3,99 EUR
Valeur de l'impression d'annonce.
* value est généralement obligatoire pour générer des rapports pertinents.
* currency est obligatoire 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":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

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

Paramètres

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 fourni ses informations de livraison lors d'un processus de règlement d'e-commerce.

Paramètres

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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é à un panier pour l'acheter.

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

Paramètres

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 les détails de la campagne qui seront appliqués aux événements futurs.

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 Le support de la campagne (par exemple, e-mail, coût par clic, etc.)
term string Non ete+voyage Terme de campagne utilisé avec la recherche sponsorisée pour fournir les mots clés des annonces.
content string Non logolink Contenu de la campagne utilisé pour les tests A/B et les annonces ciblées sur le contenu afin de différencier les annonces ou les liens qui 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"
      }
    }]
  })
});

close_convert_lead

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

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": "close_convert_lead",
      "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
          }
        ]
      }
    }]
  })
});

close_unconvert_lead

Cet événement mesure le moment où un utilisateur est marqué comme ne menant pas à un prospect converti, ainsi que le motif de la conversion.

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
unconvert_lead_reason string Non Sans réponse Raison pour laquelle le prospect n'a pas généré de conversion.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded",
        "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
          }
        ]
      }
    }]
  })
});

disqualify_lead

Cet événement est enregistré lorsqu'un utilisateur est marqué comme disqualifié pour devenir un prospect, ainsi que le motif de sa disqualification.

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
disqualified_lead_reason string Non Je ne cherche pas à acheter Raison pour laquelle un prospect a été marqué comme disqualifié.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy",
        "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
          }
        ]
      }
    }]
  })
});

earn_virtual_currency

Cet événement est enregistré lorsqu'un utilisateur obtient de la monnaie virtuelle dans un jeu. Consignez ceci avec spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

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

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 données pour évaluer l'efficacité de vos campagnes marketing et déterminer combien de clients réengagent avec votre entreprise après le remarketing.

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
lead_source string Non Salon commercial Source du prospect.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": 30.03,
        "lead_source": "Trade show",
        "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
          }
        ]
      }
    }]
  })
});

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
group_id string Non G_12345 ID 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 au cours d'un jeu. Utilisez-le pour évaluer la répartition des niveaux de votre base d'utilisateurs et identifier les niveaux difficiles à terminer.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
level number Non 5 Niveau du personnage.
character string Non Joueur 1 Le personnage qui 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 à votre 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 mettre en corrélation les meilleurs scores avec les audiences ou les comportements.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
score number Oui 10000 Score à publier.
level number Non 5 Niveau du score.
character string Non Joueur 1 Personnage qui a obtenu 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 utilisateur achète un ou plusieurs articles.

Paramètres

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

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

qualify_lead

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

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": "qualify_lead",
      "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
          }
        ]
      }
    }]
  })
});

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 requis pour que les métriques sur les revenus soient calculées avec précision.
transaction_id string Oui T_12345 Identifiant unique d'une transaction.
value number Oui* 30,03 Valeur monétaire de l'événement.

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

Paramètres

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

screen_view

Utilisez cet événement pour indiquer qu'une transition d'écran s'est produite.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
screen_class string Non MainActivity Classe de l'écran.
screen_name string Non À propos Nom de l'écran.

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": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
search_term string Oui 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é du contenu d'un certain type. Cet événement peut vous aider à identifier des catégories et des contenus populaires sur votre site Web ou dans votre application.

Paramètres

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

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

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

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

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Non Éléments 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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

partage

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 s'est inscrit à un compte. Utilisez cet événement pour comprendre les différents comportements des utilisateurs connectés et non connectés.

Paramètres

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

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 les produits virtuels les plus populaires.

Paramètres

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

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 indique le début du processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_complete pour déterminer combien d'utilisateurs ont suivi le tutoriel.

Paramètres

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

Aucun paramètre n'est associé à 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 déterminer combien d'utilisateurs ont suivi 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

Consigner cet événement lorsque l'utilisateur a déverrouillé une réussite. Cet événement peut vous aider à comprendre comment les utilisateurs perçoivent votre jeu.

Paramètres

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

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 requis pour que les métriques sur les revenus soient calculées avec précision.
value number Oui* 30,03 Valeur monétaire de l'événement.

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 articles les plus consultés.

Paramètres

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

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

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

Paramètres d'élément

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

Identifiant de l'article.

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

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 a vu une liste d'éléments d'une certaine catégorie.

Paramètres

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

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

Ignoré s'il est défini au niveau de l'article.
items Array<Item> Oui Éléments 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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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 dans une liste.

Paramètres

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

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

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

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

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

* Le tableau items ne doit comporter qu'un seul élément, représentant l'article associé à la promotion. Si plusieurs éléments sont fournis, seul le premier élément dans 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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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

Consigne cet événement lorsque les résultats d'une recherche sont présentés à l'utilisateur. Notez que vous pouvez activer la collecte automatique de l'événement "view_search_results" via la mesure améliorée des événements dans Google Analytics.

Paramètres

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

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

working_lead

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

Paramètres

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

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

* Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
lead_status string Non Conversations en cours État du prospect.
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 renseigner l'une des colonnes "item_id" ou "item_name".

item_name string Oui* T-shirt Stan et ses amis

Nom de l'article.

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

affiliation string Non Google Store Affiliation de produit pour désigner l'entreprise qui l'a fournie ou l'adresse du magasin physique.
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 cette règle est définie, la valeur creative_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associé à l'article.

Si cette règle est définie, la valeur creative_slot au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur creative_slot au niveau de l'événement est utilisée, 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'agira de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non À manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

Si cette règle est définie, la valeur item_list_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_id au niveau de l'événement est utilisée, 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 cette règle est définie, la valeur item_list_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code unique ou description donnant plus de détails/options sur l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Un ID de zone géographique personnalisé peut également être utilisé.
Remarque : "ID de zone géographique" n'est disponible qu'au niveau de l'article.
price number Non 10,01 Prix unitaire monétaire de l'article, en unités du paramètre de devise spécifié.
Si une remise s'applique à l'article, définissez price sur le prix unitaire réduit et spécifiez la remise dans le paramètre discount.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_id au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_id au niveau de l'événement est utilisée, le cas échéant.
promotion_name string Non Promotion d'été Nom de la promotion associée à l'article.

Si cette règle est définie, la valeur promotion_name au niveau de l'événement est ignorée.
Si cette règle n'est pas configurée, la valeur promotion_name au niveau de l'événement est utilisée, le cas échéant.
quantity number Non 3

Quantité d'articles.

Si cette règle n'est pas configurée, quantity est défini sur 1.

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

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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations",
        "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
          }
        ]
      }
    }]
  })
});