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
efailed_count
de solicitações de upload dos últimos sete dias, agrupadas por uploaddate
. job_summaries
A
successful_count
e afailed_count
das sete solicitações de upload mais recentes, agrupadas porjob_id
. Ojob_id
é um campo opcional deUploadClickConversionsRequest
eUploadConversionAdjustmentsRequest
. Você pode definirjob_id
como um número não negativo menor que2^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
ouUploadConversionAdjustmentsResponse
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 ojob_id
em cada uma dessas solicitações com o mesmo valor, poderá recuperar uma única entrada para o job dejob_summaries
. Se, em vez disso, você permitir que a Google Ads API atribua um valor gerado pelo sistema aojob_id
de cada solicitação, ojob_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 emalerts
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 declient
. Se isso for inesperado, revise os processos que realizam uploads usando esse cliente.Por exemplo, se o
status
paraGOOGLE_ADS_API
forNO_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 ofailed_count
dedaily_summaries
ejob_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çãosearchStream
ousearch
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 aocustomer_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, sealerts
contiver uma entrada para esse erro, as operações correspondentes ainda serão consideradas bem-sucedidas e serão incluídas nosuccessful_event_count
.