Usa el método IngestEvents para realizar ajustes en las conversiones de Google Ads 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 Actualización desde la API de Google Ads para comparar cómo se controlan los ajustes en cada API.
Tipos de conversiones admitidos
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 clientes potenciales:
Son los eventos sin conexión que se subieron anteriormente para una acción de conversión de
UPLOAD_CLICKS.
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
transactionIdcoincide 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
transactionIdno coincide con una conversión existente, Google Ads crea una conversión nueva. Consulta Eventos no coincidentes.
Envía un ajuste
Para ajustar una conversión existente, envía una solicitud IngestEvents que incluya lo siguiente:
- Es el mismo
transactionIdque el evento original. - El mismo destino y la misma acción de conversión que el evento original
- Son los valores actualizados de los campos que deseas ajustar.
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 proporcionas.
Para obtener más información sobre cómo enviar solicitudes de transferencia, consulta Envía eventos.
Campos disponibles
En la siguiente tabla, se enumeran los campos que puedes ajustar y cómo se aplican las actualizaciones:
| Campo | Comportamiento |
|---|---|
conversionValue, currency |
Se reemplazó. El valor nuevo reemplaza el valor registrado. |
userData |
Se complementa si el evento original no tenía datos del usuario; de lo contrario, se ignora. |
Todos los demás campos, como adIdentifiers.gclid |
Ignorado |
Valores de conversión
Envía un nuevo conversionValue y currency para reafirmar el valor de una conversión registrada. El valor nuevo anula el valor registrado anteriormente en los informes y las ofertas, sin aumentar el recuento de conversiones.
Datos del usuario
A continuación, se explica cómo Google Ads maneja la información de contacto 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.
Se ignora si está presente: Si la etiqueta de Google o una carga anterior ya capturaron datos del usuario, se ignoran los datos del usuario nuevos. Los datos del usuario existentes no se reemplazan ni se agregan.
Otros campos
Los identificadores y los 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 coincidentes. Google Ads ignora estos campos y conserva los valores registrados con el evento original.
Eventos no coincidentes
Si el transactionId no coincide con un evento existente, la solicitud se trata como una carga de una 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.