Monitorar diagnósticos de dados off-line

Observação: para importações de conversões otimizadas para leads, use o relatório de diagnóstico das conversões otimizadas para leads na interface do Google Ads para monitorar a integridade da importação.

Use a API Google Ads para extrair 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 dos seguintes recursos:

• offline_conversion_upload_client_summary agrega diagnósticos de importação no nível da conta.
• offline_conversion_upload_conversion_action_summary agrega diagnósticos de importação no nível da ação de conversão.

Diagnósticos no nível da conta

Para extrair 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 nas importações recentes. Por exemplo, se você importou recentemente usando a API Google Ads e a interface do Google Ads, os resultados têm 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 recuperar 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 nas importações recentes. Por exemplo, se você importou recentemente usando a API Google Ads e a interface do Google Ads, os resultados têm 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 das importações 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 dos erros agrupados por OfflineConversionError.

Todos esses campos contêm informações do dia 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

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

job_summaries

successful_count, failed_count e pending_count das sete solicitações de importação 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 sua própria 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 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 importação estejam registrando conversões e melhorias conforme esperado, extraia 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 modificar o 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. Revise 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 nenhuma importação recente para o client. Se isso for inesperado, revise os processos que realizam importações usando esse cliente.

  Por exemplo, se o status para GOOGLE_ADS_API for NO_RECENT_UPLOADS, isso pode 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 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.

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

Restrições

Considere o seguinte ao extrair resumos de importação:

• A API Google Ads só vai retornar 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 importar 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 nas importações.

• O Google Ads trata os erros CLICK_NOT_FOUND das importações 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.