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 permiso 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 configurando el campo consent de Event.
No hay equivalente
encoding
Obligatorio: Se establece en el Encoding que se usa para los valores de UserIdentifier.
No hay equivalente
encryption_info
Se establece si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
job_id
No hay equivalente
Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
partial_failure
No hay 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.
La API de Google Ads requiere el encabezado de la solicitud developer-token, y tú estableces los encabezados de la solicitudlogin-customer-id y linked-customer-id
para diferentes situaciones de autenticación.
La API de Data Manager no requiere un token de desarrollador, y debes especificar la información de acceso y del cliente vinculado 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 un solo 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 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 account_id en el ID de cliente de la cuenta vinculada y establece account_type en DATA_PARTNER. De lo contrario, no configures 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 del 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 configurando el campo consent a nivel de la solicitud.
La API de Google Ads requiere solicitudes independientes para cada 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 del nombre de un recurso.
Ninguna de las APIs admite estos identificadores para las conversiones sin conexión ni las conversiones avanzadas de clientes potenciales,
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
No hay 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.
[[["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-10-21 (UTC)"],[],[]]
