Monitorare la diagnostica dei dati offline

Utilizza l'API Google Ads per recuperare la diagnostica dei dati offline, contenente informazioni sull'integrità complessiva dei processi di caricamento e aggiustamento delle conversioni.

Per recuperare la diagnostica dei dati offline più recente per il tuo account, invia la seguente query per le risorse offline_conversion_upload_client_summary utilizzando GoogleAdsService:

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.resource_name,
  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

La query precedente restituisce un elemento OfflineConversionUploadClientSummary separato per ogni tipo di client utilizzato nei caricamenti recenti. Ad esempio, se di recente hai caricato utilizzando sia l'API Google Ads sia l'interfaccia utente di Google Ads, i risultati contengono voci distinte per i valori client di GOOGLE_ADS_API e GOOGLE_ADS_WEB_CLIENT.

Ogni OfflineConversionUploadClientSummary ha un campo status che riflette lo stato generale dei caricamenti per l'elemento client. Contiene inoltre il numero totale di eventi ricevuti, il conteggio degli eventi elaborati correttamente e un campo alerts che fornisce un riepilogo degli errori, raggruppati per OfflineConversionError. Tutti questi campi contengono informazioni relative ai caricamenti del giorno di calendario intero più recente. Utilizza queste informazioni per valutare lo stato attuale dei tuoi caricamenti.

Inoltre, ogni elemento OfflineConversionUploadClientSummary contiene due diversi tipi di report:

daily_summaries

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

job_summaries

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

Uno scenario in cui l'assegnazione di job_id è utile quando hai un singolo job o processo che carica un numero elevato di conversioni utilizzando più richieste. Se imposti job_id per 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 generale del tuo job.

Come utilizzare i riassunti

Per assicurarti che i processi di caricamento registrino conversioni e miglioramenti come previsto, recupera periodicamente i riepiloghi per ciascuno dei tuoi account. Se status di qualsiasi riepilogo non è EXCELLENT, utilizza l'elenco di errori in alerts per guidarti nella modifica della procedura di caricamento al fine di ridurre o eliminare questi errori.

Ad esempio:

• Se lo stato è NEEDS_ATTENTION, una parte significativa delle operazioni di caricamento non è riuscita. Esamina gli errori in alerts e modifica la procedura 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 è imprevisto, esamina i processi che eseguono i caricamenti con quel client.

  Ad esempio, se status per GOOGLE_ADS_API è NO_RECENT_UPLOADS, ciò potrebbe indicare che di recente il processo di caricamento che utilizza l'API Google Ads è stato interrotto.

• Controlla successful_count e failed_count di daily_summaries e job_summaries per determinare se esisteva una data di caricamento specifica o un job specifico che ha inviato un numero elevato di eventi che non sono stati elaborati correttamente.

Restrizioni

Quando recuperi i riepiloghi dei caricamenti, 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 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 la diagnostica inviando una richiesta in cui customer_id corrisponde al customer_id dell'account amministratore che utilizzi nei 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.