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 importazione e aggiustamento delle conversioni.

Nota: per le importazioni delle conversioni avanzate per i lead, monitora lo stato dell'importazione nel report di diagnostica delle conversioni avanzate per i lead nell'UI di Google Ads. Per le conversioni avanzate per il web (aggiustamenti ENHANCEMENT), la diagnostica dei dati offline monitora solo gli errori di importazione a livello di richiesta API. Per monitorare la corrispondenza asincrona tra tag e API order_id, la copertura del miglioramento dell'API e la completezza dell'identificatore dell'utente, utilizza il report diagnostico sulle conversioni avanzate nell'UI di Google Ads. Per i passaggi per la risoluzione dei problemi, consulta Avvisi di diagnostica dell'UI dopo un caricamento API riuscito.

Per recuperare la diagnostica dei dati offline più recente per il tuo account, utilizza una delle seguenti risorse:

• offline_conversion_upload_client_summary aggrega la diagnostica di importazione a livello di account.
• offline_conversion_upload_conversion_action_summary aggrega la diagnostica di importazione a livello di azione di conversione.

Diagnostica a livello di account

Per recuperare la diagnostica dei caricamenti 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 righe OfflineConversionUploadClientSummary separate per ogni tipo di client utilizzato nelle importazioni recenti. Ad esempio, se di recente hai eseguito l'importazione utilizzando sia l'API Google Ads sia l'UI di Google Ads, i risultati contengono voci separate per i valori client di GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Diagnostica a livello di azione di conversione

Per recuperare la diagnostica dei caricamenti delle conversioni a livello di azione di conversione, utilizza la seguente query GAQL:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  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 = <CONVERSION_ACTION_ID>

Analogamente alla diagnostica a livello di account, questa query restituisce righe OfflineConversionUploadConversionActionSummary separate per ogni tipo di client utilizzato nelle importazioni recenti. Ad esempio, se di recente hai eseguito l'importazione utilizzando sia l'API Google Ads sia l'interfaccia utente di Google Ads, i risultati contengono 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 l'integrità complessiva delle importazioni per client. Contiene anche le seguenti informazioni:

• Il numero di eventi totali ricevuti.
• Il numero di eventi elaborati correttamente.
• Il numero di eventi in attesa (eventi 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 delle importazioni. Utilizza queste informazioni per valutare lo stato di salute attuale delle tue importazioni.

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

daily_summaries

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

job_summaries

successful_count, failed_count e pending_count delle 7 richieste di importazione più recenti, raggruppate per job_id. job_id è un campo facoltativo di UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. Puoi impostare il campo job_id su un numero intero positivo a 32 bit (da 1 a 2^31 - 1) o lasciare che l'API Google Ads assegni alla tua richiesta un ID job generato dal sistema. Indipendentemente dall'opzione scelta, UploadClickConversionsResponse o UploadConversionAdjustmentsResponse restituisce job_id.

Uno scenario in cui l'assegnazione del tuo job_id è utile è quando hai un singolo job o processo che importa un numero elevato di conversioni utilizzando più richieste. Se imposti job_id su ciascuna di queste richieste sullo 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, job_summaries contiene una voce separata per ogni richiesta, il che potrebbe rendere più difficile l'analisi dello stato complessivo del job.

Come utilizzare i riepiloghi

Per verificare che i processi di importazione acquisiscano le conversioni e i miglioramenti senza errori dell'API, recupera periodicamente i riepiloghi per ciascuno dei tuoi account. Se il campo status di un riepilogo non è EXCELLENT, utilizza l'elenco di errori nel campo alerts per modificare il processo di importazione in modo da ridurre o eliminare questi errori.

Ad esempio:

• Se lo stato è NEEDS_ATTENTION, significa che una parte significativa delle operazioni di importazione non è andata a buon fine. Esamina gli errori in alerts e modifica la procedura di importazione per ridurli o eliminarli.

• Se lo stato è NO_RECENT_UPLOADS, Google Ads non ha ricevuto importazioni recenti per client. Se questo non era previsto, esamina i processi che eseguono le importazioni utilizzando quel client.

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

• Per determinare se esiste una data o un job di importazione specifico che ha inviato un numero elevato di eventi che non sono stati elaborati, controlla successful_count, failed_count e pending_count di daily_summaries e job_summaries. Il completamento degli eventi 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.

Limitazioni

Quando recuperi i riepiloghi delle importazioni, 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 importare le conversioni.

  Ad esempio, un account cliente che utilizza il monitoraggio delle conversioni su più account potrebbe non contenere dati di diagnostica. Tuttavia, puoi recuperare la diagnostica inviando una richiesta in cui customer_id corrisponde a customer_id dell'account amministratore che utilizzi nelle importazioni.

• Google Ads considera gli errori CLICK_NOT_FOUND delle importazioni 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.