Monitorare la diagnostica dei dati offline

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 e failed_count di richieste di caricamento negli ultimi 7 giorni, raggruppate per caricamento date.

job_summaries

Le successful_count e failed_count delle 7 richieste di caricamento più recenti, raggruppate per job_id. job_id è un campo facoltativo di UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. Puoi impostare job_id su un numero non negativo inferiore a 2^31 o lasciare che l'API Google Ads assegni un ID job generato dal sistema alla richiesta. Indipendentemente dall'opzione scelta, UploadClickConversionsResponse o UploadConversionAdjustmentsResponse restituisce job_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 imposti job_id sullo stesso valore per ciascuna di queste richieste, puoi recuperare una singola voce per il job da job_summaries. Se invece permetti all'API Google Ads di assegnare un valore generato dal sistema al job_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 in alerts 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 per client. Se non te lo aspettavi, esamina i processi che eseguono i caricamenti con il client.

  Ad esempio, se il status di GOOGLE_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 i failed_count di daily_summaries e job_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 richiesta searchStream o search è 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 al customer_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, se alerts contiene una voce per questo errore, le operazioni corrispondenti vengono comunque considerate riuscite e incluse in successful_event_count.