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

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

Para recuperar el diagnóstico de datos sin conexión más reciente de la cuenta, envía la siguiente consulta sobre los recursos offline_conversion_upload_client_summary con GoogleAdsService:

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.resource_name,
  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

La consulta anterior muestra un OfflineConversionUploadClientSummary separado para cada tipo de cliente que se usa en las cargas recientes. Por ejemplo, si realizaste la carga 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.

Cada OfflineConversionUploadClientSummary tiene un campo status que refleja el estado general de las cargas del client. También contiene el recuento total de eventos recibidos, el recuento de eventos procesados correctamente y un campo alerts que proporciona un resumen de errores, agrupados por OfflineConversionError. Todos estos campos contienen información del día calendario completo de cargas más reciente. Usa esta información para evaluar el estado actual de tus cargas.

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

daily_summaries

Un successful_count y una failed_count de solicitudes de carga de los últimos 7 días, agrupadas por date de carga.

job_summaries

successful_count y failed_count de las 7 solicitudes de carga más recientes, agrupadas por job_id. El job_id es un campo opcional de UploadClickConversionsRequest y UploadConversionAdjustmentsRequest. Puedes establecer job_id en un número positivo menor que 2^31 o dejar 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 mostrarán job_id.

Una situación en la que resulta útil asignar tu propio job_id es cuando tienes un solo trabajo o proceso que sube una gran cantidad de conversiones mediante varias solicitudes. Si configuras el job_id en cada una de esas solicitudes en 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, job_summaries contendrá una entrada separada para cada solicitud, lo que podría dificultar el análisis del estado general de tu trabajo.

Cómo usar los resúmenes

Para garantizar que los procesos de carga registren las conversiones y las mejoras como se espera, 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 carga a fin de reducir o eliminar esos errores.

Por ejemplo:

• Si el estado es NEEDS_ATTENTION, significa que falló una parte significativa de tus operaciones de carga. Revisa los errores en alerts y modifica el proceso de carga para reducir o eliminar esos errores.

• Si el estado es NO_RECENT_UPLOADS, significa que Google Ads no recibió ninguna carga reciente para 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, esto podría indicar que el proceso de carga que usa la API de Google Ads dejó de ejecutarse recientemente.

• Verifica el successful_count y la failed_count de daily_summaries y job_summaries para determinar si hubo una fecha de carga o un trabajo específicos que envió una gran cantidad de eventos que no se procesaron de forma correcta.

Restricciones

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

• La API de Google Ads solo muestra los 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 subir las 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, para recuperar los diagnósticos, puedes enviar una solicitud en la que customer_id coincida con el customer_id de la cuenta de administrador que usas en las cargas.

• Google Ads considera los errores CLICK_NOT_FOUND de las cargas de conversiones avanzadas de clientes potenciales como advertencias. Como resultado, si alerts contiene una entrada para este error, las operaciones correspondientes aún se consideran exitosas y se incluyen en successful_event_count.