Événements

ad_impression

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

• Les ad_impression envoyés à l'aide du protocole de mesure ne seront 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 s'il n'a pas été capturé via 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 de l'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 alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Non	3,99 EUR	Valeur de l'impression d'annonce. * value est généralement requis pour créer des rapports pertinents. * currency est requis si vous définissez value.

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"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 dans un processus de règlement d'e-commerce.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
payment_type	string	Non	Credit Card	Le mode de paiement choisi.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping_tier	string	Non	Rez-de-chaussée	Niveau de livraison (par exemple, Ground, Air, Next-day) sélectionné pour la livraison de l'article acheté.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

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

Paramètres

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

Envoyer l'événement

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

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

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

earn_virtual_currency

Cet événement est comptabilisé lorsqu'un utilisateur reçoit de la monnaie virtuelle dans un jeu. Consignez ces informations ainsi que spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
virtual_currency_name	string	Non	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 informations pour évaluer l'efficacité de vos campagnes marketing et connaître le nombre de clients qui réengagent votre entreprise après avoir remarketé les clients.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.

Envoyer l'événement

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

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

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

join_group

Consignez cet événement lorsqu'un utilisateur rejoint un groupe tel qu'une guilde, une équipe ou une famille. Utilisez cet événement pour analyser la popularité de certains groupes ou de certaines fonctionnalités de réseaux sociaux.

Paramètres

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

Envoyer l'événement

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

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

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

level_up

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

Paramètres

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

Envoyer l'événement

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

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

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

connexion

Envoyez cet événement pour indiquer qu'un utilisateur s'est connecté à votre site Web ou application.

Paramètres

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

Envoyer l'événement

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

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

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

post_score

Envoyez cet événement lorsque l'utilisateur publie un score. Utilisez cet événement pour comprendre les performances des utilisateurs dans votre jeu et corréler les scores élevés avec les audiences ou les comportements.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
score	number	Oui	10000	Score à publier.
level	number	Non	5	Niveau du score.
character	string	Non	Joueur 1	Personnage qui a remporté le score.

Envoyer l'événement

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

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

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

purchase

Cet événement signifie qu'un ou plusieurs articles sont achetés par un utilisateur.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
transaction_id	string	Oui	T_12345	Identifiant unique d'une transaction. Le paramètre transaction_id vous permet d'éviter de recevoir des événements en double pour un achat.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping	number	Non	3,33	Frais de port associés à une transaction.
tax	number	Non	1.11	Coût des taxes associé à une transaction.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

Remarque :Nous vous recommandons d'inclure les informations sur les articles dans votre événement refund pour afficher les métriques de remboursement au niveau des articles dans Analytics.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
transaction_id	string	Oui	T_12345	Identifiant unique d'une transaction.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'événement. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
shipping	number	Non	3,33	Frais de port associés à une transaction.
tax	number	Non	1.11	Coût des taxes associé à une transaction.
items	Array<Item>	Non*		Éléments de l'événement

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
item_id	string	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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

search

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

Paramètres

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
content_type	string	Non	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ée si elle est définie au niveau de l'article.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Ignorée si elle est définie au niveau de l'article.
items	Array<Item>	Oui*		Éléments de l'événement * Le tableau items doit comporter un seul élément, représentant l'élément sélectionné. Si plusieurs éléments sont fournis, seul le premier élément de items sera utilisé.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
item_id	string	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Ignorée si elle est définie au niveau de l'article.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'événement. Ignorée si elle est définie au niveau de l'article.
promotion_id	string	Non	P_12345	ID de la promotion associée à l'événement. Ignorée si elle est définie au niveau de l'article.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'événement. Ignorée si elle est définie au niveau de l'article.
items	Array<Item>	Non		Éléments de l'événement

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
item_id	string	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 a créé un compte. Utilisez cet événement pour comprendre les différents comportements des utilisateurs connectés et déconnectés.

Paramètres

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

Envoyer l'événement

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

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

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

spend_virtual_currency

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
value	number	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'article pour lequel la devise virtuelle est utilisée.

Envoyer l'événement

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

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

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

tutorial_begin

Cet événement marque le début du processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_complete pour déterminer le nombre d'utilisateurs qui terminent le tutoriel.

Paramètres

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

Aucun paramètre pour cet événement.

Envoyer l'événement

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

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

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

tutorial_complete

Cet événement signifie que l'utilisateur a terminé votre processus d'intégration. Utilisez-le dans un entonnoir avec tutorial_begin pour comprendre combien d'utilisateurs terminent le tutoriel.

Paramètres

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

Envoyer l'événement

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

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

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

unlock_achievement

Consignez cet événement lorsque l'utilisateur a déverrouillé une réussite. Cet événement peut vous aider à comprendre l'expérience des utilisateurs avec votre jeu.

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
achievement_id	string	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 alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
currency	string	Oui*	USD	Devise des articles associés à l'événement, au format ISO 4217 à trois lettres. * Si vous définissez value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
value	number	Oui*	30,03	Valeur monétaire de l'événement. * Définissez value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax. * value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value. * currency est requis si vous définissez value.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Ignorée si elle est définie au niveau de l'article.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Ignorée si elle est définie au niveau de l'article.
items	Array<Item>	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 indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Paramètres

Nom	Type	Obligatoire	Exemple de valeur	Description
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Ignorée si elle est définie au niveau de l'article.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associée à l'événement. Ignorée si elle est définie au niveau de l'article.
promotion_id	string	Non	P_12345	ID de la promotion associée à l'événement. Ignorée si elle est définie au niveau de l'article.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'événement. Ignorée si elle est définie au niveau de l'article.
items	Array<Item>	Oui*		Éléments de l'événement * Le tableau items ne doit contenir qu'un seul élément, représentant l'article associé à la promotion. Si plusieurs éléments sont fournis, seul le premier élément de items sera utilisé.

Paramètres d'élément

Nom	Type	Obligatoire	Exemple de valeur	Description
item_id	string	Oui*	SKU_12345	Identifiant de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
item_name	string	Oui*	T-shirt Stan and Friends	Nom de l'article. *Vous devez indiquer l'une des valeurs suivantes : item_id ou item_name.
affiliation	string	Non	Google Store	Affiliation du produit pour désigner l'entreprise qui fournit l'article ou le magasin physique dans lequel il a été vendu. Remarque : "affiliation" n'est disponible qu'au niveau de l'article.
coupon	string	Non	SUMMER_FUN	Nom/code du bon de réduction associé à l'article. Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
creative_name	string	Non	summer_banner2	Nom de la création promotionnelle. Si ce champ est défini, le creative_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_name au niveau de l'événement est utilisé, le cas échéant.
creative_slot	string	Non	featured_app_1	Nom de l'emplacement de la création promotionnelle associé à l'article. Si ce champ est défini, le creative_slot au niveau de l'événement est ignoré. Si ce champ n'est pas défini, creative_slot au niveau de l'événement est utilisé, le cas échéant.
discount	number	Non	2,22	Valeur de la remise monétaire unitaire associée à l'article.
index	number	Non	5	Index/position de l'élément dans une liste.
item_brand	string	Non	Google	Marque de l'article.
item_category	string	Non	Habillement	Catégorie de l'article Si elle est utilisée dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2	string	Non	Adulte	Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3	string	Non	Chemises	Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4	string	Non	Équipe du film	Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5	string	Non	À manches courtes	Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id	string	Non	related_products	ID de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_id au niveau de l'événement est utilisé, le cas échéant.
item_list_name	string	Non	Produits associés	Nom de la liste dans laquelle l'article a été présenté à l'utilisateur Si ce champ est défini, le item_list_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, item_list_name au niveau de l'événement est utilisé, le cas échéant.
item_variant	string	Non	green	Variante de l'article, ou code unique ou description pour des détails/options supplémentaires sur les articles.
location_id	string	Non	ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant de lieu Google pour San Francisco)	Emplacement physique associé à l'article (par exemple, magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Remarque : "location id" n'est disponible qu'au niveau de la portée article.
price	number	Non	10,01	Prix unitaire monétaire de l'article, exprimé dans le paramètre de devise spécifié. Si une remise s'applique à l'article, définissez price sur le prix unitaire de la remise et spécifiez le prix unitaire dans le paramètre discount.
promotion_id	string	Non	P_12345	Identifiant de la promotion associée à l'article. Si ce champ est défini, le promotion_id au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_id au niveau de l'événement est utilisé, le cas échéant.
promotion_name	string	Non	Promotion d'été	Nom de la promotion associée à l'article. Si ce champ est défini, le promotion_name au niveau de l'événement est ignoré. Si ce champ n'est pas défini, promotion_name au niveau de l'événement est utilisé, le cas échéant.
quantity	number	Non	3	Quantité d'articles Si ce champ n'est pas défini, quantity est défini sur 1.

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

Envoyer l'événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

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

Paramètres

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

Remarque :L'événement view_search_results envoie le paramètre unique_search_term avec la valeur 1 si le terme de recherche est unique dans la session en cours. Si le terme de recherche a déjà été envoyé dans la session en cours, la valeur du paramètre est 0.

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