Recupero dei dati sul rendimento in corso...

Puoi eseguire query sui dati sul rendimento rapidamente e senza superare la quota, eseguendo una query giornaliera per i dati di un giorno.

Devi scegliere quali informazioni vuoi includere nei dati: i tipi di ricerca (web, immagini, video e così via). e quali 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

Ti consigliamo di eseguire ogni giorno una query 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 della quota giornaliera. In genere i dati sono 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 conteggi più completi o più dimensioni nella query. Nota: per eseguire query sui dati relativi all'aspetto nella ricerca (AMP, link blu, risultato avanzato e così via) è necessario utilizzare una procedura in due passaggi.
Sfoglia 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).
Se vuoi, 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 dell'API, il metodo Search Analytics espone un massimo di 50.000 righe di dati al giorno per tipo di ricerca (web, immagini e così via, ordinati 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 includere country e/o device.
type: enumera in ogni valore type in base alle tue esigenze in una query separata.
aggregationType: deve essere byPage.

Per maggiori dettagli, incluse informazioni su pagine e/o query, a costo della perdita di alcuni dati, esegui una query come questa:

"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: include page. Se vuoi, includi qualsiasi combinazione di query, country o device.
type: esegui l'enumerazione di ogni valore type come preferisci in una query separata.

Raggruppati per proprietà

Per conteggi precisi, devi omettere le dimensioni pagina e query, come segue:

"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: facoltativamente, includi country e/o device.
type: enumera facoltativamente più di ogni valore type in base alle tue esigenze 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 di query, country o device.
type: enumera in ogni valore type in base alle tue esigenze in una query separata.

Raggruppamento dei risultati per pagina o proprietà

Le impressioni, i clic, la posizione e la percentuale di clic vengono calcolati in modo diverso quando i risultati vengono raggruppati per pagina anziché per proprietà. Scopri di più.

Perché perdo i dati quando chiedo maggiori dettagli?

Quando esegui il raggruppamento per pagina e/o query, il nostro sistema potrebbe eliminare 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 ad altre dimensioni. Pertanto, per visualizzare informazioni sull'aspetto nella ricerca per il tuo sito, devi procedere nel seguente modo:

Specifica searchAppearance come unica dimensione, che raggruppa tutti i dati per tipo di aspetto nella ricerca senza altre dimensioni.
Se vuoi, esegui una seconda query filtrando in base a uno dei tipi di visualizzazione nella ricerca elencati nel passaggio 1 e aggiungendo le dimensioni che preferisci alla query (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:

Visualizza l'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"
        }
      ]
    }
  ]
}