Recupero dei dati sul rendimento in corso...

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

  1. 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.
  2. 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).
  3. 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 includere country e/o device.
  • type: enumera ogni type valore come preferisci in una query separata.
  • aggregationType: deve essere byPage.

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: includi page. Se vuoi, puoi includere qualsiasi combinazione di query, country o device.
  • type: enumera ogni type 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 includere country e/o device.
  • type: se vuoi, enumera ogni type 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 di query, country o device.
  • type: enumera ogni type 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:

  1. Specifica searchAppearance come unica dimensione, in modo da raggruppare tutti i dati per tipo di aspetto nella ricerca senza altre dimensioni.
  2. 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
  },
...