La API de Data Manager requiere credenciales con un alcance diferente al de la API de Google Ads. Sigue los pasos que se indican en
Configura el acceso a la API para generar credenciales nuevas
que incluyan el alcance de la API de Data Manager.
Es la configuración de consentimiento predeterminada opcional para los eventos de la solicitud. Puedes anular este valor para un evento individual si configuras el campo consent de Event.
Sin equivalente
encoding
Obligatorio: Se establece en la Encoding que se usa para los valores de UserIdentifier.
Sin equivalente
encryption_info
Se establece si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
job_id
Sin equivalente
Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
partial_failure
Sin equivalente
La API de Data Manager usa un modelo de error de falla rápida. Si algún campo de un IngestEventsRequest no pasa la validación, la API de Data Manager rechaza toda la solicitud.
validate_only
validate_only
conversions
events
Es la lista de conversiones o eventos. Consulta la sección Campos de conversión para obtener más detalles.
Campos de cliente y acción de conversión
La API de Google Ads requiere el developer-token encabezado de la solicitud, y debes configurar los
login-customer-id y linked-customer-idencabezados de la solicitud para diferentes situaciones de autenticación.
La API de Data Manager no requiere un token de desarrollador, y debes especificar la información del cliente vinculado y de acceso con los campos de un Destination en lugar de los encabezados de la solicitud. Consulta Configura destinos para obtener más
información sobre los destinos.
A continuación, se muestra cómo asignar los campos de la API de Google Ads para una sola conversion_action a los campos equivalentes en un Destination:
No se requiere un token de desarrollador para la API de Data Manager.
Encabezado de la solicitud login-customer-id
login_account
Establece el account_id en el ID de cliente de la cuenta de acceso. Establece account_type en GOOGLE_ADS si la cuenta de acceso es una cuenta de Google Ads o en DATA_PARTNER si la cuenta de acceso es una cuenta de socio de datos.
Encabezado de la solicitud linked-customer-id
linked_account
Si accedes a operating_account con un vínculo de socio, establece el account_id en el ID de cliente de la cuenta vinculada y establece account_type en DATA_PARTNER. De lo contrario, no establezcas el campo linked_account.
conversion_action de un ClickConversion
product_destination_id
Se establece en el ID numérico de la acción de conversión. No uses el nombre de recurso de ConversionAction.
Ambas APIs usan un objeto Consent similar (ad_user_data, ad_personalization).
En el caso de la API de Data Manager, también puedes establecer el consentimiento para todos los eventos de
una solicitud si configuras el campo consent a nivel de la solicitud.
La API de Google Ads requiere solicitudes independientes por acción de conversión. La API de Data Manager admite el envío de conversiones para varias acciones de conversión en una sola solicitud, así como el uso de este campo destination_references para indicar qué destinos deben recibir una variable personalizada específica.
conversion_custom_variable
variable
Se establece en el nombre de la variable en lugar de un nombre de recurso.
Ninguna de las APIs admite estos identificadores para las conversiones sin conexión ni las conversiones avanzadas de leads, y la API de Data Manager no admite estos identificadores cuando se envían eventos de conversión como una fuente de datos adicional.
Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
partial_failure_error
Sin equivalente
La API de Data Manager usa un modelo de error de falla rápida. Si algún campo de un IngestEventsRequest no pasa la validación, la API de Data Manager rechaza toda la solicitud.
request-id Encabezado de respuesta
request_id
El ID de solicitud se muestra como un campo de respuesta en la API de Data Manager en lugar de como un encabezado de respuesta.
results
Sin equivalente
La API de Data Manager procesa los eventos de forma asíncrona. Consulta los resultados del procesamiento con los diagnósticos.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-07-28 (UTC)"],[],[]]
