Utilizza l'API Google Ads per recuperare la diagnostica dei dati offline, che contiene informazioni sullo stato generale dei processi di caricamento e aggiustamento delle conversioni.
Per recuperare l'ultima diagnostica dei dati offline per il tuo account, invia la seguente query per le risorse offline_conversion_upload_client_summary
utilizzando 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
La query riportata sopra restituisce un elemento OfflineConversionUploadClientSummary
separato per ogni tipo di client utilizzato nei caricamenti recenti. Ad esempio, se di recente hai caricato utilizzando sia l'API Google Ads che l'interfaccia utente di Google Ads, i risultati contengono voci separate per i valori client
di GOOGLE_ADS_API
e GOOGLE_ADS_WEB_CLIENT
.
Ogni OfflineConversionUploadClientSummary
ha un campo status
che riflette lo stato complessivo dei caricamenti per client
. Contiene anche il conteggio degli eventi totali ricevuti, il conteggio degli eventi elaborati correttamente e un campo alerts
che fornisce un riepilogo degli errori, raggruppati per OfflineConversionError
.
Tutti questi campi contengono informazioni relative al giorno di calendario intero più recente dei caricamenti. Usa queste informazioni per valutare lo stato attuale dei tuoi caricamenti.
Inoltre, ciascun OfflineConversionUploadClientSummary
contiene due diversi tipi
di report:
daily_summaries
- Un
successful_count
efailed_count
di richieste di caricamento negli ultimi 7 giorni, raggruppate per caricamentodate
. job_summaries
Le
successful_count
efailed_count
delle 7 richieste di caricamento più recenti, raggruppate perjob_id
.job_id
è un campo facoltativo diUploadClickConversionsRequest
eUploadConversionAdjustmentsRequest
. Puoi impostarejob_id
su un numero non negativo inferiore a2^31
o lasciare che l'API Google Ads assegni un ID job generato dal sistema alla richiesta. Indipendentemente dall'opzione scelta,UploadClickConversionsResponse
oUploadConversionAdjustmentsResponse
restituiscejob_id
.Uno scenario in cui l'assegnazione di
job_id
è utile è quando hai un singolo job o un processo che carica un elevato numero di conversioni utilizzando più richieste. Se impostijob_id
sullo stesso valore per ciascuna di queste richieste, puoi recuperare una singola voce per il job dajob_summaries
. Se invece permetti all'API Google Ads di assegnare un valore generato dal sistema aljob_id
di ogni richiesta,job_summaries
conterrà una voce separata per ogni richiesta, il che potrebbe rendere più difficile l'analisi dello stato complessivo del tuo job.
Come utilizzare i riepiloghi
Per assicurarti che i processi di caricamento registrino le conversioni e i miglioramenti come previsto, recupera periodicamente i riepiloghi per ciascuno dei tuoi account. Se il status
di un riepilogo non è EXCELLENT
, utilizza l'elenco degli errori in alerts
per guidarti nella modifica della procedura di caricamento al fine di ridurre o eliminare tali errori.
Ad esempio:
Se lo stato è
NEEDS_ATTENTION
, le operazioni di caricamento non sono riuscite in gran parte. Esamina gli errori inalerts
e modifica la procedura di caricamento per ridurli o eliminarli.Se lo stato è
NO_RECENT_UPLOADS
, significa che Google Ads non ha ricevuto caricamenti recenti perclient
. Se non te lo aspettavi, esamina i processi che eseguono i caricamenti con il client.Ad esempio, se il
status
diGOOGLE_ADS_API
èNO_RECENT_UPLOADS
, potrebbe indicare che il processo di caricamento che utilizza l'API Google Ads è stato interrotto di recente.Controlla i
successful_count
e ifailed_count
didaily_summaries
ejob_summaries
per determinare se una data di caricamento o un job specifici hanno inviato un numero elevato di eventi non elaborati correttamente.
Restrizioni
Quando recupera i riepiloghi dei caricamenti, tieni presente quanto segue:
L'API Google Ads restituisce la diagnostica dei dati offline solo se il valore
customer_id
della richiestasearchStream
osearch
è lo stesso cliente che hai utilizzato di recente per caricare le conversioni.Ad esempio, un account cliente che utilizza il monitoraggio delle conversioni su più account può non contenere dati diagnostici. Tuttavia, puoi recuperare la diagnostica inviando una richiesta in cui il valore
customer_id
corrisponde alcustomer_id
dell'account amministratore che utilizzi nei caricamenti.Google Ads tratta gli errori
CLICK_NOT_FOUND
delle conversioni avanzate per i lead come avvisi. Di conseguenza, sealerts
contiene una voce per questo errore, le operazioni corrispondenti vengono comunque considerate riuscite e incluse insuccessful_event_count
.