Cómo supervisar el diagnóstico de datos sin conexión

Nota: En el caso de las importaciones de conversiones avanzadas de leads, usa el informe de diagnóstico de conversiones avanzadas de leads en la IU de Google Ads para supervisar el estado de tu importación.

Usa la API de Google Ads para recuperar los diagnósticos de datos sin conexión, que contienen información sobre el estado general de tus procesos de importación y ajuste de conversiones.

Para recuperar los diagnósticos de datos sin conexión más recientes de tu cuenta, usa uno de los siguientes recursos:

• offline_conversion_upload_client_summary agrega los diagnósticos de importación a nivel de la cuenta.
• offline_conversion_upload_conversion_action_summary agrega diagnósticos de importación a nivel de la acción de conversión.

Diagnóstico a nivel de la cuenta

Para recuperar los diagnósticos de carga de conversiones a nivel de la cuenta, usa la siguiente consulta de GAQL:

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

Esta consulta devuelve filas OfflineConversionUploadClientSummary independientes para cada tipo de cliente que se usó en las importaciones recientes. Por ejemplo, si recientemente importaste datos con la API de Google Ads y la IU de Google Ads, los resultados contendrán entradas independientes para los valores de client de GOOGLE_ADS_API y GOOGLE_ADS_WEB_CLIENT.

Diagnóstico a nivel de la acción de conversión

Para recuperar los diagnósticos de carga de conversiones a nivel de la acción de conversión, usa la siguiente consulta de GAQL:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = <CONVERSION_ACTION_ID>

Al igual que los diagnósticos a nivel de la cuenta, esta consulta devuelve filas OfflineConversionUploadConversionActionSummary independientes para cada tipo de cliente que se usó en las importaciones recientes. Por ejemplo, si recientemente importaste datos con la API de Google Ads y la IU de Google Ads, los resultados contendrán entradas independientes para los valores de client de GOOGLE_ADS_API y GOOGLE_ADS_WEB_CLIENT.

Cómo interpretar estos resúmenes

Cada OfflineConversionUploadClientSummary o OfflineConversionUploadConversionActionSummary tiene un campo status que refleja el estado general de las importaciones para el client. También contiene la siguiente información:

• Es el recuento de eventos totales recibidos.
• Es el recuento de eventos procesados correctamente.
• Es el recuento de eventos pendientes (eventos que aún se están procesando).
• Un campo alerts que proporciona un resumen de los errores, agrupados por OfflineConversionError.

Todos estos campos contienen información del día calendario completo más reciente de las importaciones. Usa esta información para evaluar el estado actual de tus importaciones.

Además, cada OfflineConversionUploadClientSummary o OfflineConversionUploadConversionActionSummary contiene dos tipos diferentes de informes:

daily_summaries

Un successful_count, failed_count y pending_count de solicitudes de importación de los últimos 7 días, agrupadas por date de importación.

job_summaries

El successful_count, el failed_count y el pending_count de las 7 solicitudes de importación más recientes, agrupadas por job_id. El campo job_id es opcional en UploadClickConversionsRequest y UploadConversionAdjustmentsRequest. Puedes establecer el job_id en un número no negativo menor que 2^31 o permitir que la API de Google Ads asigne un ID de trabajo generado por el sistema a tu solicitud. Independientemente de la opción que elijas, UploadClickConversionsResponse o UploadConversionAdjustmentsResponse devuelven job_id.

Un caso en el que es útil asignar tu propio job_id es cuando tienes un solo trabajo o proceso que importa una gran cantidad de conversiones con varias solicitudes. Si configuras el job_id en cada una de esas solicitudes con el mismo valor, puedes recuperar una sola entrada para el trabajo desde job_summaries. Si, en cambio, permites que la API de Google Ads asigne un valor generado por el sistema al job_id de cada solicitud, el job_summaries contendrá una entrada independiente para cada solicitud, lo que podría dificultar el análisis del estado general de tu trabajo.

Cómo usar los resúmenes

Para asegurarte de que tus procesos de importación registren las conversiones y los ajustes según lo esperado, recupera periódicamente los resúmenes de cada una de tus cuentas. Si el status de cualquier resumen no es EXCELLENT, usa la lista de errores en alerts para guiarte en la modificación del proceso de importación para reducir o eliminar esos errores.

Por ejemplo:

• Si el estado es NEEDS_ATTENTION, significa que falló una parte significativa de tus operaciones de importación. Revisa los errores en alerts y modifica tu proceso de importación para reducirlos o eliminarlos.

• Si el estado es NO_RECENT_UPLOADS, significa que Google Ads no recibió ninguna importación reciente para el client. Si esto es inesperado, revisa los procesos que realizan importaciones con ese cliente.

  Por ejemplo, si el status para GOOGLE_ADS_API es NO_RECENT_UPLOADS, eso podría indicar que tu proceso de importación que usa la API de Google Ads dejó de ejecutarse recientemente.

• Para determinar si hubo una fecha o un trabajo de importación específicos que enviaron una gran cantidad de eventos que no se pudieron procesar, verifica el successful_count, failed_count y pending_count de daily_summaries y job_summaries. Los eventos en estado pendiente pueden tardar hasta 24 horas en completarse.

Puedes encontrar más información para mejorar los diagnósticos de datos sin conexión en el Centro de ayuda.

Restricciones

Ten en cuenta lo siguiente cuando recuperes los resúmenes de importación:

• La API de Google Ads solo devuelve diagnósticos de datos sin conexión si el customer_id de la solicitud searchStream o search es el mismo cliente que usaste recientemente para importar conversiones.

  Por ejemplo, es posible que una cuenta de cliente que utiliza el seguimiento de conversiones de múltiples cuentas no contenga ningún diagnóstico. Sin embargo, puedes recuperar los diagnósticos enviando una solicitud en la que el customer_id coincida con el customer_id de la cuenta de administrador que usas en las importaciones.

• Google Ads trata los errores CLICK_NOT_FOUND de las importaciones de conversiones avanzadas de leads como advertencias. Como resultado, si alerts contiene una entrada para este error, las operaciones correspondientes se consideran exitosas y se incluyen en successful_event_count.