Usa la API de Google Ads para obtener diagnósticos de datos sin conexión, que contienen 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 tu 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 usado en las cargas recientes. Por ejemplo, si recientemente
subiste contenido con la API de Google Ads y la IU de Google Ads, los resultados contienen entradas
independientes para los valores de client
de GOOGLE_ADS_API
y GOOGLE_ADS_WEB_CLIENT
.
Cada OfflineConversionUploadClientSummary
tiene un campo status
que refleja el estado general de las cargas para el client
. También contiene el recuento del total de eventos
recibidos, el recuento de eventos procesados correctamente y 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 cargas. 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 unfailed_count
de solicitudes de carga de los últimos 7 días, agrupados pordate
de carga. job_summaries
El
successful_count
y lafailed_count
de las 7 solicitudes de carga más recientes, agrupadas porjob_id
.job_id
es un campo opcional deUploadClickConversionsRequest
yUploadConversionAdjustmentsRequest
. Puedes configurarjob_id
como un número no negativo menor que2^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
oUploadConversionAdjustmentsResponse
muestrajob_id
.Una situación en la que asignar tu propio
job_id
es útil es cuando tienes un solo trabajo o proceso que sube una gran cantidad de conversiones mediante varias solicitudes. Si configuras eljob_id
de cada una de esas solicitudes con el mismo valor, puedes recuperar una sola entrada para el trabajo desdejob_summaries
. En cambio, si permites que la API de Google Ads asigne un valor generado por el sistema aljob_id
de cada solicitud,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 resúmenes
Para garantizar que los procesos de carga registren las conversiones y las mejoras según lo previsto, 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 de alerts
como guía en la modificación del proceso de carga para reducir o eliminar esos errores.
Por ejemplo:
Si el estado es
NEEDS_ATTENTION
, significa que una parte significativa de tus operaciones de carga falló. Revisa los errores enalerts
y modifica el proceso de carga para reducirlos o eliminarlos.Si el estado es
NO_RECENT_UPLOADS
, significa que Google Ads no recibió ninguna carga reciente para elclient
. Si esto es inesperado, revisa los procesos que realizan cargas con ese cliente.Por ejemplo, si el
status
paraGOOGLE_ADS_API
esNO_RECENT_UPLOADS
, esto podría indicar que el proceso de carga que usa la API de Google Ads dejó de ejecutarse recientemente.Verifica los elementos
successful_count
yfailed_count
dedaily_summaries
yjob_summaries
para determinar si un trabajo o una fecha de carga específicos envió una gran cantidad de eventos que no se procesaron de forma correcta.
Restricciones
Cuando recuperes los resúmenes de cargas, ten en cuenta lo siguiente:
La API de Google Ads solo muestra diagnósticos de datos sin conexión si el
customer_id
de la solicitudsearchStream
osearch
es el mismo cliente que usaste recientemente para subir conversiones.Por ejemplo, es posible que una cuenta de cliente que utilice el seguimiento de conversiones de múltiples cuentas no contenga ningún diagnóstico. Sin embargo, puedes recuperar diagnósticos mediante el envío de una solicitud en la que
customer_id
coincida con elcustomer_id
de la cuenta de administrador que usas en las cargas.Google Ads considera que los errores
CLICK_NOT_FOUND
de las cargas de conversiones avanzadas de clientes potenciales son advertencias. Como resultado, sialerts
contiene una entrada para este error, las operaciones correspondientes aún se consideran exitosas y se incluyen ensuccessful_event_count
.