Événements recommandés Google Analytics

Vous trouverez ci-dessous une liste d'événements recommandés. Vous pouvez également créer et envoyer vos propres événements personnalisés.

Lorsque vous créez des noms d'événements personnalisés, vous devez :

  1. Respectez les règles de dénomination des événements.
  2. Évitez les noms et préfixes réservés.
  3. Respectez les limites de collecte des événements, comme la limite de 40 caractères pour les noms d'événements et de paramètres.

Pour en savoir plus, consultez Premiers pas.

Si vous effectuez une mise à niveau à partir du protocole de mesure, consultez Mettre à niveau à partir du protocole de mesure pour obtenir des instructions.

Pour toutes les propriétés

ad_impression

Cet événement n'est disponible que pour les flux d'applications.

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

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

Champs d'événement

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

* Si vous définissez conversion_value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
conversion_value number Non 3,99 EUR
 Valeur de l'impression d'annonce.
* conversion_value est généralement requis pour créer des rapports pertinents.
* currency est obligatoire si vous définissez conversion_value.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
ad_platform string Non MoPub Plate-forme publicitaire.
ad_source string Non AdColony Source de l'annonce.
ad_format string Non Bannière Format de l'annonce.
ad_unit_name string Non Banner_03 Nom du bloc d'annonces.

Exemple

L'exemple suivant montre comment envoyer un événement ad_impression à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Protocole de mesure

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

earn_virtual_currency

Cet événement est enregistré lorsqu'un utilisateur reçoit de la monnaie virtuelle dans un jeu. Enregistrez cet événement avec spend_virtual_currency pour mieux comprendre votre économie virtuelle.

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
conversion_value number Non 5 Valeur de la devise virtuelle.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
virtual_currency_name string Non Gems Nom de la devise virtuelle.

Exemple

L'exemple suivant montre comment envoyer un événement earn_virtual_currency à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Protocole de mesure

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

join_group

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

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement join_group à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Protocole de mesure

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

login

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

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement login à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Protocole de mesure

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

screen_view

Cet événement n'est disponible que pour les flux d'applications.

Utilisez cet événement pour indiquer qu'une transition d'écran a eu lieu.

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement screen_view à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Protocole de mesure

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

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

Paramètres

Nom Type Obligatoire Exemple de valeur Description
search_term string Oui t-shirts Terme recherché.

Exemple

L'exemple suivant montre comment envoyer un événement search à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Protocole de mesure

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 indique qu'un utilisateur a sélectionné un contenu d'un certain type. Cet événement peut vous aider à identifier les contenus et les catégories de contenus populaires sur votre site Web ou votre application.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
content_type string Non produit Type de contenu sélectionné.
content_id string Non C_12345 Identifiant du contenu sélectionné. La valeur doit inclure au moins un caractère non numérique.

Exemple

L'exemple suivant montre comment envoyer un événement select_content à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Protocole de mesure

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

share

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

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
cart_data.items Item[] Non Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

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

Exemple

L'exemple suivant montre comment envoyer un événement share à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Protocole de mesure

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

sign_up

Cet événement indique qu'un utilisateur s'est inscrit à un compte. Utilisez cet événement pour comprendre les différents comportements des utilisateurs (qu'ils soient connectés ou non).

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement sign_up à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Protocole de mesure

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

spend_virtual_currency

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

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
conversion_value number Oui 5 Valeur de la devise virtuelle.
cart_data.items Item[] Non Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Non Boost de départ Nom de l'article pour lequel la devise virtuelle est utilisée.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
virtual_currency_name string Oui Gems Nom de la devise virtuelle.

Exemple

L'exemple suivant montre comment envoyer un événement spend_virtual_currency à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Protocole de mesure

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

tutorial_begin

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

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement tutorial_begin à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Protocole de mesure

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-le dans un entonnoir avec tutorial_begin pour comprendre le nombre d'utilisateurs qui terminent le tutoriel.

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement tutorial_complete à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Protocole de mesure

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

view_search_results

Enregistrez cet événement lorsque les résultats d'une recherche ont été présentés à l'utilisateur. Notez que vous pouvez activer la collecte automatique de l'événement view_search_results via les mesures améliorées des événements dans Google Analytics.

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement view_search_results à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Protocole de mesure

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

campaign_details

Utilisez cet événement pour envoyer les détails de la campagne qui seront appliqués aux événements dont le code temporel est supérieur ou égal à celui de l'événement campaign_details.

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement campaign_details à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Protocole de mesure

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

Ventes en ligne

add_payment_info

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.
cart_data.coupon_codes string[] Non SUMMER_FUN Code du bon de réduction associé à l'événement.


Définissez le champ coupon_codes sur l'objet CartData.
* Ne fournissez qu'un seul code promotionnel dans cette liste.
* Cela est indépendant des codes de bons de réduction au niveau de l'article.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
payment_type string Non Carte de crédit Le mode de paiement choisi.

Exemple

L'exemple suivant montre comment envoyer un événement add_payment_info à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

add_shipping_info

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.
cart_data.coupon_codes string[] Non SUMMER_FUN Code du bon de réduction associé à l'événement.


Définissez le champ coupon_codes sur l'objet CartData.
* Ne fournissez qu'un seul code promotionnel dans cette liste.
* Cela est indépendant des codes de bons de réduction au niveau de l'article.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
shipping_tier string Non Rez-de-chaussée Niveau de livraison (par exemple, Ground, Air, Next-day) sélectionné pour la livraison de l'article acheté.

Exemple

L'exemple suivant montre comment envoyer un événement add_shipping_info à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

add_to_cart

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement add_to_cart à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

add_to_wishlist

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement add_to_wishlist à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

begin_checkout

Cet événement indique qu'un utilisateur a commencé le processus de paiement.

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.
cart_data.coupon_codes string[] Non SUMMER_FUN Code du bon de réduction associé à l'événement.


Définissez le champ coupon_codes sur l'objet CartData.
* Ne fournissez qu'un seul code promotionnel dans cette liste.
* Cela est indépendant des codes de bons de réduction au niveau de l'article.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement begin_checkout à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

in_app_purchase

Cet événement n'est disponible que pour les flux d'applications.

Utilisez cet événement lorsqu'un utilisateur effectue un achat via l'application.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Non Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
product_id string Non ABC123456789 ID du produit.
subscription boolean Non true

Indique si l'achat est un abonnement.
Si ce champ n'est pas défini, la valeur par défaut est false.
free_trial boolean Non true

Indique si l'événement concerne un essai sans frais d'un abonnement.
Si ce champ n'est pas défini, la valeur par défaut est false.
price_is_discounted boolean Non faux

Indique si price bénéficie d'une remise.
Si ce champ n'est pas défini, la valeur par défaut est false.

Exemple

L'exemple suivant montre comment envoyer un événement in_app_purchase à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Protocole de mesure

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Cet événement se produit lorsqu'un utilisateur achète un ou plusieurs articles.

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

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

Le paramètre transaction_id vous aide à éviter de recevoir des événements en double pour un achat. Définissez le champ transaction_id sur l'objet Event.
user_properties.customer_type CustomerType Non NEW Indique si la conversion provient d'un client NEW ou RETURNING.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.
cart_data.coupon_codes string[] Non SUMMER_FUN Code du bon de réduction associé à l'événement.


Définissez le champ coupon_codes sur l'objet CartData.
* Ne fournissez qu'un seul code promotionnel dans cette liste.
* Cela est indépendant des codes de bons de réduction au niveau de l'article.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Montant des taxes associées à une transaction.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement purchase à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Protocole de mesure

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

refund

Cet événement se produit lorsqu'un ou plusieurs articles sont remboursés à un utilisateur.

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
transaction_id string Oui T_12345 Identifiant unique d'une transaction.
cart_data.items Item[] Non Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.
cart_data.coupon_codes string[] Non SUMMER_FUN Code du bon de réduction associé à l'événement.


Définissez le champ coupon_codes sur l'objet CartData.
* Ne fournissez qu'un seul code promotionnel dans cette liste.
* Cela est indépendant des codes de bons de réduction au niveau de l'article.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
shipping number Non 3,33 Frais de port associés à une transaction.
tax number Non 1.11 Montant des taxes associées à une transaction.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement refund à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

remove_from_cart

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement remove_from_cart à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

select_item

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

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
cart_data.items Item[] Oui* Éléments de l'événement.

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

Définissez le champ cart_data.items sur l'objet Event.

Paramètres

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

Ignoré s'il est défini au niveau de l'é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.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement select_item à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

select_promotion

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

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
cart_data.items Item[] Non Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
creative_name string Non summer_banner2 Nom de la création promotionnelle.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.
promotion_id string Non P_12345 ID de la promotion associée à l'événement.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'événement.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

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

Si ce champ n'est pas défini, la valeur par défaut est creative_name au niveau de l'événement.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est creative_slot au niveau de l'événement.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
promotion_id string Non P_12345 ID de la promotion associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est promotion_id au niveau de l'événement.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est promotion_name au niveau de l'événement.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement select_promotion à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

view_cart

Cet événement indique qu'un utilisateur a consulté son panier.

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement view_cart à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

view_item

Cet événement indique qu'un contenu a été présenté à l'utilisateur. Utilisez cet événement pour découvrir les articles les plus consultés.

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

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

* Définissez conversion_value sur la somme de (price * quantity) pour tous les éléments de items. N'incluez pas shipping ni tax.
* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement view_item à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

view_item_list

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

Champs d'événement

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

* Les métriques de valeur de l'événement view_item ne contribuent pas aux revenus.

* Si vous définissez conversion_value, currency est alors obligatoire pour que les métriques de revenus soient calculées avec précision.
cart_data.items Item[] Oui Éléments de l'événement.

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

Les paramètres coupon au niveau de l'événement et de l'article sont indépendants.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement view_item_list à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

view_promotion

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

Champs d'événement

Nom Type Obligatoire Exemple de valeur Description
cart_data.items Item[] Oui* Éléments de l'événement.

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

Définissez le champ cart_data.items sur l'objet Event.

Champs d'article

Nom Type Obligatoire Exemple de valeur Description
item_id string Oui I_12345 Identifiant unique de l'élément. Définissez le champ item_id sur l'objet Item.
unit_price number Oui 27,67 Prix unitaire de cet article, hors taxes, frais de port et remises appliquées aux transactions.

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27,67 € et une remise unitaire de 6,66 €, définissez unitPrice sur 21,01 €.
quantity number Oui 1 Quantité d'unités achetées pour cet article spécifique.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
creative_name string Non summer_banner2 Nom de la création promotionnelle.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'événement.
promotion_id string Non P_12345 ID de la promotion associée à l'événement.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'événement.

Paramètres d'élément

Nom Type Obligatoire Exemple de valeur Description
item_name string Oui* T-shirt Stan and Friends

Nom de l'article.

*Vous devez indiquer item_id ou item_name.

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

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

Si ce champ n'est pas défini, la valeur par défaut est creative_name au niveau de l'événement.
creative_slot string Non featured_app_1 Nom de l'emplacement de la création promotionnelle associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est creative_slot au niveau de l'événement.
discount number Non 2,22 Valeur de la remise monétaire unitaire associée à l'article.
index number Non 5 Index/position de l'élément dans une liste.
item_brand string Non Google Marque de l'article.
item_category string Non Habillement Catégorie de l'article S'il est utilisé dans une hiérarchie ou une taxonomie de catégories, il s'agit de la première catégorie.
item_category2 string Non Adulte Hiérarchie de la deuxième catégorie ou taxonomie supplémentaire pour l'article.
item_category3 string Non Chemises Hiérarchie de la troisième catégorie ou taxonomie supplémentaire pour l'article.
item_category4 string Non Équipe du film Hiérarchie de la quatrième catégorie ou taxonomie supplémentaire pour l'article.
item_category5 string Non Manches courtes Hiérarchie de la cinquième catégorie ou taxonomie supplémentaire pour l'article.
item_list_id string Non related_products ID de la liste dans laquelle l'article a été présenté à l'utilisateur

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

Si la valeur est définie, item_list_name au niveau de l'événement est ignoré.
Si ce paramètre n'est pas défini, la valeur item_list_name au niveau de l'événement est utilisée, le cas échéant.
item_variant string Non vert Variante de l'article, ou code unique ou description donnant plus de détails/options sur les articles.
location_id string Non ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID de lieu Google pour San Francisco) Emplacement physique associé à l'article (par exemple, l'emplacement du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé.
Remarque : location_id n'est disponible qu'au niveau de l'élément.
promotion_id string Non P_12345 ID de la promotion associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est promotion_id au niveau de l'événement.
promotion_name string Non Soldes d'été Nom de la promotion associée à l'article.

Si ce champ n'est pas défini, la valeur par défaut est promotion_name au niveau de l'événement.
En plus des paramètres prescrits, vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau items.

Exemple

L'exemple suivant montre comment envoyer un événement view_promotion à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocole de mesure

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

Jeux

level_up

Cet événement indique qu'un joueur est passé à un niveau supérieur dans un jeu. Utilisez-la pour évaluer la distribution 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 ayant gagné un niveau.

Exemple

L'exemple suivant montre comment envoyer un événement level_up à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Protocole de mesure

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

post_score

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

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement post_score à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Protocole de mesure

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

unlock_achievement

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

Paramètres

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

Exemple

L'exemple suivant montre comment envoyer un événement unlock_achievement à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Protocole de mesure

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

Génération de prospects

close_convert_lead

Enregistrez cet événement lorsqu'un lead qualifié est converti en client. Cela signifie généralement la fin du processus de nurturing des prospects, par exemple lorsqu'un contrat est signé, qu'un abonnement payant commence ou qu'une vente finale est conclue.

  • Remarque : Pour suivre l'acquisition initiale de prospects, comme les envois de formulaires, les inscriptions à la newsletter ou les demandes de démonstration, utilisez l'événement generate_lead.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Exemple

L'exemple suivant montre comment envoyer un événement close_convert_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

Cet événement est enregistré lorsqu'un utilisateur est marqué comme n'étant pas devenu un lead converti, avec la raison.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
unconvert_lead_reason string Non N'a jamais répondu Raison pour laquelle le prospect n'a pas été converti.

Exemple

L'exemple suivant montre comment envoyer un événement close_unconvert_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Cet événement est enregistré lorsqu'un utilisateur est marqué comme lead non qualifié, ainsi que la raison de la disqualification.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
disqualified_lead_reason string Non Je ne cherche pas à acheter Raison pour laquelle un lead a été marqué comme disqualifié.

Exemple

L'exemple suivant montre comment envoyer un événement disqualify_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

Cet événement est enregistré lorsqu'un prospect a été généré (par exemple, via un formulaire). Enregistrez cet événement pour comprendre l'efficacité de vos campagnes marketing et le nombre de clients qui interagissent à nouveau avec votre entreprise après avoir été ciblés par le remarketing.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
lead_source string Non Salon professionnel Source du prospect.

Exemple

L'exemple suivant montre comment envoyer un événement generate_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

Cet événement est enregistré lorsqu'un utilisateur est marqué comme répondant aux critères pour devenir un lead qualifié.

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Exemple

L'exemple suivant montre comment envoyer un événement qualify_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

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

Champs d'événement

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

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

* conversion_value est généralement requis pour créer des rapports pertinents. Si vous marquez l'événement comme événement clé, nous vous recommandons de définir conversion_value.
* currency est obligatoire si vous définissez conversion_value.

Paramètres

Nom Type Obligatoire Exemple de valeur Description
lead_status string Non Conversations commencées État du prospect.

Exemple

L'exemple suivant montre comment envoyer un événement working_lead à l'aide de l'API Data Manager. Si vous effectuez une mise à niveau à partir du protocole de mesure, utilisez les onglets pour migrer vos requêtes vers l'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Protocole de mesure

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});