Puoi eseguire query sui dati sulle prestazioni rapidamente e senza superare la quota eseguendo una query giornaliera per un giorno di dati.
Devi scegliere le informazioni che vuoi includere nei dati, ovvero i tipi di ricerca (web, immagini, video e così via). e le dimensioni (pagina, query, paese o dispositivo), nonché se raggruppare i risultati per pagina o proprietà. Quando esegui una query per la pagina e/o la stringa di query, alcuni dati potrebbero essere eliminati (ecco perché).
Panoramica
- Consigliamo di eseguire una query ogni giorno per i dati di un giorno, utilizzando uno degli stili di query descritti di seguito. L'esecuzione di una query giornaliera per un giorno di dati non dovrebbe superare la tua quota giornaliera. I dati sono generalmente disponibili dopo 2-3 giorni. Per sapere quali sono i dati disponibili più di recente, esegui una semplice query raggruppata per data per gli ultimi 10 giorni. Scrivi la query:
- Scegli se raggruppare i risultati per pagina o proprietà.
- Scegli se vuoi includere conteggi più completi o più dimensioni nella query. Nota: i dati relativi all'aspetto nella ricerca (AMP, link blu, risultato avanzato e così via) devono essere interrogati utilizzando una procedura in due passaggi.
- Scorri i risultati eseguendo di nuovo la stessa query, aumentando il valore
startRow
di 25.000 nella richiesta fino a raggiungere l'ultima pagina (una risposta con 0 righe). - Facoltativamente, esegui la stessa query con un altro parametro
type
.
Ecco un esempio di pseudocodice per una singola query. Puoi eseguire questa operazione una volta al giorno
per ogni valore type
per cui vuoi i dati.
int maxRows = 25000; // Current max response size int i = 0; do { response = Request(startDate = 3_days_ago, endDate = 3_days_ago, ... add dimensions, type ... rowLimit = maxRows, startRow = i * maxRows); i++; … // Do something with the response data. } while (response.rows.count() != 0); // Page through all result rows
Limiti dei dati
Oltre alla quota di utilizzo delle API, il metodo Analisi delle ricerche espone un massimo di 50.000 righe di dati al giorno per tipo di ricerca (web, immagini e così via, ordinate per clic).
Dettagli query
Puoi eseguire query sui dati raggruppati per pagina o proprietà.
Raggruppati per pagina
Per conteggi precisi,devi omettere le dimensioni della pagina e della query, in questo modo:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate
/endDate
: scegli una finestra di un giorno selezionando la stessa data.dimensions
: puoi includerecountry
e/odevice
.type
: enumera ognitype
valore come preferisci in una query separata.aggregationType
: deve esserebyPage
.
Per maggiori dettagli, incluse le informazioni sulle pagine e/o sulle query, a scapito della perdita di alcuni dati, esegui una query come la seguente:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate
/endDate
: scegli una finestra di un giorno selezionando la stessa data.dimensions
: includipage
. Se vuoi, puoi includere qualsiasi combinazione diquery
,country
odevice
.type
: enumera ognitype
valore come preferisci in una query separata.
Raggruppati per proprietà
Per conteggi precisi,devi omettere le dimensioni della pagina e della query, in questo modo:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate
/endDate
: scegli una finestra di un giorno selezionando la stessa data.dimensions
: puoi includerecountry
e/odevice
.type
: se vuoi, enumera ognitype
valore in una query separata.
Per maggiori dettagli, tra cui la query, il paese e/o le informazioni del dispositivo, a scapito della perdita di alcuni dati, esegui una query come la seguente:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate
/endDate
: scegli una finestra di un giorno selezionando la stessa data.dimensions
: se vuoi, includi qualsiasi combinazione diquery
,country
odevice
.type
: enumera ognitype
valore come preferisci in una query separata.
Raggruppamento dei risultati per pagina o proprietà
Impressioni, clic, posizione e percentuale di clic vengono calcolati in modo diverso quando raggruppi i risultati per pagina anziché per proprietà. Scopri di più.
Perché perdo i dati quando chiedo maggiori dettagli?
Quando raggruppi i dati per pagina e/o query, il nostro sistema potrebbe tralasciare alcuni dati per poter calcolare i risultati in un tempo ragionevole, utilizzando una quantità ragionevole di risorse di calcolo.
Recupero dei dati relativi all'aspetto nella ricerca
L'aspetto nella ricerca non è disponibile come colonna insieme a qualsiasi altra dimensione. Pertanto, per visualizzare informazioni sull'aspetto nella ricerca per il tuo sito, devi procedere nel seguente modo:
- Specifica
searchAppearance
come unica dimensione, in modo da raggruppare tutti i dati per tipo di aspetto nella ricerca senza altre dimensioni. - Facoltativamente, esegui una seconda query, filtrando in base a uno dei tipi di aspetto nella ricerca elencati nel passaggio 1, aggiungendo alla query le dimensioni desiderate (pagina, paese, query e così via).
Per recuperare i dati relativi a più tipi di aspetto nella ricerca, devi eseguire il secondo passaggio una volta per ogni tipo di aspetto nella ricerca elencato al passaggio 1.
Prima query:
Ricevi un elenco dei tipi di aspetto nella ricerca sul tuo sito.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "searchAppearance" ] }
Risultati:
Il tipo di sito è INSTANT_APP, AMP_BLUE_LINK e così via.
"rows": [ { "keys": [ "INSTANT_APP" ], "clicks": 443024.0, "impressions": 4109826.0, "ctr": 0.10779629113251997, "position": 1.088168452873674 }, { "keys": [ "AMP_BLUE_LINK" ], "clicks": 429887.0, "impressions": 1.7090884E7, "ctr": 0.025152999692701676, "position": 7.313451603790653 },...
Seconda query:
Filtra in base a uno dei tipi di aspetto nella ricerca indicati nel passaggio 1, insieme alle dimensioni che preferisci (pagina, dispositivo e così via). Qui il filtro viene applicato in base a AMP_BLUE_LINK.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "device" // and/or page, country, ... ], "dimensionFilterGroups": [ { "filters": [ { "dimension": "searchAppearance", "operator": "equals", "expression": "AMP_BLUE_LINK" } ] } ] }
Risultati:
Suddivisione di AMP_BLUE_LINK per tipi di dispositivo.
"rows": [ { "keys": [ "MOBILE" ], "clicks": 429887.0, "impressions": 1.7090783E7, "ctr": 0.025153148337323107, "position": 7.31339517914422 }, { "keys": [ "DESKTOP" ], "clicks": 0.0, "impressions": 66.0, "ctr": 0.0, "position": 12.257575757575758 }, ...