Monitorare la diagnostica dei dati offline

Utilizza l'API Google Ads per recuperare la diagnostica dei dati offline, che contiene informazioni sull'integrità complessiva dei processi di importazione e adeguamento 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 delle importazioni a livello di account.
• offline_conversion_upload_conversion_action_summary aggrega la diagnostica delle importazioni 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 separate OfflineConversionUploadClientSummary per ogni tipo di cliente 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_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 righe separate OfflineConversionUploadConversionActionSummary per ogni tipo di cliente 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 il 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 relative all'ultimo giorno di calendario completo delle importazioni. Utilizza queste informazioni per valutare l'integrità attuale delle importazioni.

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

daily_summaries

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

job_summaries

Il successful_count, failed_count e pending_count delle 7 richieste di importazione più recenti, raggruppate per job_id. Il 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 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 ogni richiesta con lo 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 dell'integrità complessiva 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 lo status di un riepilogo non è EXCELLENT, utilizza l'elenco degli errori in alerts per modificare il processo 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 è riuscita. Esamina gli errori in alerts e modifica il processo di importazione per ridurre o eliminare questi errori.

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

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

• Per determinare se è stata una data o un job di importazione specifico a inviare 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.

Ulteriori informazioni su come migliorare la diagnostica dei dati offline sono disponibili in Centro assistenza.

Restrizioni

Tieni presente quanto segue quando recuperi i riepiloghi delle importazioni:

• 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 alcuna 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 tratta 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.