Monitorare la diagnostica dei dati offline

Nota: per le importazioni delle conversioni avanzate per i lead, utilizza il report di diagnostica delle conversioni avanzate per i lead nell'interfaccia utente di Google Ads per monitorare lo stato dell'importazione.

Utilizza l'API Google Ads per recuperare i dati diagnostici offline, che contengono informazioni sullo stato generale dei processi di importazione e aggiustamento delle conversioni.

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'interfaccia utente 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 lo stato di integrità complessivo 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 integrità attuale delle importazioni.

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

daily_summaries

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 job_id su un numero non negativo inferiore a 2^31 o consentire all'API Google Ads di assegnare 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 a 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 assicurarti che i processi di importazione 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 di errori in alerts per modificare la procedura 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 è 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 il processo 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 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.