Monitorar diagnósticos de dados off-line

Use a API Google Ads para recuperar diagnóstico de dados off-line, que contêm informações sobre a integridade geral do upload de conversões e e ajustes nos processos.

Para recuperar os diagnósticos de dados off-line mais recentes da sua conta, use um dos seguintes recursos:

Diagnóstico no nível da conta

Para recuperar diagnósticos de upload de conversões no nível da conta, use o seguinte: Consulta 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 retorna valores OfflineConversionUploadClientSummary linhas para cada tipo de cliente usado nos uploads recentes. Por exemplo, se você enviado recentemente usando a API Google Ads e a interface do Google Ads, os resultados contêm entradas separadas para os valores client de GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT

Diagnóstico no nível da ação de conversão

Para recuperar diagnósticos de upload de conversões no nível da ação de conversão, use a seguinte consulta 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 >

Assim como nos diagnósticos no nível da conta, essa consulta retorna OfflineConversionUploadConversionActionSummary linhas para cada tipo de cliente usado nos uploads recentes. Por exemplo, se você enviado recentemente usando a API Google Ads e a interface do Google Ads, os resultados contêm entradas separadas para os valores client de GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT

Como interpretar esses resumos

Cada OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary tem um campo status, que reflete a saúde geral de uploads para client. Ela também contém as seguintes informações:

  • A contagem do total de eventos recebidos.
  • A contagem de eventos processados.
  • A contagem de eventos pendentes (eventos que ainda estão sendo processados).
  • Um campo alerts, que fornece um resumo dos erros, agrupados por OfflineConversionError.

Todos esses campos contêm informações do dia completo mais recente de uploads. Use essas informações para avaliar a integridade atual dos seus envios.

Além disso, cada OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary contém duas tipos de relatório:

daily_summaries
Uma successful_count, failed_count e pending_count de solicitações de upload dos últimos 7 dias, agrupado por upload date.
job_summaries

As categorias successful_count, failed_count e pending_count das 7 maiores solicitações de upload recentes, agrupadas por job_id. job_id é um campo opcional. de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest É possível definir job_id a um número não negativo menor que 2^31 ou permita que a API Google Ads atribua um gerado pelo sistema à sua solicitação. Independentemente da opção que você escolher, a UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retorna job_id.

Um cenário em que atribuir seu próprio job_id é útil é quando você tem uma um único job ou processo que faz upload de um grande número de conversões usando várias solicitações. Se você definir job_id em cada uma dessas solicitações como mesmo valor, será possível recuperar uma única entrada para a vaga de job_summaries. Se, em vez disso, você permitir que a API Google Ads atribua um valor ao valor de job_id de cada solicitação, o job_summaries contém um valor entrada para cada solicitação, o que pode tornar a análise da integridade geral da seu trabalho mais desafiador.

Como usar os resumos

Para garantir que seus processos de upload estejam registrando conversões e melhorias conforme esperado, recuperam periodicamente os resumos de cada uma das suas contas. Se o status de qualquer resumo não for EXCELLENT, use a lista de erros em alerts para orientar você na modificação do processo de upload para reduzir ou e eliminar esses erros.

Exemplo:

  • Se o status for NEEDS_ATTENTION, uma parte significativa dos seus operações de upload falharam. Revise os erros em alerts e modifique seu de dados para reduzir ou eliminar esses erros.

  • Se o status for NO_RECENT_UPLOADS, o Google Ads não recebeu nenhuma uploads para client. Se isso for inesperado, analise os processos que realizam uploads usando esse cliente.

    Por exemplo, se status para GOOGLE_ADS_API for NO_RECENT_UPLOADS, pode indicar que seu processo de upload que usa a API Google Ads parou de ser executado recentemente.

  • Para determinar se houve uma data de upload ou tarefa específica que enviou um grande número de eventos que não foram processados, verifique successful_count, failed_count e pending_count de daily_summaries e job_summaries. Os eventos com estado pendente podem levar até 24 horas a serem concluídas.

Restrições

Considere o seguinte ao recuperar os resumos de upload:

  • A API Google Ads só retorna diagnósticos de dados off-line se o customer_id dos A solicitação de searchStream ou search é o mesmo cliente usado recentemente para fazer o upload de conversões.

    Por exemplo, uma conta de cliente que usa o acompanhamento de conversões de várias contas pode e não contêm diagnósticos. No entanto, você pode recuperar diagnósticos enviando uma solicitação em que o customer_id corresponde ao customer_id do administrador usada em envios.

  • O Google Ads trata CLICK_NOT_FOUND erros das conversões otimizadas para leads como avisos. Conforme um resultado, se alerts tiver uma entrada para esse erro, o método operações ainda são consideradas bem-sucedidas e estão incluídas no successful_event_count.