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 o las conversiones avanzadas de clientes potenciales de Google Ads.

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

Anunciante Socio de datos

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

1. Prepara un Destination para recibir datos de eventos.
2. Prepara los datos de eventos para enviarlos.
3. Compila una solicitud de IngestionService para eventos.
4. Envía la solicitud con el Explorador de APIs de Google.
5. 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 Destination. Consulta Configura destinos para obtener más detalles y ejemplos de destinos para diferentes situaciones.

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.

Si accountType es GOOGLE_ANALYTICS_PROPERTY, las credenciales de la solicitud deben ser las de 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.

loginAccount

Es la cuenta en la que la Cuenta de Google para las credenciales es un 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 uno de los siguientes:

1. Es el ID de una conversión de Google Ads con type establecido en WEBPAGE. En la IU de Google Ads, la Fuente de conversión de una acción de conversión de WEBPAGE es Sitio web.

2. Es el ID de medición de un flujo 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 establecido en UPLOAD_CLICKS. En la IU de Google Ads, la Fuente de conversión de una acción de conversión UPLOAD_CLICKS es Sitio web (importación de clics).

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 de conversión.

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:

• Información sobre el usuario evaluada 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.
• Son 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	[e-mail] [e-mail]
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	[e-mail] [e-mail]
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 con 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:

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

2. 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 valores gclid, gbraid o wbraid establecidos Atributos de la sesión userData	Opcional	Obligatorio. Se establece en uno de los valores de enumeración para EventSource.
   Eventos enviados como 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 campos gclid, gbraid o wbraid establecido 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.

3. 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 campos disponibles.

Nota: Google Ads y Google Analytics no admiten la correlación de direcciones IP de los usuarios finales del Espacio Económico Europeo (EEE), el Reino Unido (UK) ni Suiza (CH). Agrega lógica para excluir de forma condicional el uso compartido de direcciones IP de los usuarios de estas regiones y asegúrate de proporcionar a los usuarios información clara y completa sobre los datos que recopilas en tus sitios, aplicaciones y otras propiedades, y de obtener el consentimiento cuando lo exija la ley o las políticas aplicables de Google. Consulta la página Acerca de las importaciones de conversiones sin conexión para obtener más detalles.

Cómo agregar atributos de sesión

Si envías conversiones sin conexión o conversiones avanzadas de clientes potenciales, agrega atributos de sesión cuando no estén disponibles otros identificadores de anuncios, como un GCLID o un WBRAID. También puedes incluir atributos de sesión además de otros identificadores de anuncios.

Los atributos de sesión proporcionan más contexto e indicadores sobre la interacción del usuario con tu sitio web, lo que puede mejorar la medición de conversiones, los informes y la precisión de las ofertas.

En la API del Administrador de datos, puedes usar dos enfoques para enviar atributos de sesión:

1. Recomendación: Establece el campo sessionAttributes de adIdentifiers en la cadena de atributos de sesión codificada en base64. Sigue las instrucciones que se indican en Cómo capturar session_attributes para modificar las páginas de envío de formularios y capturar la cadena codificada.

2. Si no puedes usar JavaScript, captura los campos de atributos de sesión individuales y agrega cada uno a la lista experimentalFields como un ExperimentalField independiente:

   • gad_campaignid
   • session_start_time_usec
   • gad_source
   • landing_page_url
   • landing_page_referrer

   Si tienes un valor para el atributo de sesión landing_page_user_agent, envíalo en el campo userAgent de adIdentifiers.landingPageDeviceInfo.

   Estas son las prácticas recomendadas para enviar pares clave-valor individuales:

   • Envía gad_campaignid y session_start_time_usec de forma coherente. Estos campos son fundamentales para una atribución precisa.
   • No proporciones un valor de landing_page_url inexacto o parcial, como una cadena de marcador de posición, una ruta de acceso interna a la aplicación o una URL incompleta. Omite landing_page_url si no tienes la URL completa y precisa.

   A continuación, se muestra una parte de un evento de muestra con entradas en experimentalFields para gad_campaignid y session_start_time_usec, y el agente de usuario en el campo landingPageDeviceInfo:

   {
     ...,
     "experimentalFields": [
       {
         "field": "gad_campaignid",
         "value": "21288051566"
       },
       {
         "field": "session_start_time_usec",
         "value": "1767711548052000"
       }
     ],
     "adIdentifiers": {
       "landingPageDeviceInfo": {
         "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36"
       }
     }
   }
   
   

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.

Nota: El valor de este campo debe ser purchase. De lo contrario, la API del Administrador de datos rechaza el evento con el error INVALID_EVENT_NAME.

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 del impuesto.

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 según 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. 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 de Google Analytics quantity, price o item_id. 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
}

1. 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.
2. Establece validateOnly en true para validar la solicitud sin aplicar los cambios. Cuando esté todo listo para aplicar los cambios, configura validateOnly en false.
3. Ten en cuenta que este ejemplo no usa encriptación.

Envía la solicitud

1. Copia el cuerpo de la solicitud con el botón de copiar que se encuentra en la parte superior derecha del ejemplo.
2. Haz clic en el botón API de la barra de herramientas.
3. Pega el cuerpo de la solicitud copiado en el cuadro del Cuerpo de la solicitud.
4. 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 del Administrador de datos 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.