Solución de problemas

La administración de conversiones requiere una integración compleja, que suele implicar varias herramientas y procesos interdependientes. En esta guía, se ofrecen pasos detallados que puedes seguir para solucionar problemas que tengas, ya sea que recibas errores de la API que no comprendas o que tengas dudas sobre las métricas o los diagnósticos que ves en la IU.

Cómo leer las métricas en la IU de Google Ads

La IU de Google Ads no organiza las métricas de conversiones por fecha de importación, por lo que usar los informes de campañas en la IU para verificar los resultados de la importación puede ser engañoso. Para verificar el estado de la importación a nivel de las solicitudes a la API, comienza con el diagnóstico de datos sin conexión. Los diagnósticos de datos sin conexión no evalúan la coincidencia de etiquetas asíncronas ni la calidad del identificador de usuario para las conversiones avanzadas. Para verificar el estado de las coincidencias, consulta los informes de diagnóstico de la IU de Google Ads para las conversiones avanzadas de leads y las conversiones avanzadas de sitios web. Para conocer los pasos para solucionar problemas, consulta Alertas de diagnóstico de la IU después de una carga exitosa de la API.

Problemas con las conversiones avanzadas de leads

Esta sección se centra en abordar los problemas habituales que se producen cuando se importan conversiones avanzadas de leads.

Errores comunes

La siguiente guía te ayudará a diagnosticar y corregir errores comunes relacionados con las conversiones avanzadas de leads.

Error
NO_CONVERSION_ACTION_FOUND

La acción de conversión especificada no está habilitada o la cuenta no puede acceder a ella en el campo customer_id de la solicitud. Confirma que la acción de conversión en tu carga esté habilitada y que su propietario sea el cliente de conversión de Google Ads del clic o una cuenta en la jerarquía de seguimiento de conversiones de la cuenta de carga.

Este error también puede ocurrir si el GCLID de la solicitud pertenece a una cuenta de cliente que no tiene acceso a la acción de conversión especificada en la solicitud. Puedes verificar si un GCLID pertenece a una cuenta de cliente con el recurso click_view. Para ello, envía una consulta que filtre por click_view.gclid y segments.date, donde la fecha sea la fecha en que se produjo el clic.

INVALID_CONVERSION_ACTION_TYPE La acción de conversión especificada tiene un tipo que no es válido para las conversiones avanzadas de leads. Asegúrate de que el ConversionAction especificado en tu solicitud de carga tenga el tipo UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Asegúrate de haber habilitado las conversiones avanzadas de leads en tu configuración de conversiones. Encuentra instrucciones para esto en la guía de requisitos previos.
DUPLICATE_ORDER_ID Los eventos importados incluyen varias conversiones con el mismo ID de pedido y no se procesaron. Asegúrate de que los IDs de pedido sean únicos y vuelve a intentarlo.
CLICK_NOT_FOUND No se encontró ningún clic que coincidiera con los identificadores de usuario proporcionados.

Si una conversión encuentra esta advertencia, la API de Google Ads la incluye en el successful_event_count de tus diagnósticos de datos sin conexión. La API de Google Ads incluye una entrada para CLICK_NOT_FOUND en la colección alerts, de modo que puedas supervisar la frecuencia de esta advertencia.

Este error se espera si el clic no proviene de una campaña de Google Ads. Por ejemplo, puede provenir de SA360 o DV360. Otras causas posibles son las siguientes:

En los casos poco frecuentes en los que el cliente que sube los datos es diferente del cliente de conversión de Google Ads, este error puede significar que el cliente que sube los datos aceptó las condiciones de los datos del cliente, pero el cliente que publica los anuncios no lo hizo.

Para determinar si una cuenta aceptó las condiciones de los datos de los clientes, consulta el recurso customer y verifica el campo customer.conversion_tracking_setting.accepted_customer_data_terms.

Discrepancias en las métricas

Ten en cuenta los siguientes problemas habituales:

  • Es posible que nuestra canalización de procesamiento descarte las conversiones por varios motivos, y estas no se podrán recuperar. Consulta Discrepancias en los datos después de una carga exitosa para obtener más información.

  • Verifica que la etiqueta de Google esté configurada correctamente en tu página web y que se active cuando se envíen formularios de clientes potenciales. Si tu etiqueta no se activa cuando se envían formularios o si envía datos incorrectos, es probable que veas una atribución baja o nula en las conversiones subidas. Revisa nuestros artículos del Centro de ayuda sobre cómo configurar la etiqueta de Google y configurar Google Tag Manager para las conversiones avanzadas de leads.

  • Si utilizas conversiones avanzadas de leads sin la etiqueta de Google en tu página web, debes incluir el GCLID en tus importaciones de conversiones configurando el campo ClickConversion.gclid en cada conversión.

  • Verifica que especifiques correctamente el consentimiento en tus cargas. Para ello, puedes establecer la configuración de consentimiento predeterminada para tu cuenta (en la IU de Google Ads, haz clic en Herramientas > Administrador de datos > Configuración de consentimiento) o establecer el campo ClickConversion.consent en cada conversión subida.

Problemas con el rendimiento de la campaña

Si no tienes problemas técnicos para subir tus conversiones y estás conforme con las métricas que se presentan, pero no ves las mejoras esperadas en el rendimiento de la campaña, o la "efectividad", después de implementar las conversiones avanzadas de leads, comunícate con el equipo de Asistencia de productos de Google Ads para obtener ayuda.

Problemas con las conversiones avanzadas de sitios web

Esta sección se centra en abordar los problemas habituales que se producen cuando se importan conversiones avanzadas de sitios web.

Errores comunes

La siguiente guía te ayudará a diagnosticar y corregir errores comunes relacionados con las conversiones avanzadas de sitios web.

Error
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS No se aceptaron los Términos y Condiciones de los datos del cliente para el customer_id de la solicitud. Encuentra instrucciones para esto en la guía de requisitos previos.
CONVERSION_ALREADY_ENHANCED Esta conversión ya recibió un ajuste de ENHANCEMENT con los campos order_id y conversion_action proporcionados. Asegúrate de proporcionar un valor order_id único para cada conversión.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT El conversion_action proporcionado no es apto para las conversiones avanzadas de sitios web. En la IU de Google Ads, asegúrate de marcar la casilla Activar las conversiones avanzadas en la acción de conversión a la que se hace referencia en tu solicitud. Encuentra instrucciones para hacerlo en el Centro de ayuda.
INVALID_USER_IDENTIFIER Un campo de identificador de usuario con codificación hash (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name o hashed_street_address) no es un resumen SHA-256 hexadecimal válido de 64 caracteres. Normaliza y aplica un algoritmo hash a los datos proporcionados por el usuario antes de importarlos. Para obtener instrucciones, consulta Cómo normalizar y aplicar codificación hash a los datos proporcionados por el usuario.
CONVERSION_NOT_FOUND

Google Ads no pudo encontrar una conversión que coincida con el campo conversion_action y el identificador de conversión (order_id o gclid_date_time_pair) proporcionados. Este error solo se aplica a los ajustes de RESTATEMENT y RETRACTION. Para obtener más detalles, consulta los requisitos en Importa ajustes de conversiones.

Para los ajustes de ENHANCEMENT, la API acepta la solicitud sin devolver un error CONVERSION_NOT_FOUND y evalúa la coincidencia de order_id de la etiqueta con la API de forma asíncrona. Los porcentajes altos de valores de order_id que no coinciden activan una alerta de discrepancia de ID de pedido en el informe de diagnóstico de conversiones avanzadas en la IU de Google Ads. Para conocer los pasos para solucionar problemas, consulta Alertas de diagnóstico de la IU después de una carga exitosa de la API.

Alertas de diagnóstico de la IU después de una carga exitosa de la API

Cuando subes ajustes de ENHANCEMENT con el servicio ConversionAdjustmentUploadService, la API valida el formato de la solicitud en el momento de la transferencia y hace coincidir las mejoras con los eventos de la etiqueta del sitio web de forma asíncrona. Como resultado, las solicitudes a la API pueden tener éxito sin errores en el campo partial_failure_error y mostrar un estado EXCELLENT en el diagnóstico de datos sin conexión. Al mismo tiempo, el informe de diagnóstico de conversiones avanzadas en la IU de Google Ads puede seguir mostrando alertas.

Verifica las siguientes causas cuando aparezcan alertas de diagnóstico de la IU después de cargas correctas de la API:

  • Faltan campos de dirección obligatorios: Un objeto OfflineUserAddressInfo en el campo address_info requiere cuatro campos en la misma entrada: hashed_first_name, hashed_last_name, country_code y postal_code. Los campos hashed_street_address, city y state son opcionales (si completas el campo hashed_street_address, debe ser un resumen hexadecimal SHA-256 válido de 64 caracteres). La API acepta objetos address_info parciales no vacíos (como solo el nombre y el apellido) sin devolver un error en el campo partial_failure_error. Sin embargo, la coincidencia descendente descarta las direcciones incompletas y activa una alerta para los campos de dirección faltantes. Si alguno de los cuatro campos obligatorios no está disponible, omite el objeto UserIdentifier para el campo address_info.

  • Faltan IDs de transacción en los eventos de la etiqueta del sitio web: Si omites el campo order_id de un ajuste de ENHANCEMENT en la API, se devuelve un error FieldError.REQUIRED síncrono. Cuando tus solicitudes a la API incluyen el campo order_id, una alerta de la IU sobre un ID de transacción faltante en el evento de conversión hace referencia a la etiqueta de tu sitio web. Esta alerta aparece cuando menos del 90% de los eventos de la etiqueta de conversión en el sitio web incluyen un ID de transacción válido (o cuando la etiqueta envía cadenas de marcador de posición, como "undefined" o "null"). Configura tu etiqueta de conversión en el sitio web para que envíe un ID de transacción único para cada evento de conversión.

  • No coinciden los IDs de pedido de la etiqueta y de la API, o bien las cargas se realizaron tarde: En el caso de los ajustes de ENHANCEMENT, la API no devuelve un error CONVERSION_NOT_FOUND ni CONVERSION_EXPIRED en el momento de la carga. En cambio, los valores de order_id que no coinciden activan una alerta de discrepancia de ID de pedido en la IU, y las mejoras subidas más de 24 horas después de la conversión activan una alerta de carga tardía. Haz coincidir el campo order_id de la API con la cadena exacta del ID de transacción que envía tu etiqueta de conversión del sitio web y sube la mejora en un plazo de 24 horas a partir del evento de conversión.

  • Datos del usuario sin normalizar con codificación hash antes de la carga: La codificación hash de valores sin normalizar, como letras mayúsculas, espacios en blanco al principio o al final, o números de teléfono que no tienen el formato E.164, produce un resumen hexadecimal SHA-256 válido de 64 caracteres. La API acepta la carga sin devolver un error INVALID_USER_IDENTIFIER, mientras que la coincidencia downstream falla e informa alertas de formato o de bajo porcentaje de coincidencias. Sigue las reglas de normalización que se indican en Normaliza y genera un hash de los datos proporcionados por el usuario.

  • Volumen bajo de mejoras de la API en relación con el volumen de etiquetas del sitio web: Los diagnósticos de la IU comparan las mejoras de la API sin duplicados que contienen identificadores de usuario con los eventos de etiquetas del sitio web sin duplicados y con consentimiento:

    • Configuración del modo de consentimiento: Cuando el modo de consentimiento en la etiqueta de Google indica el parámetro de configuración ad_storage='denied', los diagnósticos de la IU excluyen de la comparación los eventos de etiquetas del sitio web sin consentimiento, por lo que omitir esos eventos de las cargas de la API no activa una alerta de volumen bajo. Sin embargo, las alertas de discrepancias en el manejo del consentimiento entre la etiqueta de tu sitio web y los activadores de backend indican lo siguiente:

      • La etiqueta no tiene ad_storage='denied', el backend omite la carga: El diagnóstico de la IU cuenta los eventos de la etiqueta como con consentimiento y, además, informa una alerta de cobertura baja.
      • Indicadores de etiquetas ad_storage='denied', mejora de las cargas de backend: Las mejoras subidas carecen de un evento de etiqueta con consentimiento coincidente y contribuyen a las alertas de discrepancia de ID de pedido.

      Aplica el mismo estado de consentimiento a la etiqueta de tu sitio web y a las cargas de mejoras de la API.

    • Eventos anónimos en el sitio web: No habilites las conversiones avanzadas en las acciones de conversión del embudo superior (como las vistas de página o de artículos) en las que la etiqueta del sitio web se activa para los visitantes anónimos. Si tu servidor envía mejoras de la API solo para los usuarios que accedieron con datos de contacto conocidos, los eventos de etiquetas anónimas que no coinciden activan una alerta de cobertura baja. Habilita las conversiones avanzadas solo en las acciones de conversión en las que los datos proporcionados por el usuario estén disponibles de forma coherente.

Problemas generales con la administración de conversiones

Ten en cuenta los siguientes problemas habituales:

  • Si intentas establecer cualquier campo de tipo enum en UNKNOWN, se producirá un error RequestError.INVALID_ENUM_VALUE. Este es un problema común cuando se especifica consent, ya que es posible que el anunciante no sepa si se otorgó el consentimiento. Si se desconoce el estado de consent, se debe establecer en DENIED.

  • Cuando creas una acción de conversión para las conversiones de aplicaciones o las estadísticas de aplicaciones de Firebase y de terceros, solo puedes mutar el campo app_id en el momento de la creación. Una vez que se crea la acción de conversión, este campo no se puede cambiar.

  • Cuando creas una acción de conversión, solo puedes establecer el campo ConversionAction.attribution_model_settings.attribution_model en GOOGLE_ADS_LAST_CLICK o GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Cualquier otra opción generará un error CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Nuestra entrada de blog en la que se anuncia la baja de otros modelos de atribución tiene más detalles.

  • El rango permitido para el campo click_through_lookback_window_days es de 1 a 60 días para las acciones de conversión con el tipo AD_CALL y WEBSITE_CALL. Para la mayoría de las demás acciones de conversión, el rango permitido es de 1 a 90 días.

  • El rango permitido para el campo view_through_lookback_window_days es de 1 a 30 días para la mayoría de las acciones de conversión. Este campo debe estar sin configurar para las acciones de conversión de tipo AD_CALL y WEBSITE_CALL.

  • Si configuras o actualizas el campo include_in_conversions_metric en una acción de conversión, se producirá un error FieldError.IMMUTABLE_FIELD. En su lugar, establece el campo primary_for_goal, como se describe en la guía de objetivos de conversión.

  • Cuando crees una acción de conversión de tipo WEBSITE_CALL o AD_CALL, el value_settings.always_use_default_value debe establecerse en true. Si especificas un valor de false, se producirá un error INVALID_VALUE.

Errores comunes

La siguiente guía te ayuda a diagnosticar y corregir errores comunes con las importaciones de conversiones sin conexión, incluidos los errores de acceso al seguimiento de conversiones de múltiples cuentas.

Error
INVALID_CONVERSION_ACTION_TYPE La acción de conversión especificada tiene un tipo que no es válido para subir conversiones por clic. Asegúrate de que el ConversionAction especificado en tu solicitud de carga tenga el tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND La acción de conversión especificada no está habilitada o la cuenta no puede acceder a ella en el campo customer_id de la solicitud. Recupera información sobre la configuración del seguimiento de conversiones para confirmar que la acción de conversión esté habilitada. El propietario de la acción de conversión debe ser el cliente de conversión de Google Ads del clic o una cuenta en la jerarquía de seguimiento de conversiones de la cuenta de carga. Por ejemplo, este error se produce si la acción de conversión pertenece a una cuenta de administrador anterior que se desvinculó después del clic.
TOO_RECENT_CONVERSION_ACTION La acción de conversión se creó recientemente. Espera al menos 6 horas después de crear la acción antes de volver a intentar subir las conversiones con errores.
INVALID_CUSTOMER_FOR_CLICK El campo customer_id de la solicitud no coincide con el cliente de conversión de Google Ads en el momento del clic. Este error se produce cuando la cuenta que sube los datos tampoco tiene acceso entre cuentas a la acción de conversión. Actualiza el campo customer_id de la solicitud a una cuenta en la jerarquía del propietario de la acción de conversión.
EVENT_NOT_FOUND Google Ads no puede encontrar la combinación de ID de clic y customer_id. Revisa los requisitos de customer_id y confirma que estás subiendo los datos con la cuenta de Google Ads correcta.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Varias conversiones de la solicitud tienen la misma combinación de ID de clic, conversion_date_time y conversion_action. Quita las conversiones duplicadas de tu solicitud.
CLICK_CONVERSION_ALREADY_EXISTS Ya se subió una conversión con la misma combinación de ID de clic, conversion_date_time y conversion_action. Ignora este error si estabas volviendo a intentar la carga y esta conversión se realizó correctamente antes. Si deseas agregar otra conversión además de la que subiste anteriormente, ajusta el conversion_date_time de ClickConversion para evitar duplicar la conversión que subiste antes.
EXPIRED_EVENT El clic importado ocurrió antes del período especificado en el campo click_through_lookback_window_days. Un cambio en la click_through_lookback_window_days solo afecta los clics registrados después del cambio, por lo que cambiar la ventana de visualización no resolvería este error para el clic en particular. Si corresponde, cambia la conversion_action por otra acción con una ventana de visualización más larga.
CONVERSION_PRECEDES_EVENT La conversion_date_time es anterior a la fecha y hora del clic. Actualiza el conversion_date_time a un valor posterior.
VALUE_MUST_BE_UNSET

El ClickConversion tiene un valor establecido para gbraid o wbraid (sin un gclid) y tiene un valor para custom_variables o cart_data, que Google Ads no admite con gbraid o wbraid. Anula la configuración del campo en conflicto.
Anterior
Informes