Monitorar diagnósticos de dados off-line

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

Observação: para importações de conversões otimizadas para leads, monitore a integridade da importação no relatório de diagnóstico de conversões otimizadas para leads na interface do Google Ads. Para conversões otimizadas para a Web (ajustes de ENHANCEMENT), os diagnósticos de dados off-line rastreiam apenas erros de ingestão no nível da solicitação de API. Para monitorar a correspondência assíncrona de tag para API order_id, a cobertura de melhoria da API e a integridade do identificador de usuário, use o relatório de diagnóstico de conversões otimizadas na interface do Google Ads. Para conferir as etapas de solução de problemas, consulte Alertas de diagnóstico da interface após um upload de API.

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

Para recuperar os diagnósticos de upload de conversões no nível da conta, use a 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

Essa consulta retorna linhas OfflineConversionUploadClientSummary separadas para cada tipo de cliente usado em importações recentes. Por exemplo, se você importou 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 no nível da ação de conversão

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

Semelhante aos diagnósticos no nível da conta, essa consulta retorna linhas OfflineConversionUploadConversionActionSummary separadas para cada tipo de cliente usado em importações recentes. Por exemplo, se você fez uma importação recente 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 para o client. Ele 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 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

O successful_count, o failed_count e o 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. Você pode definir o campo job_id como um número inteiro positivo de 32 bits (1 a 2^31 - 1) ou permitir que a API Google Ads atribua um código da tarefa gerado pelo sistema à sua solicitação. Não importa qual opção você escolha, o UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retorna o job_id.

Um cenário em que é útil atribuir seu próprio job_id é 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, será possível recuperar uma única entrada para o job em job_summaries. Se 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 job.

Como usar os resumos

Para verificar se os processos de importação estão ingerindo conversões e melhorias sem erros de API, recupere periodicamente os resumos de cada uma das suas contas. Se o campo status de qualquer resumo não for EXCELLENT, use a lista de erros no campo alerts para orientar você na modificação do processo de importação para reduzir ou eliminar esses erros.

Exemplo:

• Se o status for NEEDS_ATTENTION, uma parte significativa das 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, revise os processos que realizam importações usando esse cliente.

  Por exemplo, se o status de 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 um 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. Os eventos em estado pendente podem levar até 24 horas para serem concluídos.

Confira mais informações sobre como melhorar o diagnóstico de dados off-line na Central de Ajuda.

Restrições

Considere 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 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 rastreamento de conversões entre 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 de administrador que você usa 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 tiver uma entrada para esse erro, as operações correspondentes ainda serão consideradas bem-sucedidas e incluídas no successful_event_count.