Monitorar diagnósticos de dados off-line

Use a API Google Ads para recuperar diagnósticos de dados off-line, que contêm informações sobre a integridade geral dos processos de importação e ajuste de conversões.

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

Diagnóstico da conta

Para recuperar os diagnósticos de upload de conversão da conta, use esta 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

Essa consulta retorna linhas separadas OfflineConversionUploadClientSummary para cada tipo de cliente usado em importações recentes. Por exemplo, se você fez uma importação recentemente usando a API Google Ads e a interface do Google Ads, os resultados vão conter entradas separadas para os valores client de GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Diagnóstico da ação de conversão

Para recuperar os diagnósticos de upload de conversão na ação de conversão, use esta consulta 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>

Assim como os diagnósticos da conta, essa consulta retorna linhas separadas OfflineConversionUploadConversionActionSummary para cada tipo de cliente usado em importações recentes. Por exemplo, se você fez uma importação recentemente usando a API Google Ads e a interface do Google Ads, os resultados vão conter 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 integridade geral das importações do client. Ele também contém estas informações:

  • A contagem 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 útil completo mais recente de importações. Use essas informações para avaliar a integridade atual das suas importações.

Além disso, cada OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary contém dois tipos diferentes de relatórios:

daily_summaries
Um successful_count, failed_count e pending_count de solicitações de importação dos últimos 7 dias, agrupadas por date de importação.
job_summaries

O successful_count, failed_count e pending_count das 7 solicitações de importação mais recentes, agrupadas por job_id. O job_id é um campo opcional de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. Você pode definir o job_id como um número não negativo menor que 2^31 ou permitir que a API Google Ads atribua um código da tarefa gerado pelo sistema à sua solicitação. Independente da opção escolhida, a UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retorna o job_id.

Um cenário em que a atribuição do seu próprio job_id é útil é quando você tem um único job ou processo que importa um grande número de conversões usando várias solicitações. Se você definir o job_id em cada uma dessas solicitações para o mesmo valor, poderá recuperar uma única entrada para o job em job_summaries. Se, em vez disso, você permitir que a API Google Ads atribua um valor gerado pelo sistema ao job_id de cada solicitação, o job_summaries vai conter uma entrada separada para cada solicitação, o que pode dificultar a análise da integridade geral do seu job.

Como usar resumos

Para garantir que seus processos de importação estejam registrando conversões e melhorias conforme o esperado, recupere 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 a modificação do processo de importação e reduzir ou eliminar esses erros.

Exemplo:

  • Se o status for NEEDS_ATTENTION, uma parte significativa das suas operações de importação falhou. Analise os erros em alerts e modifique o processo de importação para reduzir ou eliminar esses erros.

  • Se o status for NO_RECENT_UPLOADS, o Google Ads não recebeu importações recentes para o client. Se isso for inesperado, analise os processos que realizam importações usando esse cliente.

    Por exemplo, se o status de GOOGLE_ADS_API for NO_RECENT_UPLOADS, isso poderá indicar que o processo de importação que usa a API Google Ads parou de ser executado recentemente.

  • Para determinar se houve uma data ou job de importação específico que enviou um grande número de eventos que não foram processados, verifique o successful_count, failed_count e pending_count de daily_summaries e job_summaries. Os eventos em estado pendente podem levar até 24 horas para serem concluídos.

Mais informações sobre como melhorar os diagnósticos de dados off-line podem ser encontradas na Central de Ajuda.

Restrições

Tenha em mente o seguinte ao recuperar resumos de importação:

  • A API Google Ads só retorna diagnósticos de dados off-line se o customer_id da searchStream ou search solicitação for o mesmo cliente que você usou recentemente para importar conversões.

    Por exemplo, uma conta de cliente que usa o rastreamento de conversões entre contas pode não conter nenhum diagnóstico. No entanto, você pode recuperar diagnósticos enviando uma solicitação em que o customer_id corresponda ao customer_id da conta de administrador que você usa nas importações.

  • O Google Ads trata erros CLICK_NOT_FOUND de conversões otimizadas para leads importações como avisos. Como resultado, se alerts contiver uma entrada para esse erro, as operações correspondentes ainda serão consideradas bem-sucedidas e serão incluídas no successful_event_count.

Anterior
Variáveis de conversão personalizadas
Avançar
Relatórios