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 dos processos de ajuste e upload de conversões.

Para recuperar o diagnóstico de dados off-line mais recente da sua conta, envie a seguinte consulta por recursos offline_conversion_upload_client_summary usando 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 e a IU do Google Ads, os resultados conterã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 êxito e 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 uploads.

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

daily_summaries

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

job_summaries

O successful_count e failed_count das 7 solicitações de upload mais recentes, agrupados por job_id. O job_id é um campo opcional de UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. É possível 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, a UploadClickConversionsResponse ou a UploadConversionAdjustmentsResponse retorna a 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, será possível recuperar uma única entrada para o job de job_summaries. Se, em vez disso, você permitir que a API Google Ads atribua um valor gerado pelo sistema ao job_id de cada solicitação, job_summaries terá uma entrada separada para cada solicitação, o que poderá tornar a análise da integridade geral do seu job mais desafiadora.

Como usar os resumos

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

Exemplo:

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

• Se o status for NO_RECENT_UPLOADS, significa que o Google Ads não recebeu uploads recentes para client. Se isso for inesperado, analise 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 houve uma data de upload ou job específico que enviou um grande número de eventos que não foram processados.

Restrições

Considere o seguinte ao recuperar os resumos de uploads:

• 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 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, você pode recuperar diagnósticos enviando uma solicitação em que customer_id corresponde ao customer_id da conta de administrador usada nos uploads.

• O Google Ads trata os erros CLICK_NOT_FOUND gerados nos 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.