Cette page a été traduite par l'API Cloud Translation.

Envoyer des événements

Vous pouvez suivre ce guide de démarrage rapide pour vous familiariser avec l'envoi de données d'événement.

Utilisez l'API Data Manager dans les scénarios suivants :

Envoyez les conversions de la balise Google Ads ou les événements clés Google Analytics comme source de données supplémentaire pour vos conversions de balise. Vous pourrez ainsi maximiser les signaux d'interaction avec les annonces, renforcer vos données et améliorer vos performances globales.

Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation. Remplissez le formulaire si vous souhaitez ajouter votre compte Google Ads ou votre propriété Google Analytics.

Remarque : Les données issues de la source de données supplémentaire que vous connectez ne seront pas utilisées dans vos enchères basées sur les conversions pendant une période d'essai de 14 jours. Cela ne s'applique pas à la source de données de la balise Google existante.
Envoyez des données d'événement pour les conversions hors connexion Google Ads ou le suivi avancé des conversions pour les prospects.

Choisissez la version du guide que vous souhaitez consulter :

Dans ce guide de démarrage rapide, vous allez effectuer les étapes suivantes :

Préparez un Destination pour recevoir les données d'événement.
Préparez les données d'événement à envoyer.
Créez une requête IngestionService pour les événements.
Envoyez la requête avec Google APIs Explorer.
Comprendre les réponses de réussite et d'échec

Préparer des destinations

Avant de pouvoir envoyer des données, vous devez préparer au moins un Destination pour les données. Voici un exemple de Destination que vous pouvez utiliser :

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Voici les champs d'un Destination :

operatingAccount

Compte qui reçoit les événements.

Pour les événements envoyés en tant que source de données supplémentaire, le compte opérationnel peut être un compte Google Ads ou une propriété Google Analytics. Définissez accountType sur GOOGLE_ADS ou GOOGLE_ANALYTICS_PROPERTY, et accountId sur le numéro client Google Ads ou l'ID de propriété Google Analytics. Si accountType est défini sur GOOGLE_ANALYTICS_PROPERTY, les identifiants de la requête doivent être ceux d'un utilisateur Google Analytics disposant du rôle Éditeur ou Administrateur pour la propriété.

Pour les conversions hors connexion et le suivi avancé des conversions pour les prospects, le compte opérationnel doit être un compte Google Ads. Définissez donc accountType sur GOOGLE_ADS et accountId sur l'ID client Google Ads.

loginAccount

Compte auquel l'utilisateur des identifiants a accès.

Si vos identifiants OAuth concernent un utilisateur ayant accès à un compte administrateur Google Ads dont operatingAccount est l'un des sous-comptes, loginAccount est obligatoire. Définissez le accountId du loginAccount sur l'ID du compte administrateur, puis définissez le accountType du loginAccount sur GOOGLE_ADS.

Si vos identifiants OAuth concernent un utilisateur ayant un accès direct à operatingAccount, vous n'avez pas besoin de définir loginAccount. La valeur par défaut est operatingAccount. Toutefois, nous vous recommandons de définir loginAccount sur les mêmes accountId et accountType que operatingAccount. Cela permet d'éviter les problèmes si l'ensemble des comptes auxquels l'utilisateur peut accéder change.

productDestinationId

ID de l'entité dans operatingAccount qui reçoit les événements.

Pour les événements envoyés en tant que source de données supplémentaire, productDestinationId doit être l'ID d'une conversion Google Ads avec type défini sur WEBPAGE, ou l'ID de mesure d'un flux Web Google Analytics. Vous ne pouvez pas envoyer d'événements en tant que source de données supplémentaire à un flux d'application iOS ou Android Google Analytics.

Pour les conversions hors connexion ou le suivi avancé des conversions pour les prospects, productDestinationId doit correspondre à l'ID d'une action de conversion Google Ads dont type est défini sur UPLOAD_CLICKS.

L'exemple de ce guide montre comment créer une requête qui envoie chaque événement à la même destination. Si vous souhaitez envoyer des événements pour plusieurs destinations dans la même requête, consultez Envoyer des événements pour plusieurs destinations.

Préparer les données d'événement

Prenons l'exemple des données d'événement suivantes. Chaque tableau correspond à un événement de conversion. Chaque événement de conversion est associé à un code temporel, une action de conversion et une valeur de conversion.

Chaque événement peut comporter des identifiants publicitaires, comme gclid, ou des identifiants utilisateur, comme des adresses e-mail, des numéros de téléphone et des informations sur l'adresse. Un événement peut également comporter :

Informations sur l'utilisateur évaluées au moment de l'événement, comme la valeur du client ou s'il s'agit d'un nouveau client, d'un client connu ou d'un client réengagé.
Données du panier
Paramètres d'événement ou propriétés utilisateur supplémentaires pour une destination, comme client_id ou user_id pour Google Analytics.

Voici les données de l'événement :

Événement 1

Événement 1
`conversion_time`	`2025-06-10 15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`30.03`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`John`
`family_name`	`Smith-Jones`
`region_code`	`us`
`postal_code`	`94045`
`customer_type`	`NEW`
`customer_value_bucket`	`HIGH`
`client_id`	`1234567890.1761581763`
`user_id`	`user_ABC12345`
`ad_unit_name`	`Banner_01`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12345`
`item_name`	`Stan and Friends Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`2.22`
`item_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_price`	`10.01`
`item_quantity`	`3`

Événement 2

Événement 2
`conversion_time`	`June 10, 2025 11:42:33PM America/New_York`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`42.02`
`currency`	`eur`
`gclid`	`GCLID_2`
`emails`	`zoe@EXAMPLE.COM` `cloudy.sanfrancisco@gmail.com`
`given_name`	`zoë`
`family_name`	`pérez`
`region_code`	`PT`
`postal_code`	`1229-076`
`customer_type`	`RETURNING`
`client_id`	`9876543210.1761582117`
`user_id`	`user_DEF9876`
`ad_unit_name`	`Banner_02`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12346`
`item_name`	`Google Grey Women's Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`3.33`
`item_index`	`1`
`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_price`	`21.01`
`item_quantity`	`2`

Mettre en forme les données

Mettez en forme les champs comme indiqué dans le guide de mise en forme. Voici les données d'événement après mise en forme :

Événement 1

Événement 1
`conversion_time`	`2025-06-10T15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`30.03`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`john`
`family_name`	`smith-jones`
`region_code`	`US`
`postal_code`	`94045`
`customer_type`	`NEW`
`customer_value_bucket`	`HIGH`
`client_id`	`1234567890.1761581763`
`user_id`	`user_ABC12345`
`ad_unit_name`	`Banner_01`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12345`
`item_name`	`Stan and Friends Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`2.22`
`item_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_price`	`10.01`
`item_quantity`	`3`

Événement 2

Événement 2
`conversion_time`	`2025-06-10T23:42:33-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`42.02`
`currency`	`EUR`
`gclid`	`GCLID_2`
`emails`	`zoe@example.com` `cloudysanfrancisco@gmail.com`
`given_name`	`zoë`
`family_name`	`pérez`
`region_code`	`PT`
`postal_code`	`1229-076`
`customer_type`	`RETURNING`
`client_id`	`9876543210.1761582117`
`user_id`	`user_DEF9876`
`ad_unit_name`	`Banner_02`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12346`
`item_name`	`Google Grey Women's Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`3.33`
`item_index`	`1`
`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_price`	`21.01`
`item_quantity`	`2`

Hacher et encoder les données

De plus, les adresses e-mail, prénoms et noms de famille mis en forme doivent être hachés à l'aide de l'algorithme SHA-256 et encodés à l'aide de l'encodage hexadécimal ou Base64. Voici les données d'événement après mise en forme, hachage et encodage à l'aide de l'encodage hexadécimal :

Événement 1

Événement 1
`conversion_time`	`2025-06-10T15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`30.03`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A`
`family_name`	`DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081`
`region_code`	`US`
`postal_code`	`94045`
`customer_type`	`NEW`
`customer_value_bucket`	`HIGH`
`client_id`	`1234567890.1761581763`
`user_id`	`user_ABC12345`
`ad_unit_name`	`Banner_01`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12345`
`item_name`	`Stan and Friends Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`2.22`
`item_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_price`	`10.01`
`item_quantity`	`3`

Événement 2

Événement 2
`conversion_time`	`2025-06-10T23:42:33-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`42.02`
`currency`	`EUR`
`gclid`	`GCLID_2`
`emails`	`3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250` `223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4`
`given_name`	`2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450`
`family_name`	`6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F`
`region_code`	`PT`
`postal_code`	`1229-076`
`customer_type`	`RETURNING`
`client_id`	`9876543210.1761582117`
`user_id`	`user_DEF9876`
`ad_unit_name`	`Banner_02`
`event_name`	`purchase`
Articles du panier
`item_id`	`SKU_12346`
`item_name`	`Google Grey Women's Tee`
`item_affiliation`	`Google Merchandise Store`
`item_coupon`	`SUMMER_FUN`
`item_discount`	`3.33`
`item_index`	`1`
`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_price`	`21.01`
`item_quantity`	`2`

Convertir les données en objets `Event`

Convertissez les données mises en forme et hachées de chaque événement en Event. Remplissez les champs suivants comme indiqué :

Définissez eventTimestamp sur l'heure à laquelle l'événement s'est produit.

Les événements pour Google Analytics doivent avoir un eventTimestamp au cours des 72 dernières heures.

Définissez les champs obligatoires pour votre cas d'utilisation.

Cas d'utilisation	Identifiants	`transactionId`	`eventSource`
Conversions hors connexion ou suivi avancé des conversions pour les prospects	Obligatoire. Définissez au moins l'un des éléments suivants : `adIdentifiers` avec au moins l'un des éléments `gclid`, `gbraid`, `wbraid` ou `sessionAttributes` défini `userData`	Facultatif	Obligatoire. Définissez l'une des valeurs d'énumération pour `EventSource`.
Événements envoyés en tant que source de données supplémentaire à une destination Google Ads	Obligatoire. Définissez au moins l'un des éléments suivants : `adIdentifiers` avec au moins l'un des éléments `gclid`, `gbraid` ou `wbraid` défini `userData`	Obligatoire	Facultatif. Si cette valeur est définie, elle doit être `WEB`.
Événements envoyés en tant que source de données supplémentaire à une destination Google Analytics	Obligatoire. Définissez au moins l'un des éléments suivants : `clientId` `adIdentifiers` avec `gclid` défini `userData`	Obligatoire	Facultatif. Si cette valeur est définie, elle doit être `WEB`.

Renseignez tous les autres champs pour lesquels vous disposez d'une valeur pour l'événement. Consultez la documentation de référence sur Event pour obtenir la liste complète des champs disponibles.

Ajouter des informations Google Analytics

Si les destinations d'un événement envoyé en tant que source de données supplémentaire incluent une propriété Google Analytics, renseignez les champs suivants comme indiqué :

eventName

Obligatoire. Nom de l'événement Google Analytics.

transactionId

Obligatoire . Identifiant unique de l'événement.

Au moins un identifiant

Au moins l'un des champs suivants doit être défini :

clientId : identifiant unique d'une instance utilisateur d'un client Web. Consultez Envoyer un événement au protocole de mesure.
adIdentifiers.gclid : ID de clic Google.
userData : identifiants de l'utilisateur, tels que des adresses e-mail, des numéros de téléphone ou des informations sur l'adresse.

destinationReferences

Obligatoire si la liste destinations au niveau de la requête contient plusieurs Destination Google Analytics. Ajoutez une entrée à destinationReferences pour spécifier la destination Google Analytics qui doit recevoir l'événement. Pour en savoir plus sur les références de destination, consultez Envoyer des événements vers plusieurs destinations.

Si destinationReferences n'est pas défini ou comporte plusieurs entrées faisant référence à des destinations Google Analytics, l'API Data Manager rejette l'événement avec l'erreur MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT.

userId

Facultatif. User-ID de l'utilisateur.

additionalEventParameters

Facultatif, mais recommandé. Renseignez cette liste avec tous les paramètres d'événement Google Analytics qui ne sont pas capturés dans les autres champs Event. Les paramètres peuvent inclure des paramètres recommandés supplémentaires de l'événement purchase ou d'autres paramètres que vous souhaitez capturer. Utilisez le nom de paramètre Google Analytics pour le parameterName du EventParameter.

Par exemple, si vous avez les taxes associées à une transaction, ajoutez une entrée à additionalEventParameters avec parameterName défini sur tax et value défini sur le montant des taxes.

Nous vous déconseillons d'ajouter des entrées pour les paramètres d'événement transactionId, currency ou value de Google Analytics. Renseignez plutôt les transactionId, currency et conversionValue de Event, qui sont prioritaires sur toutes les entrées de additionalEventParameters.

Ajouter des données de panier pour les événements d'achat

Renseignez le champ cartData de Event avec des informations sur les articles achetés. Pour chaque article acheté, ajoutez un objet Item à la liste items de CartData et renseignez les champs suivants comme indiqué :

itemId

Obligatoire. Identifiant unique de l'article.

unitPrice

Obligatoire. Prix unitaire hors taxes, frais de port et remises de portée événement (au niveau de la transaction).

Si l'article bénéficie d'une remise au niveau de l'article, utilisez le prix unitaire avec remise. 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

Obligatoire. Quantité d'unités achetées pour cet article spécifique.

additionalItemParameters

Renseignez cette liste avec tous les paramètres de portée "item" qui ne sont pas capturés dans les autres champs Item. Utilisez le nom du paramètre d'article Google Analytics pour le parameterName de ItemParameter.

Par exemple, si vous disposez de la marque et de la catégorie d'un article, ajoutez une entrée à additionalItemParameters de l'article avec parameterName défini sur item_brand et value défini sur le nom de la marque, et une autre entrée avec parameterName défini sur item_category et value défini sur la catégorie de l'article.

Nous vous déconseillons d'ajouter des entrées pour les paramètres d'élément Google Analytics quantity, price ou item_id. Renseignez plutôt les itemId, unitPrice et quantity de Item, qui sont prioritaires sur toutes les entrées de additionalItemParameters.

Voici un exemple de Event pour les données mises en forme, hachées et encodées du deuxième événement, avec des données supplémentaires pour Google Analytics :

{
  "adIdentifiers": {
     "gclid": "GCLID_2"
  },
  "conversionValue": 42.02,
  "currency": "EUR",
  "eventTimestamp": "2025-06-10T23:42:33-05:00",
  "transactionId": "DEF999911111",
  "eventSource": "WEB",
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
      },
      {
        "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
      },
      {
        "address": {
          "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
          "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
          "regionCode": "PT",
          "postalCode": "1229-076"
        }
      }
    ],
  },
  "userProperties": {
    "customerType": "RETURNING"
  },
  "eventName": "purchase",
  "clientId": "9876543210.1761582117",
  "userId": "user_DEF9876",
  "additionalEventParameters": [
    {
      "parameterName": "ad_unit_name",
      "value": "Banner_02"
    }
  ],
  "cartData": {
    "transactionDiscount": 6.66,
    "items": [
      {
        "itemId": "SKU_12346",
        "quantity": 2,
        "unitPrice": 21.01,
        "additionalItemParameters": [
          {
            "parameterName": "item_name",
            "value": "Google Grey Women's Tee"
          },
          {
            "parameterName": "affiliation",
            "value": "Google Merchandise Store"
          },
          {
            "parameterName": "coupon",
            "value": "SUMMER_FUN"
          },
          {
            "parameterName": "discount",
            "value": "3.33"
          },
          {
            "parameterName": "index",
            "value": "1"
          },
          {
            "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"
          }
        ]
      }
    ]
  }
}

Créer le corps de la requête

Combinez Destination et Events pour le corps de la requête :

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 30.03,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "NEW",
         "customerValueBucket": "HIGH"
       },
       "eventName": "purchase",
       "clientId": "1234567890.1761581763",
       "userId": "user_ABC12345",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_01"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "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": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "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"
               }
             ]
           }
         ]

       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 42.02,
       "currency": "EUR",
       "eventTimestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "RETURNING"
       },
       "eventName": "purchase",
       "clientId": "9876543210.1761582117",
       "userId": "user_DEF9876",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_02"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12346",
             "quantity": 2,
             "unitPrice": 21.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Google Grey Women's Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "3.33"
               },
               {
                 "parameterName": "index",
                 "value": "1"
               },
               {
                 "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"
               }
             ]
           }
         ]
       }
     }
  ],
  "validateOnly": true
}

Remplacez les espaces réservés dans le corps, tels que OPERATING_ACCOUNT_ID et PRODUCT_DESTINATION_ID, par les valeurs de votre compte et de votre destination.
Définissez validateOnly sur true pour valider la requête sans appliquer les modifications. Lorsque vous êtes prêt à appliquer les modifications, définissez validateOnly sur false.
Notez que cet exemple n'utilise pas le chiffrement.

Envoyer la requête

Copiez le corps de la requête à l'aide du bouton de copie en haut à droite de l'exemple.
Cliquez sur le bouton API dans la barre d'outils.
Collez le corps de la requête copié dans la zone Corps de la requête.
Cliquez sur le bouton Exécuter, répondez aux invites d'autorisation et examinez la réponse.

Réponses de réussite

Une requête réussie renvoie une réponse avec un objet contenant un requestId.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

Enregistrez le requestId renvoyé pour pouvoir récupérer les diagnostics à mesure que chaque destination de la demande est traitée.

Réponses d'échec

Une requête ayant échoué génère un code d'état de réponse d'erreur tel que 400 Bad Request, ainsi qu'une réponse contenant des informations sur l'erreur.

Par exemple, un emailAddress contenant une chaîne de texte brut au lieu d'une valeur encodée en hexadécimal produit la réponse suivante :

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

Un emailAddress non haché et uniquement encodé en hexadécimal produit la réponse suivante :

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

Envoyer des événements pour plusieurs destinations

Si vos données contiennent des événements pour différentes destinations, vous pouvez les envoyer dans la même requête en utilisant des références de destination.

Par exemple, si vous avez un événement pour l'ID d'action de conversion 123456789 et un autre événement pour l'ID d'action de conversion 777111122, envoyez les deux événements dans une seule requête en définissant le reference de chaque Destination. reference est défini par l'utilisateur. La seule exigence est que chaque Destination possède un reference unique. Voici la liste destinations modifiée pour la demande :

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID",
      "reference": "destination_a"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_ID"
      },

      "productDestinationId": "777111122",
      "reference": "destination_b"
    }
  ]

Définissez le destinationReferences de chaque Event pour l'envoyer à une ou plusieurs destinations spécifiques. Par exemple, voici un Event qui ne concerne que le premier Destination. Sa liste destinationReferences ne contient donc que le reference du premier Destination :

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "eventTimestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "WEB",
   "destinationReferences": [
      "destination_a"
   ]
}

Le champ destinationReferences est une liste. Vous pouvez donc spécifier plusieurs destinations pour un événement. Si vous ne définissez pas le destinationReferences d'un Event, l'API Data Manager envoie l'événement à toutes les destinations de la requête.

Si un événement comporte plusieurs destinations, l'API Data Manager envoie les champs concernés à chaque destination. Par exemple, si un événement a une destination Google Ads et une destination Google Analytics, l'API inclut des champs Google Analytics tels que clientId ou eventName lors de l'envoi de l'événement à la destination Google Analytics, et inclut des champs Google Ads tels que customVariables lors de l'envoi de l'événement à la destination Google Ads.

Étapes suivantes

Configurez l'authentification et votre environnement avec une bibliothèque cliente.
Découvrez les exigences de mise en forme, de hachage et d'encodage pour chaque type de données.
Découvrez comment chiffrer les données utilisateur.
Découvrez comment récupérer les diagnostics pour vos demandes.
Découvrez les bonnes pratiques.
En savoir plus sur les limites et les quotas

Présentation des événements

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

Préparer des destinations

Préparer les données d'événement

Événement 1

Événement 2

Mettre en forme les données

Événement 1

Événement 2

Hacher et encoder les données

Événement 1

Événement 2

Convertir les données en objets Event

Ajouter des informations Google Analytics

Ajouter des données de panier pour les événements d'achat

Créer le corps de la requête

Envoyer la requête

Réponses de réussite

Réponses d'échec

Envoyer des événements pour plusieurs destinations

Étapes suivantes

Envoyer des événements

Convertir les données en objets `Event`