Événements

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

add_payment_info

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

Paramètres

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

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

add_shipping_info

Cet événement signifie qu'un utilisateur a envoyé ses informations de livraison.

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 à 3 lettres.

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN 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 ou Next-day) sélectionné pour la livraison de l'article acheté.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

add_to_cart

Cet événement signifie qu'un article a été ajouté à 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 à 3 lettres.

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

add_to_wishlist

L'événement signifie qu'un article a été ajouté à une liste de souhaits. Utilisez cet événement pour identifier les articles 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 à 3 lettres.

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

begin_checkout

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

Paramètres

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

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'événement.

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

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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


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

earn_virtual_currency

Cet événement mesure l'attribution de monnaie virtuelle. Enregistrez-la en parallèle avec spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Paramètres

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

Envoyer un événement

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

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

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

generate_lead

Consignez cet événement lorsqu'un prospect a été généré afin de comprendre l'efficacité de vos campagnes de remarketing.

Paramètres

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

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.

Envoyer un événement

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

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

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

join_group

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

Paramètres

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

Envoyer un événement

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

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

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

level_up

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

Paramètres

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

Envoyer un événement

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

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

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

login

Envoyez cet événement pour indiquer qu'un utilisateur s'est connecté.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
method string Non Google Méthode de connexion.

Envoyer un événement

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

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

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

post_score

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

Paramètres

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

Envoyer un événement

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

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

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

purchase

Cet événement correspond à l'achat d'un ou de plusieurs articles 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 à 3 lettres.

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

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

* value est obligatoire pour créer des rapports pertinents et renseigner l'audience prédictive des acheteurs.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_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 fiscal associé à une transaction.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

refund

Cet événement correspond au moment où un ou plusieurs articles sont remboursés à un utilisateur.

Paramètres

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

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
coupon string Non ÉTÉ_FUN 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 fiscal associé à une transaction.
items Array<Item> Non* Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

remove_from_cart

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

Paramètres

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

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

Utilisez cet événement pour contextualiser les opérations de recherche. Cet événement peut vous aider à identifier le contenu le plus populaire dans votre application.

Paramètres

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

Envoyer un événement

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

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

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

select_content

Cet événement signifie qu'un utilisateur a sélectionné du contenu d'un certain type. Cet événement peut vous aider à identifier les contenus populaires et les catégories de contenu dans votre application.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
content_type string Non product Type de contenu sélectionné.
item_id string Non I_12345 Identifiant de l'élément sélectionné.

Envoyer un événement

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

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

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

select_item

Cet événement signifie qu'un élément a été sélectionné dans une liste.

Paramètres

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

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

Ignoré s'il est défini au niveau de l'élément.
items Array<Item> Oui* Éléments associés à 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 item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

select_promotion

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

Paramètres

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

Ignoré s'il est défini au niveau de l'élément.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'événement.

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

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

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

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

partager

Utilisez cet événement lorsqu'un utilisateur a partagé du contenu.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
method string Non Twitter Méthode de partage du contenu.
content_type string Non Image Type de contenu partagé.
item_id string Non C_12345 ID du contenu partagé.

Envoyer un événement

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

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

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

sign_up

Cet événement indique qu'un utilisateur a ouvert 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.

Envoyer un événement

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

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

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

spend_virtual_currency

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

Paramètres

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

Envoyer un événement

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

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

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

tutorial_begin

Cet événement indique le début du processus d'intégration. Utilisez cette approche dans un entonnoir avec tutorial_complete pour comprendre combien d'utilisateurs suivent le tutoriel.

Paramètres

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

Aucun paramètre pour cet événement.

Envoyer un événement

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

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

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

tutorial_complete

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

Paramètres

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

Envoyer un événement

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

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

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

unlock_achievement

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
achievement_id string Yes A_12345 Identifiant de la réussite qui a été déverrouillée.

Envoyer un événement

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "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 à 3 lettres.

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

view_item

Cet événement signifie que certains contenus ont été présentés à l'utilisateur. Utilisez cet événement pour découvrir les articles les plus populaires.

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 à 3 lettres.

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

* value est généralement obligatoire pour générer des rapports pertinents. Si vous marquez l'événement en tant que conversion, nous vous recommandons de définir value.
* currency est obligatoire si vous définissez value.
items Array<Item> Yes Éléments associés à l'événement.

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

view_item_list

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

Paramètres

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

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

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

Paramètres d'élément

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

Identifiant de l'article

*Vous devez indiquer item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

view_promotion

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

Paramètres

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

Ignoré s'il est défini au niveau de l'élément.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'événement.

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

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

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

* Le tableau items ne doit comprendre 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 item_id ou item_name.

item_name string Oui* T-shirt Stan and Friends

Nom de l'article

*Vous devez indiquer item_id ou item_name.

affiliation string Non Google Store Affiliation du produit pour désigner une entreprise d'approvisionnement ou un magasin physique.
Remarque: L'attribut "affiliation" n'est disponible qu'au niveau des éléments.
coupon string Non ÉTÉ_FUN Nom/Code du bon de réduction associé à l'article.

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

Si ce champ est défini, creative_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_name au niveau de l'événement est utilisée, le cas échéant.
creative_slot string Non application_sélectionnée_1 Nom de l'espace publicitaire promotionnel associé à l'élément.

Si ce champ est défini, creative_slot au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété creative_slot au niveau de l'événement est utilisée, le cas échéant.
discount number Non 2,22 Valeur de la remise monétaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article
item_category string Non Habillement Catégorie de l'article S'il fait partie d'une hiérarchie ou d'une taxonomie, il s'agit de la première catégorie.
item_category2 string Non Contenu réservé aux adultes Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Tee-shirts Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article
item_list_id string Non produits_associés ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si ce champ est défini, item_list_name au niveau de l'événement est ignoré.
Si ce champ n'est pas défini, la propriété item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non green Variante de l'article, ou code ou description uniques permettant d'obtenir des informations/options supplémentaires pour l'article.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (identifiant Google Place de San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID d'emplacement personnalisé.
Remarque: La valeur "location_id" n'est disponible qu'au niveau de l'élément.
price number Non 9,99 Prix monétaire de l'article, en unités du paramètre de devise spécifié.
promotion_id string Non P_12345 Identifiant de la promotion associée à l'article.

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

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

Quantité de l'article.

Si ce champ n'est pas défini, la valeur de quantity est 1.

Envoyer un événement

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

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

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

view_search_results

Consigner cet événement lorsque l'utilisateur a vu les résultats d'une recherche.

Paramètres

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

Envoyer un événement

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

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

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