Monitorar diagnósticos de dados off-line

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

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

• 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ósticos no nível da conta

Para extrair diagnósticos 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ósticos 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.
• A contagem de eventos processados com sucesso.
• A contagem de eventos pendentes (ainda em processamento).
• Um campo alerts, que fornece um resumo de erros agrupados por OfflineConversionError.

Todos esses campos contêm informações do dia completo do calendário 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 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á recuperar uma única entrada para o job em 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 houve uma data de upload ou job 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. Qualquer evento em estado pendente pode levar até 24 horas para ser concluído.

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 de 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.