Monitorare la diagnostica dei dati offline

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 più recente dei dati offline per il tuo account, utilizza una delle seguenti risorse:

• offline_conversion_upload_client_summary aggrega la diagnostica dell'importazione a livello di account.
• offline_conversion_upload_conversion_action_summary aggrega la diagnostica dell'importazione 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 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 la 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 del caricamento 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 la UI 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 generale delle importazioni per client. Contiene anche le seguenti informazioni:

• Il conteggio degli eventi totali ricevuti.
• Il conteggio degli eventi elaborati correttamente.
• Il conteggio degli 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 dell'ultimo giorno di calendario completo di 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

Un successful_count, un failed_count e un pending_count di richieste di importazione degli ultimi 7 giorni, raggruppati 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 lasciare che l'API Google Ads assegni un ID lavoro generato dal sistema alla tua richiesta. Indipendentemente dall'opzione che scegli, 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 lasci che l'API Google Ads assegni 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 generale 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 status di un riepilogo non è EXCELLENT, utilizza l'elenco degli errori in alerts per modificare la procedura di importazione in modo da ridurre o eliminare questi errori.

Ad esempio:

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

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

  Ad esempio, se il status per GOOGLE_ADS_API è NO_RECENT_UPLOADS, ciò potrebbe indicare che il processo di importazione che utilizza l'API Google Ads ha smesso di essere eseguito di recente.

• Per determinare se una data o un job di importazione specifico 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 ulteriori informazioni su come migliorare la diagnostica dei dati offline, consulta il Centro assistenza.

Limitazioni

Quando recuperi i riepiloghi dell'importazione, 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 diagnostici. Tuttavia, puoi recuperare i dati di 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.