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:
offline_conversion_upload_client_summary
aggrega la diagnostica dei caricamenti a livello di a livello di account.offline_conversion_upload_conversion_action_summary
(disponibile solo in v17 o versioni successive) aggrega la diagnostica dei caricamenti a livello di azione di conversione.
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 perOfflineConversionError
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
epending_count
di richieste di caricamento degli ultimi 7 giorni, raggruppati per caricamentodate
. job_summaries
successful_count
,failed_count
epending_count
dei 7 più richieste di caricamento recenti, raggruppate perjob_id
.job_id
è un campo facoltativo diUploadClickConversionsRequest
eUploadConversionAdjustmentsRequest
. Puoi impostarejob_id
a un numero non negativo inferiore a2^31
o lascia che l'API Google Ads assegni un generato dal sistema alla tua richiesta. Indipendentemente dall'opzione scegliere, laUploadClickConversionsResponse
oUploadConversionAdjustmentsResponse
restituiscejob_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 impostijob_id
per ciascuna di queste richieste valore, puoi recuperare una singola voce per il jobjob_summaries
. Se invece permetti all'API Google Ads di assegnare un evento generato dal sistema aljob_id
di ogni richiesta, il valorejob_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 inalerts
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 perclient
. Se questo è imprevisto, rivedi i processi che eseguono caricamenti utilizzando quel client.Ad esempio, se il valore
status
diGOOGLE_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
epending_count
didaily_summaries
ejob_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 richiestasearchStream
osearch
è 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 acustomer_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, sealerts
contiene una voce per questo errore, i valori corrispondenti operazioni sono comunque considerate riuscite e sono inclusesuccessful_event_count
.