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

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

Para recuperar el diagnóstico de datos sin conexión más reciente de tu cuenta, utiliza uno de los siguientes recursos:

Diagnóstico a nivel de la cuenta

Para recuperar diagnósticos de la carga de conversiones a nivel de la cuenta, utilice lo 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 resultados separados OfflineConversionUploadClientSummary filas para cada tipo de cliente que se usó en las cargas recientes. Por ejemplo, si subidos recientemente con la API de Google Ads y la IU de Google Ads, los resultados contienen entradas separadas para los valores client de GOOGLE_ADS_API y GOOGLE_ADS_WEB_CLIENT

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

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

SELECT
  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 = < INSERT CONVERSION ACTION ID >

Al igual que en el diagnóstico a nivel de la cuenta, esta consulta muestra resultados OfflineConversionUploadConversionActionSummary filas para cada tipo de cliente que se usó en las cargas recientes. Por ejemplo, si subidos recientemente con la API de Google Ads y la IU de Google Ads, los resultados contienen entradas separadas para los valores 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 salud general de cargas para el client. También contiene la siguiente información:

  • La cantidad total de eventos recibidos.
  • La cantidad de eventos procesados correctamente.
  • 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 cargas. Usa esta información para evaluar el estado actual de tus cargas.

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

daily_summaries
Un successful_count, failed_count y pending_count de solicitudes de carga de los últimos 7 días, agrupados por fecha de carga date.
job_summaries

La successful_count, la failed_count y la pending_count de las 7 más Solicitudes de carga recientes, agrupadas por job_id. job_id es un campo opcional de UploadClickConversionsRequest y UploadConversionAdjustmentsRequest Puedes configurar job_id a un número no negativo menor que 2^31 o permita que la API de Google Ads asigne un o el ID de trabajo generado por el sistema para tu solicitud. Independientemente de la opción elige la UploadClickConversionsResponse o UploadConversionAdjustmentsResponse muestra job_id.

Una situación en la que asignar tu propio job_id es útil es cuando tienes un único trabajo o proceso que sube una gran cantidad de conversiones mediante múltiples solicitudes. Si estableces job_id en cada una de esas solicitudes en la mismo valor, puedes recuperar una sola entrada para el trabajo job_summaries Si, en cambio, permites que la API de Google Ads asigne un grupo de anuncios generado por valor a la job_id de cada solicitud, el job_summaries contiene una capa entrada para cada solicitud, lo que podría dificultar el análisis del estado general de para que tu trabajo sea más desafiante.

Cómo usar resúmenes

Para garantizar que los procesos de carga registren las conversiones y mejoras como recupera periódicamente los resúmenes de cada una de sus cuentas. Si el botón status de cualquier resumen no es EXCELLENT, usa la lista de errores en alerts para guiarte en la modificación del proceso de carga para reducir o eliminar esos errores.

Por ejemplo:

  • Si el estado es NEEDS_ATTENTION, entonces una parte significativa de tu no se pudieron realizar las operaciones de carga. Revisa los errores en alerts y modifica la de carga para reducir o eliminar esos errores.

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

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

  • Para determinar si hay un trabajo o una fecha de carga específicos que hayan enviado una gran la cantidad de eventos que no se pudieron procesar, revisa successful_count failed_count y pending_count de daily_summaries y job_summaries. Los eventos con estado pendiente pueden tardar hasta 24 horas en completarse.

Restricciones

Cuando recuperes los resúmenes de cargas, ten en cuenta lo siguiente:

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

    Por ejemplo, una cuenta de cliente que usa el seguimiento de conversiones de múltiples cuentas podría no contienen diagnósticos. Sin embargo, puedes recuperar diagnósticos enviando una solicitud en la que customer_id coincide con customer_id del administrador y la cuenta que usas en las cargas.

  • Google Ads trata CLICK_NOT_FOUND errores de las conversiones avanzadas de clientes potenciales como advertencias Como como resultado, si alerts contiene una entrada para este error, la respuesta las operaciones aún se consideran exitosas y se incluyen en el successful_event_count