Monitorare la diagnostica dei dati offline

Utilizza l'API Google Ads per recuperare dati diagnostici offline, che contengono informazioni sullo stato complessivo delle procedure di caricamento e aggiustamento delle conversioni.

Per recuperare le ultime informazioni sulla diagnostica dei dati offline per il tuo account, utilizza una delle seguenti risorse:

• offline_conversion_upload_client_summary aggrega la diagnostica dei caricamenti a livello di account.
• offline_conversion_upload_conversion_action_summary (disponibile solo nella versione 17 o successive) aggrega la diagnostica dei caricamenti a livello di azione di conversione.

Diagnostica a livello di account

Per recuperare la diagnostica del caricamento delle conversioni a livello di account, utilizza la seguente query GAQL:

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.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  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

Questa query restituisce OfflineConversionUploadClientSummary righe separate per ogni tipo di client utilizzato nei caricamenti recenti. Ad esempio, se hai eseguito un caricamento recente utilizzando sia l'API Google Ads sia l'interfaccia utente di Google Ads, i risultati conterranno voci separate per i valori client di GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Diagnostica a livello di azione di conversione

Per recuperare i dati di diagnostica del caricamento delle conversioni a livello di azione di conversione, utilizza la seguente query GAQL:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

Analogamente alla diagnostica a livello di account, questa query restituisce OfflineConversionUploadConversionActionSummary righe separate per ogni tipo di client utilizzato nei caricamenti recenti. Ad esempio, se hai eseguito un caricamento recente utilizzando sia l'API Google Ads sia l'interfaccia utente di Google Ads, i risultati conterranno voci separate per i valori client di GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Come interpretare questi riepiloghi

Ogni OfflineConversionUploadClientSummary o OfflineConversionUploadConversionActionSummary ha un campo status, che riflette lo stato di salute complessivo dei caricamenti per il client. Contiene anche le seguenti informazioni:

• Il conteggio totale degli eventi ricevuti.
• Il conteggio degli eventi elaborati correttamente.
• Il conteggio degli eventi in attesa (eventi che sono ancora in fase di elaborazione).
• Un campo alerts che fornisce un riepilogo degli errori, raggruppati per OfflineConversionError.

Tutti questi campi contengono informazioni relative all'ultimo giorno di calendario completo di caricamenti. Utilizza queste informazioni per valutare lo stato attuale dei tuoi caricamenti.

Inoltre, ogni OfflineConversionUploadClientSummary o OfflineConversionUploadConversionActionSummary contiene due diversi tipi di report:

daily_summaries

Un successful_count, un failed_count e un pending_count di richieste di caricamento degli ultimi 7 giorni, raggruppate per caricamento date.

job_summaries

successful_count, failed_count e pending_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 sia l'API Google Ads ad assegnare un ID job generato dal sistema alla tua richiesta. Indipendentemente dall'opzione scelta, UploadClickConversionsResponse o UploadConversionAdjustmentsResponse restituisce job_id.

Un esempio in cui è utile assegnare un proprio job_id è quando hai un singolo job o processo che carica un numero elevato di conversioni utilizzando più richieste. Se imposti job_id su ogni richiesta allo stesso valore, puoi recuperare una singola voce per il job da job_summaries. Se invece consenti all'API Google Ads di assegnare un valore generato dal sistema al job_id di ogni richiesta, il job_id contiene una voce distinta per ogni richiesta, il che potrebbe rendere più complessa l'analisi dell'integrità complessiva del tuo job.job_summaries

Come utilizzare i riepiloghi

Per assicurarti che le procedure di caricamento registrino le conversioni e i miglioramenti come previsto, recupera periodicamente i riepiloghi per ciascuno dei tuoi account. Se il valore status di un riepilogo non è EXCELLENT, utilizza l'elenco degli errori in alerts per modificare la procedura di caricamento in modo da ridurre o eliminare questi errori.

Ad esempio:

• Se lo stato è NEEDS_ATTENTION, significa che una parte significativa delle operazioni di caricamento non è riuscita. Esamina gli errori in alerts e modifica il processo di caricamento per ridurli o eliminarli.

• Se lo stato è NO_RECENT_UPLOADS, significa che Google Ads non ha ricevuto caricamenti recenti per client. Se questo comportamento non è previsto, controlla le procedure che eseguono i caricamenti utilizzando il client in questione.

  Ad esempio, se status per GOOGLE_ADS_API è NO_RECENT_UPLOADS, potrebbe indicare che la procedura di caricamento che utilizza l'API Google Ads ha smesso di funzionare di recente.

• Per determinare se è stata specificata una data o un job di caricamento specifici che hanno inviato un numero elevato di eventi non elaborati, controlla successful_count, failed_count e pending_count di daily_summaries e job_summaries. Il completamento di qualsiasi evento in stato di attesa può richiedere fino a 24 ore.

Per saperne di più su come migliorare la diagnostica dei dati offline, consulta il Centro assistenza.

Restrizioni

Tieni presente quanto segue quando recuperi i riepiloghi dei caricamenti:

• L'API Google Ads restituisce la diagnostica dei dati offline solo se il 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 potrebbe non contenere alcuna diagnostica. Tuttavia, puoi recuperare i dati di diagnostica inviando una richiesta in cui customer_id corrisponde a customer_id dell'account amministratore che utilizzi per i caricamenti.

• Google Ads tratta gli errori CLICK_NOT_FOUND dei caricamenti 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 sono incluse in successful_event_count.