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 o diagnóstico de dados off-line mais recente da sua conta, envie a seguinte consulta para os recursos de offline_conversion_upload_client_summary usando o GoogleAdsService:

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.resource_name,
  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

A consulta acima retorna um OfflineConversionUploadClientSummary separado para cada tipo de cliente usado nos uploads recentes. Por exemplo, se você fez o upload recentemente usando a API Google Ads e a interface do Google Ads, os resultados terão entradas separadas para os valores client de GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Cada OfflineConversionUploadClientSummary tem um campo status que reflete a integridade geral dos uploads para o client. Ele também contém a contagem do total de eventos recebidos, a contagem de eventos processados com sucesso e um campo alerts que fornece um resumo dos erros, agrupado por OfflineConversionError. Todos esses campos contêm informações do dia completo mais recente dos uploads. Use essas informações para avaliar a integridade atual dos seus envios.

Além disso, cada OfflineConversionUploadClientSummary contém dois tipos diferentes de relatório:

daily_summaries

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

job_summaries

A successful_count e a failed_count das sete solicitações de upload mais recentes, agrupadas por job_id. O job_id é um campo opcional de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. Você pode definir job_id como um número não negativo menor que 2^31 ou permitir que a API Google Ads atribua um ID de tarefa gerado pelo sistema à sua solicitação. Seja qual for a opção escolhida, UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse retornará job_id.

Um cenário em que é útil atribuir seu próprio job_id é 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 de job_summaries. Se, em vez disso, você permitir que a Google Ads API atribua um valor gerado pelo sistema ao job_id de cada solicitação, o job_summaries conterá uma entrada separada para cada solicitação, o que pode dificultar a análise da integridade geral do seu job.

Como usar os resumos

Para garantir que os processos de upload estejam registrando conversões e melhorias conforme o esperado, recupere 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 saber como modificar seu processo de upload para reduzir ou eliminar esses erros.

Exemplo:

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

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

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

• Verifique o successful_count e o failed_count de daily_summaries e job_summaries para determinar se uma data de upload ou um job específico enviou um grande número de eventos que não foram processados.

Restrições

Considere o seguinte ao recuperar os resumos de upload:

• A API Google Ads só retornará diagnósticos de dados off-line se o customer_id da solicitação searchStream ou search for 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 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 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 serão incluídas no successful_event_count.