Ajustes de conversión

Usa el método IngestEvents para realizar ajustes en las conversiones de anuncios de Google registradas anteriormente. En la API de Data Manager, un ajuste puede rectificar un valor de conversión o complementar los datos del usuario.

Si migras desde la API de Google Ads, consulta Actualiza desde la API de Google Ads para comparar cómo se manejan los ajustes en cada API.

Tipos de conversiones compatibles

Puedes ajustar los siguientes tipos de conversiones de Google Ads:

• Conversiones desde varias fuentes: Son las conversiones que registra la etiqueta de Google de tu sitio web para una acción de conversión de WEBSITE.
• Conversiones sin conexión y conversiones avanzadas de leads: Son eventos sin conexión subidos anteriormente para una acción de conversión de UPLOAD_CLICKS.

Nota: No se admiten los ajustes de las conversiones de ventas en la tienda.

Cómo funcionan los ajustes

Dentro de la misma acción de conversión, Google Ads correlaciona los eventos con los siguientes parámetros transactionId:

• Si el transactionId coincide con una conversión existente para la misma acción de conversión, la API de Data Manager trata la solicitud como un ajuste de conversión.
• Si el transactionId no coincide con una conversión existente, Google Ads crea una conversión nueva. Consulta Eventos sin coincidencias.

Cómo enviar un ajuste

Para ajustar una conversión existente, envía una solicitud IngestEvents que incluya lo siguiente:

• El mismo transactionId que el evento original
• El mismo destino y la misma acción de conversión que el evento original.
• Los valores actualizados de los campos que deseas ajustar.
• Todos los campos obligatorios para un evento, incluido al menos un identificador, como adIdentifiers o userData. Consulta los requisitos de eventos y de identificadores para las conversiones sin conexión o las conversiones de varias fuentes.

Punto clave: La API de Data Manager valida cada evento cuando recibe la solicitud, antes de buscar un transactionId coincidente. Un ajuste debe cumplir con los mismos requisitos de campo y de identificador que un evento nuevo. De lo contrario, la solicitud falla con un error, como NO_IDENTIFIERS_PROVIDED.

Te recomendamos que envíes los mismos identificadores que enviaste o capturaste con el evento original. Si el transactionId no coincide con una conversión existente, Google Ads usa estos identificadores para atribuir la conversión nueva.

No es necesario que especifiques un tipo de ajuste. La API de Data Manager infiere cómo procesar la solicitud en función de transactionId y los campos que proporciones.

Para obtener más información sobre el envío de solicitudes de transferencia, consulta las guías para enviar eventos de conversiones sin conexión o conversiones de múltiples fuentes.

Campos disponibles

En la siguiente tabla, se indica cómo Google Ads aplica cada campo cuando un evento coincide con una conversión existente:

Campo	Comportamiento
conversionValue, currency	Reemplazado. El valor nuevo reemplaza el valor registrado.
userData	Se complementan si el evento original no tenía datos del usuario; de lo contrario, se ignoran.
Todos los demás campos, como adIdentifiers.gclid	No se actualizó. Google Ads conserva los valores registrados con el evento original. Los campos obligatorios deben seguir presentes.

Valores de conversión

Envía un conversionValue y un currency nuevos para rectificar el valor de una conversión registrada. El valor nuevo anula el valor registrado anteriormente en los informes y las ofertas, sin incrementar el recuento de conversiones.

Nota: Durante el período de prueba inicial de 14 días para las conversiones desde varias fuentes, las actualizaciones de valor están inhabilitadas. El valor de la etiqueta no se reemplazará en los informes de Google Ads hasta que finalice el período de prueba.

Datos del usuario

A continuación, se indica cómo Google Ads controla los userData, como una dirección de correo electrónico o un número de teléfono:

• Se complementan si faltan: Si el evento original se capturó sin datos del usuario, el ajuste adjunta los datos del usuario para mejorar la atribución.

  Nota: Para obtener un rendimiento óptimo, te recomendamos que subas los datos complementarios sin conexión en un plazo de 24 horas después del evento original.

• Se ignoran si están presentes: Si la etiqueta de Google o una carga anterior ya capturaron datos del usuario, se ignorarán los datos del usuario nuevos. Los datos del usuario existentes no se reemplazan ni se agregan.

Otros campos

Los identificadores y metadatos que no sean el valor de conversión, la moneda y los datos del usuario, como adIdentifiers.gclid, no se pueden actualizar para los eventos que coincidan. Google Ads conserva los valores registrados con el evento original.

Aún debes incluir cualquiera de estos campos que sean obligatorios, como al menos un identificador. La API de Data Manager los valida para cada evento.

Eventos no coincidentes

Si el transactionId no coincide con un evento existente, la solicitud se trata como una carga de conversión nueva en lugar de un ajuste.

Google Ads intenta atribuir la nueva conversión a un clic en el anuncio con los identificadores que proporcionaste, como adIdentifiers.gclid o userData.

Nota: Durante el período de prueba inicial de 14 días para las conversiones de múltiples fuentes, las conversiones creadas recientemente aparecen en los informes, pero no se usarán para las ofertas. Una vez que finalice la prueba, automáticamente serán aptas para ofertas.