Se usó la API de Cloud Translation para traducir esta página.

Enviar eventos

Puedes completar esta guía de inicio rápido para familiarizarte con el envío de datos de eventos.

Usa la API de Data Manager en cualquiera de las siguientes situaciones:

Envía las conversiones de la etiqueta de Google Ads o los eventos clave de Google Analytics como una fuente de datos adicional para tus conversiones de etiquetas, de modo que puedas maximizar los indicadores de interacción con los anuncios y fortalecer tus datos y tu rendimiento general.

Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas. Completa el formulario si te interesa agregar tu cuenta de Google Ads o tu propiedad de Google Analytics.

Nota: Los datos de la fuente de datos adicional que conectes no se transferirán a tus ofertas basadas en conversiones durante un período de prueba de 14 días. Esto no se aplica a tu fuente de datos de la etiqueta de Google existente.
Envía datos de eventos para las conversiones sin conexión de Google Ads o las conversiones avanzadas de clientes potenciales.

Elige la versión de la guía que deseas ver:

En esta guía de inicio rápido, completarás los siguientes pasos:

Prepara un objeto Destination para recibir datos de eventos.
Prepara los datos de eventos para enviarlos.
Compila una solicitud de IngestionService para eventos.
Envía la solicitud con el Explorador de APIs de Google.
Comprende las respuestas de éxito y error.

Prepara destinos

Antes de enviar datos, debes preparar al menos un Destination para los datos. Aquí tienes un ejemplo de Destination que puedes usar:

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

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

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Estos son los campos de un objeto Destination:

operatingAccount

Es la cuenta que recibe los eventos.

En el caso de los eventos enviados como una fuente de datos adicional, la cuenta operativa puede ser una cuenta de Google Ads o una propiedad de Google Analytics. Establece accountType en GOOGLE_ADS o GOOGLE_ANALYTICS_PROPERTY, y establece accountId en el ID de cliente de Google Ads o el ID de propiedad de Google Analytics. Si accountType es GOOGLE_ANALYTICS_PROPERTY, las credenciales de la solicitud deben ser para un usuario de Google Analytics con el rol de editor o administrador para la propiedad.

En el caso de las conversiones sin conexión y las conversiones avanzadas de clientes potenciales, la cuenta operativa debe ser una cuenta de Google Ads, por lo que debes establecer accountType en GOOGLE_ADS y accountId en el ID de cliente de Google Ads.

loginAccount

Es la cuenta a la que tiene acceso el usuario de la credencial.

Si tus credenciales de OAuth son para un usuario con acceso a una cuenta de administrador de Google Ads que tiene operatingAccount como una de sus cuentas secundarias, se requiere loginAccount. Establece el accountId del loginAccount en el ID de la cuenta de administrador y establece el accountType del loginAccount en GOOGLE_ADS.

Si tus credenciales de OAuth son para un usuario con acceso directo a operatingAccount, no es necesario que configures loginAccount, ya que se establecerá de forma predeterminada en operatingAccount. Sin embargo, te recomendamos que establezcas loginAccount con los mismos accountId y accountType que el operatingAccount. Esto ayuda a evitar problemas si cambia el conjunto de cuentas a las que puede acceder el usuario.

productDestinationId

Es el ID de la entidad en el operatingAccount que recibe los eventos.

En el caso de los eventos enviados como una fuente de datos adicional, el productDestinationId debe ser el ID de una conversión de Google Ads con type establecido en WEBPAGE o el ID de medición de un flujo de datos web de Google Analytics. No puedes enviar eventos como una fuente de datos adicional a un flujo de datos de aplicación para iOS o Android de Google Analytics.

En el caso de las conversiones sin conexión o las conversiones avanzadas de clientes potenciales, el elemento productDestinationId debe ser el ID de una acción de conversión de Google Ads con type configurado como UPLOAD_CLICKS.

En el ejemplo de esta guía, se muestra cómo crear una solicitud que envíe todos los eventos al mismo destino. Si deseas enviar eventos para varios destinos en la misma solicitud, consulta Cómo enviar eventos para varios destinos.

Prepara los datos de eventos

Considera los siguientes datos de eventos. Cada tabla corresponde a un evento de conversión. Cada evento de conversión tiene una marca de tiempo, su acción de conversión y su valor.

Cada evento puede tener identificadores de publicidad, como gclid, o identificadores de usuario, como direcciones de correo electrónico, números de teléfono y dirección. Un evento también puede tener lo siguiente:

Es la información sobre el usuario que se evalúa en el momento del evento, como el valor del cliente o si es un cliente nuevo, recurrente o reactivado.
Son los datos del carrito de compras.
Parámetros de eventos o propiedades del usuario adicionales para un destino, como client_id o user_id para Google Analytics.

Estos son los datos del evento:

Evento 1

Evento 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`
Artículos del carrito
`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`

Evento 2

Evento 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`
Artículos del carrito
`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`

Da formato a los datos

Da formato a los campos según se especifica en la guía de formato. Estos son los datos del evento después del formato:

Evento 1

Evento 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`
Artículos del carrito
`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`

Evento 2

Evento 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`
Artículos del carrito
`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`

Genera un hash y codifica los datos

Además, las direcciones de correo electrónico, los nombres y los apellidos con formato deben tener una codificación hash con el algoritmo SHA-256 y codificarse con codificación hexadecimal o Base64. Estos son los datos del evento después de aplicar el formato, la codificación hash y la codificación hexadecimal:

Evento 1

Evento 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`
Artículos del carrito
`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`

Evento 2

Evento 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`
Artículos del carrito
`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`

Convierte los datos en objetos `Event`

Convierte los datos con formato y codificación hash de cada evento en un Event. Propaga los siguientes campos como se indica:

Establece eventTimestamp en la hora en que ocurrió el evento.

Los eventos de Google Analytics deben tener un eventTimestamp dentro de las últimas 72 horas.

Establece los campos obligatorios para tu caso de uso.

Caso de uso	Identificadores	`transactionId`	`eventSource`
Conversiones sin conexión o conversiones avanzadas de clientes potenciales	Obligatorio. Establece al menos uno de los siguientes parámetros: `adIdentifiers` con al menos uno de los parámetros `gclid`, `gbraid`, `wbraid` o `sessionAttributes` establecido `userData`	Opcional	Obligatorio. Se establece en uno de los valores de enumeración para `EventSource`.
Eventos enviados como una fuente de datos adicional a un destino de Google Ads	Obligatorio. Establece al menos uno de los siguientes parámetros: `adIdentifiers` con al menos uno de los valores `gclid`, `gbraid` o `wbraid` establecidos `userData`	Obligatorio	Opcional. Si se configura, debe ser `WEB`.
Eventos enviados como una fuente de datos adicional a un destino de Google Analytics	Obligatorio. Establece al menos uno de los siguientes parámetros: `clientId` `adIdentifiers` con `gclid` establecido `userData`	Obligatorio	Opcional. Si se configura, debe ser `WEB`.

Propaga cualquier otro campo en el que tengas un valor para el evento. Consulta la documentación de referencia de Event para obtener la lista completa de los campos disponibles.

Agrega información de Google Analytics

Si los destinos de un evento enviado como fuente de datos adicional incluyen una propiedad de Google Analytics, completa los siguientes campos como se indica:

eventName

Obligatorio. Es el nombre del evento de Google Analytics.

transactionId

Obligatorio . Es el identificador único del evento.

Al menos un identificador

Se debe configurar, al menos, uno de los siguientes campos:

clientId: Es el identificador único de una instancia de usuario de un cliente web. Consulta Envía un evento a Measurement Protocol.
adIdentifiers.gclid: Es un ID de clic de Google.
userData: Son identificadores del usuario, como direcciones de correo electrónico, números de teléfono o información de la dirección.

destinationReferences

Obligatorio si la lista destinations a nivel de la solicitud contiene más de un Destination de Google Analytics. Agrega una entrada a destinationReferences para especificar qué destino de Google Analytics debe recibir el evento. Consulta cómo enviar eventos a varios destinos para obtener más información sobre las referencias de destino.

Si destinationReferences no está configurado o tiene varias entradas que hacen referencia a destinos de Google Analytics, la API de Data Manager rechaza el evento con el error MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT.

userId

Opcional. Es el User-ID del usuario.

additionalEventParameters

Opcional, pero recomendado. Propaga esta lista con los parámetros de eventos de Google Analytics que no se capturen en los otros campos de Event. Los parámetros pueden incluir parámetros recomendados adicionales del evento purchase o cualquier otro parámetro que desees capturar. Utiliza el nombre del parámetro de Google Analytics para el parameterName del EventParameter.

Por ejemplo, si tienes los impuestos asociados a una transacción, agrega una entrada a additionalEventParameters con parameterName establecido en tax y value establecido en el costo de impuestos.

No recomendamos agregar entradas para los parámetros de eventos de Google Analytics transactionId, currency o value. En su lugar, completa los campos transactionId, currency y conversionValue del objeto Event, que tienen prioridad sobre cualquier entrada en additionalEventParameters.

Agrega datos del carrito para los eventos de compra

Propaga el campo cartData del objeto Event con información sobre los artículos comprados. Para cada artículo comprado, agrega un objeto Item a la lista items del objeto CartData y completa los siguientes campos como se indica:

itemId

Obligatorio. Es un identificador único del elemento.

unitPrice

Obligatorio. Es el precio por unidad sin impuestos, envío ni descuentos con alcance del evento (a nivel de la transacción).

Si el artículo tiene un descuento aplicado al artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece unitPrice en 21.01.

quantity

Obligatorio. Es la cantidad de unidades compradas de este artículo en particular.

additionalItemParameters

Completa esta lista con cualquier parámetro con alcance del elemento que no se capture en los otros campos Item. Usa el nombre del parámetro del elemento de Google Analytics para el parameterName del ItemParameter.

Por ejemplo, si tienes la marca y la categoría de un elemento, agrega una entrada al additionalItemParameters del elemento con parameterName establecido en item_brand y value establecido en el nombre de la marca, y otra entrada con parameterName establecido en item_category y value establecido en la categoría del elemento.

No recomendamos agregar entradas para los parámetros de elementos quantity, price o item_id de Google Analytics. En su lugar, completa los campos itemId, unitPrice y quantity del objeto Item, que tienen prioridad sobre cualquier entrada en additionalItemParameters.

A continuación, se muestra un ejemplo de Event para los datos con formato, codificados y con hash del segundo evento, con datos adicionales para 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"
          }
        ]
      }
    ]
  }
}

Crea el cuerpo de la solicitud

Combina Destination y Events para el cuerpo de la solicitud:

{
  "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
}

Actualiza los marcadores de posición en el cuerpo, como OPERATING_ACCOUNT_ID y PRODUCT_DESTINATION_ID, con los valores de tu cuenta y destino.
Establece validateOnly en true para validar la solicitud sin aplicar los cambios. Cuando esté todo listo para aplicar los cambios, establece validateOnly en false.
Ten en cuenta que este ejemplo no usa encriptación.

Envía la solicitud

Copia el cuerpo de la solicitud con el botón de copia que se encuentra en la parte superior derecha del ejemplo.
Haz clic en el botón API de la barra de herramientas.
Pega el cuerpo de la solicitud copiado en el cuadro del Cuerpo de la solicitud.
Haz clic en el botón Ejecutar, completa las indicaciones de autorización y revisa la respuesta.

Respuestas de éxito

Una solicitud correcta devuelve una respuesta con un objeto que contiene un requestId.

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

Registra el requestId que se devolvió para que puedas recuperar los diagnósticos a medida que se procesa cada destino en la solicitud.

Respuestas de error

Una solicitud fallida genera un código de estado de respuesta de error, como 400 Bad Request, y una respuesta con detalles del error.

Por ejemplo, un emailAddress que contiene una cadena de texto sin formato en lugar de un valor codificado en hexadecimal produce la siguiente respuesta:

{
  "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 que no se hashea y solo se codifica en hexadecimal produce la siguiente respuesta:

{
  "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"
          }
        ]
      }
    ]
  }
}

Envía eventos para varios destinos

Si tus datos contienen eventos para diferentes destinos, puedes enviarlos en la misma solicitud usando referencias de destino.

Por ejemplo, si tienes un evento para el ID de acción de conversión 123456789 y otro para el ID de acción de conversión 777111122, envía ambos eventos en una sola solicitud configurando el reference de cada Destination. El reference lo define el usuario. El único requisito es que cada Destination tenga un reference único. Esta es la lista de destinations modificada para la solicitud:

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

Establece el destinationReferences de cada Event para enviarlo a uno o más destinos específicos. Por ejemplo, aquí hay un Event que solo es para el primer Destination, por lo que su lista de destinationReferences solo contiene el reference del primer Destination:

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

El campo destinationReferences es una lista, por lo que puedes especificar varios destinos para un evento. Si no configuras el destinationReferences de un Event, la API de Data Manager envía el evento a todos los destinos de la solicitud.

Si un evento tiene varios destinos, la API de Data Manager envía los campos pertinentes a cada destino. Por ejemplo, si un evento tiene un destino de Google Ads y un destino de Google Analytics, la API incluye campos de Google Analytics, como clientId o eventName, cuando envía el evento al destino de Google Analytics, y campos de Google Ads, como customVariables, cuando envía el evento al destino de Google Ads.

Próximos pasos

Configura la autenticación y tu entorno con una biblioteca cliente.
Obtén información sobre los requisitos de formato, hash y codificación para cada tipo de datos.
Obtén más información para encriptar datos del usuario.
Obtén información para recuperar diagnósticos de tus solicitudes.
Obtén más información sobre las prácticas recomendadas.
Obtén información sobre los límites y las cuotas.

Descripción general de los eventos

Enviar eventos Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Prepara destinos

Prepara los datos de eventos

Evento 1

Evento 2

Da formato a los datos

Evento 1

Evento 2

Genera un hash y codifica los datos

Evento 1

Evento 2

Convierte los datos en objetos Event

Agrega información de Google Analytics

Agrega datos del carrito para los eventos de compra

Crea el cuerpo de la solicitud

Envía la solicitud

Respuestas de éxito

Respuestas de error

Envía eventos para varios destinos

Próximos pasos

Enviar eventos

Convierte los datos en objetos `Event`