Monitorar diagnósticos de dados off-line

Usar a API Google Ads para recuperar diagnóstico de dados off-line, que contêm informações sobre a integridade geral do upload de conversões e e ajustes nos processos.

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 na no nível da conta.
• offline_conversion_upload_conversion_action_summary (disponível apenas em v17 ou posterior) agrega diagnósticos de upload no nível da ação de conversão.

Diagnóstico no nível da conta

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

Esta consulta retorna valores OfflineConversionUploadClientSummary linhas para cada tipo de cliente usado nos uploads recentes. Por exemplo, se você enviado recentemente usando a API Google Ads e a interface do Google Ads, os resultados contêm 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 do upload de conversões no nível da ação de conversão, use a seguinte consulta 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 nos diagnósticos no nível da conta, essa consulta retorna OfflineConversionUploadConversionActionSummary linhas para cada tipo de cliente usado nos uploads recentes. Por exemplo, se você enviado recentemente usando a API Google Ads e a interface do Google Ads, os resultados contêm 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 saúde geral de uploads para client. Ela 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 completo 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 duas tipos de relatório:

daily_summaries

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

job_summaries

As categorias successful_count, failed_count e pending_count das 7 maiores solicitações de upload recentes, agrupadas por job_id. job_id é um campo opcional de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest É possível definir job_id a um número não negativo menor que 2^31 ou permita que a API Google Ads atribua um gerado pelo sistema à sua solicitação. Independentemente da opção que você escolher, a UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retorna job_id.

Um cenário em que atribuir seu próprio job_id é útil é quando você tem uma um único job ou processo que faz upload de um grande número de conversões usando várias solicitações. Se você definir job_id em cada uma dessas solicitações como mesmo valor, será possível recuperar uma única entrada para a vaga de job_summaries. Se, em vez disso, você permitir que a API Google Ads atribua um valor ao valor de job_id de cada solicitação, o job_summaries contém um valor entrada para cada solicitação, o que pode tornar a análise da integridade geral da seu trabalho mais desafiador.

Como usar os resumos

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

Exemplo:

• Se o status for NEEDS_ATTENTION, uma parte significativa dos seus operações de upload falharam. Revise os erros em alerts e modifique seu de dados para reduzir ou eliminar esses erros.

• Se o status for NO_RECENT_UPLOADS, o Google Ads não recebeu nenhuma uploads para client. Se isso for inesperado, analise os processos que realizam uploads usando esse cliente.

  Por exemplo, se status para GOOGLE_ADS_API for NO_RECENT_UPLOADS, pode indicar que seu processo de upload que usa a API Google Ads parou de ser executado recentemente.

• Para determinar se houve uma data de upload ou tarefa 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. Os eventos com estado pendente podem levar até 24 horas a serem concluídas.

Restrições

Considere o seguinte ao recuperar os resumos de upload:

• A API Google Ads só retorna diagnósticos de dados off-line se o customer_id dos A solicitação de searchStream ou search é o mesmo cliente usado recentemente para fazer o upload de conversões.

  Por exemplo, uma conta de cliente que usa o acompanhamento de conversões de várias contas pode e não contêm diagnósticos. No entanto, você pode recuperar diagnósticos enviando uma solicitação em que o customer_id corresponde ao customer_id do administrador usada em envios.

• O Google Ads trata CLICK_NOT_FOUND erros das conversões otimizadas para leads como avisos. Conforme um resultado, se alerts contiver uma entrada para esse erro, o método operações ainda são consideradas bem-sucedidas e estão incluídas no successful_event_count.