Monitorar diagnósticos de dados off-line

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

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

• O offline_conversion_upload_client_summary agrega diagnósticos de upload no nível da conta.
• O offline_conversion_upload_conversion_action_summary (disponível apenas na v17 ou mais recente) agrega diagnósticos de upload no nível da ação de conversão.

Diagnóstico no nível da conta

Para recuperar o diagnóstico de upload de conversões no nível da conta, use a seguinte consulta do 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 OfflineConversionUploadClientSummary separadas para cada tipo de cliente usado em uploads recentes. Por exemplo, se você fez o upload recentemente usando a API Google Ads e a interface do Google Ads, os resultados vão conter entradas separadas para os valores de client de GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

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

Para extrair diagnósticos de upload de conversões no nível da ação de conversão, use a seguinte consulta do 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 os diagnósticos no nível da conta, essa consulta retorna linhas OfflineConversionUploadConversionActionSummary separadas para cada tipo de cliente usado em uploads recentes. Por exemplo, se você fez o upload recentemente usando a API Google Ads e a interface do Google Ads, os resultados vão conter entradas separadas para os valores de 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 dos uploads para o client. Ele também contém as seguintes informações:

• A contagem total de eventos recebidos.
• Contagem de eventos processados com sucesso.
• A contagem de eventos pendentes (ainda em processamento).
• 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 envios. Use essas informações para avaliar a integridade atual dos seus envios.

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

daily_summaries

Uma successful_count, failed_count e pending_count de solicitações de upload dos últimos sete dias, agrupadas por date de upload.

job_summaries

successful_count, failed_count e pending_count das sete solicitações de upload mais recentes, agrupadas por job_id. O job_id é um campo opcional de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. É possível definir o job_id como um número não negativo menor que 2^31 ou permitir que a API Google Ads atribua um ID de job gerado pelo sistema à sua solicitação. Independentemente da opção escolhida, o UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retorna o job_id.

Um cenário em que atribuir seu próprio job_id é útil é quando você tem um único job ou processo que faz upload de um grande número de conversões usando várias solicitações. Se você definir o job_id em cada uma dessas solicitações com o mesmo valor, poderá extrair uma única entrada para o job de job_summaries. Se você permitir que a API do 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 tornar a análise da integridade geral do seu job mais desafiadora.

Como usar resumos

Para garantir que seus processos de envio estejam registrando conversões e melhorias conforme esperado, extraia periodicamente os resumos de cada uma das suas contas. Se o status de um resumo não for EXCELLENT, use a lista de erros em alerts para modificar o processo de envio e reduzir ou eliminar esses erros.

Exemplo:

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

• Se o status for NO_RECENT_UPLOADS, o Google Ads não recebeu nenhum upload recente para o client. Se isso for inesperado, revise os processos que fazem uploads usando esse cliente.

  Por exemplo, se o status para GOOGLE_ADS_API for NO_RECENT_UPLOADS, isso pode indicar que o processo de upload que usa a API Google Ads parou de funcionar recentemente.

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

Restrições

Considere o seguinte ao recuperar resumos de upload:

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

  Por exemplo, uma conta de cliente que usa o acompanhamento de conversões de várias contas pode não conter diagnósticos. No entanto, é possível recuperar diagnósticos enviando uma solicitação em que o customer_id corresponde ao customer_id da conta administradora usada nos uploads.

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