Asignaciones de campo

Usa las asignaciones de las tablas para asignar un objeto UploadClickConversionRequest en la API de Google Ads a su equivalente IngestEventsRequest en la API de Data Manager.

Campos de la solicitud

UploadClickConversionRequest (API de Google Ads) IngestEventsRequest (API de Data Manager) Notas
  • customer_id
  • Encabezado de la solicitud developer-token
  • Encabezado de la solicitud login-customer_id
  • Encabezado de la solicitud linked-customer-id
  • conversion_action
destinations Consulta Campos de cliente y acción de conversión.
Sin equivalente consent 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.
Sin equivalente encoding Obligatorio: Se establece en el Encoding que se usa para los valores de UserIdentifier.
Sin equivalente encryption_info Indica 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 del Administrador de datos no admite fallas parciales. Si algún campo de un objeto 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 clientes y acciones de conversión

La API de Google Ads requiere el encabezado de solicitud developer-token, y tú configuras los encabezados de solicitud login-customer-id y linked-customer-id para diferentes situaciones de autenticación.

La API de Data Manager no requiere un token de desarrollador, y la información de acceso y del cliente vinculado se especifica con campos de un objeto Destination en lugar de encabezados de solicitud. Consulta Configura destinos para obtener más información sobre los destinos.

A continuación, se muestra cómo correlacionar los campos de la API de Google Ads para un solo conversion_action con los campos equivalentes en un Destination:

API de Google Ads Destination (API de Data Manager) Notas
customer_id de la solicitud operating_account Establece account_id en el ID de cliente de la cuenta de conversiones de Google Ads. Establece el account_type del operating_account en GOOGLE_ADS.

Es posible que la API de Data Manager requiera un ID de cliente diferente del que usas para la API de Google Ads. Consulta Diferencias en los requisitos de la cuenta de destino para obtener más detalles.

Encabezado de la solicitud developer-token Sin equivalente No se requiere un token de desarrollador para la API de Data Manager.
Encabezado de la solicitud login-customer-id login_account Establece 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 Establece account_id en el ID de cliente de la cuenta vinculada. Establece account_type en DATA_PARTNER.
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 ConversionAction.
Sin equivalente reference Es un identificador definido por el usuario para el Destination. Establece este campo si envías conversiones para varias acciones de conversión en una sola solicitud.

Campos de conversión

ClickConversion (API de Google Ads) Event (API de Data Manager) Notas
cart_data cart_data Consulta Campos de datos del carrito para obtener más detalles.
consent consent Ambas APIs usan un objeto Consent similar (ad_user_data, ad_personalization).
En el caso de la API del Administrador de datos, también puedes establecer el consentimiento para todos los eventos de una solicitud configurando el campo consent a nivel de la solicitud.
conversion_action destination_references Si envías conversiones para varias acciones de conversión en una sola solicitud, establece este campo en el reference correspondiente del destino.
conversion_date_time event_timestamp
Consulta Formato de marca de tiempo para obtener más detalles.
conversion_environment Sin equivalente
conversion_value conversion_value Se establece en el valor de la moneda, no en el valor en micro unidades. Por ejemplo, para un valor de conversión de USD 5.23, usa el valor 5.23.
currency_code currency
custom_variables custom_variables Consulta Campos de variables personalizadas para obtener más detalles.
customer_type
Sin equivalente event_source
Sin equivalente event_device_info
external_attribution_data Sin equivalente
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
Sin equivalente last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes Consulta Cómo agregar atributos de sesión para obtener más información.
session_attributes_key_value_pairs experimental_fields Consulta Cómo agregar atributos de sesión para obtener más información.
user_identifiers user_data.user_identifiers Consulta Campos de identificadores del usuario para obtener más detalles.
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

Campos de datos del carrito

CartData (API de Google Ads) CartData (API de Data Manager) Notas
feed_country_code merchant_feed_label Se establece en la etiqueta de feed.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Campos de artículos para los datos del carrito

Item (API de Google Ads) Item (API de Data Manager) Notas
product_id merchant_product_id
quantity quantity
unit_price unit_price
Sin equivalente item_id
Sin equivalente additional_item_parameters

Campos de variables personalizadas

CustomVariable (API de Google Ads) CustomVariable (API de Data Manager) Notas
Sin equivalente destination_references 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.
value value

Campos de identificadores del usuario

UserIdentifier (API de Google Ads) UserIdentifier (API de Data Manager)
address_info address Sigue los lineamientos de formato y codificación hash. También puedes encriptar los atributos hash de una dirección.
hashed_email email_address Se establece en la dirección de correo electrónico con formato y hash. También puedes encriptar la dirección de correo electrónico hasheada.
hashed_phone_number phone_number Se establece en el número de teléfono con formato y codificado con hash. También puedes encriptar el número de teléfono hasheado.
Otros campos:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
No es relevante 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 los admite cuando se envían eventos de conversión como una fuente de datos adicional.

Campos de respuesta

UploadClickConversionResponse (API de Google Ads) IngestEventsResponse (API de Data Manager) Notas
job_id Sin equivalente Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
partial_failure_error Sin equivalente La API del Administrador de datos no admite fallas parciales. Si algún campo de un objeto 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 devuelve 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. Verifica los resultados del procesamiento con el diagnóstico.