Monitorare la diagnostica dei dati offline

Utilizza l'API Google Ads per recuperare diagnostica dei dati offline, contenenti informazioni sullo stato generale del caricamento delle conversioni e i processi di aggiustamento.

Per recuperare l'ultima diagnostica dei dati offline per il tuo account, utilizza una delle seguenti risorse:

Diagnostica a livello di account

Per recuperare i dati diagnostici del caricamento delle conversioni a livello di account, utilizza quanto segue 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 dati OfflineConversionUploadClientSummary righe per ogni tipo di cliente usato nei caricamenti recenti. Ad esempio, se caricati di recente 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 del 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_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 dati OfflineConversionUploadConversionActionSummary righe per ogni tipo di cliente usato nei caricamenti recenti. Ad esempio, se caricati di recente 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 integrità complessiva di caricamenti per client. Contiene inoltre le seguenti informazioni:

  • Il numero totale di eventi 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 al giorno di calendario intero più recente dei caricamenti. Usa queste informazioni per valutare lo stato attuale dei tuoi caricamenti.

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

daily_summaries
A successful_count, failed_count e pending_count di richieste di caricamento degli ultimi 7 giorni, raggruppati per caricamento date.
job_summaries

successful_count, failed_count e pending_count dei 7 più richieste di caricamento recenti, raggruppate per job_id. job_id è un campo facoltativo di UploadClickConversionsRequest e UploadConversionAdjustmentsRequest. Puoi impostare job_id a un numero non negativo inferiore a 2^31 o lascia che l'API Google Ads assegni un un ID job generato dal sistema alla tua richiesta. Indipendentemente dall'opzione scegliere, la UploadClickConversionsResponse o UploadConversionAdjustmentsResponse restituisce job_id.

Uno scenario in cui l'assegnazione di un tuo job_id risulta utile è quando hai una processo che carica un elevato numero di conversioni utilizzando più richieste. Se imposti job_id per ciascuna di queste richieste valore, puoi recuperare una singola voce per il job job_summaries. Se invece permetti all'API Google Ads di assegnare un evento generato dal sistema al job_id di ogni richiesta, il valore job_summaries contiene un voce per ogni richiesta, il che potrebbe facilitare l'analisi dello stato generale del più impegnativo.

Come utilizzare i riepiloghi

Per assicurarti che i processi di caricamento registrino le conversioni e i miglioramenti come recupera periodicamente i riepiloghi per ciascuno dei tuoi account. Se status di qualsiasi riepilogo non è EXCELLENT; utilizza l'elenco degli errori in alerts per guidarti nella modifica della procedura di caricamento in modo da ridurre o per eliminarlo.

Ad esempio:

  • Se lo stato è NEEDS_ATTENTION, una parte significativa dei tuoi operazioni di caricamento non riuscite. Esamina gli errori in alerts e modifica i di caricamento per ridurre o eliminare tali errori.

  • Se lo stato è NO_RECENT_UPLOADS, significa che Google Ads non ha ricevuto caricamenti per client. Se questo è imprevisto, rivedi i processi che eseguono caricamenti utilizzando quel client.

    Ad esempio, se il valore status di GOOGLE_ADS_API è NO_RECENT_UPLOADS, questo potrebbe indicare che l'esecuzione del processo di caricamento che utilizza l'API Google Ads è stata interrotta di recente.

  • Per determinare se ci fosse una data di caricamento specifica o un job che ha inviato un numero di eventi che non è stato possibile elaborare, controlla successful_count, failed_count e pending_count di daily_summaries e job_summaries. Eventuali eventi in stato di attesa possono richiedere fino a 24 ore per completare l'operazione.

Restrizioni

Quando recupera i riepiloghi dei caricamenti, tieni presente quanto segue:

  • L'API Google Ads restituisce la diagnostica dei dati offline solo se customer_id del La richiesta searchStream o search è dello stesso cliente che hai utilizzato di recente per e caricare le conversioni.

    Ad esempio, un account cliente che utilizza il monitoraggio delle conversioni su più account può non contengono dati diagnostici. Tuttavia, puoi recuperare la diagnostica inviando una richiesta in cui customer_id corrisponde a customer_id del gestore che usi nei caricamenti.

  • Google Ads tratta CLICK_NOT_FOUND errore delle conversioni avanzate per i lead come avvisi. Come un risultato, se alerts contiene una voce per questo errore, i valori corrispondenti operazioni sono comunque considerate riuscite e sono incluse successful_event_count.