Ottenere i tuoi dati sul rendimento

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

Devi scegliere quali informazioni vuoi includere nei dati: tipi di ricerca (web, immagini, video e così via). e le dimensioni (pagina, query, paese o dispositivo) e raggruppare i risultati per pagina o proprietà. Durante l'esecuzione della query relativa a stringa di pagina e/o query, alcuni dati potrebbero essere eliminati (ecco perché).

Panoramica

  1. 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 deve superare la quota giornaliera. I dati sono in genere disponibili dopo 2-3 giorni; per sapere quali sono i dati più recenti disponibili, esegui una semplice query raggruppata per data negli ultimi 10 giorni. Per scrivere la query:
    • Scegli se raggruppare i risultati per pagina o proprietà.
    • Scegli se vuoi avere 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 sottoposti a query mediante una procedura in due passaggi.
  2. Scorrere 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. 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 type valore 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 di dati

Oltre alla quota di utilizzo delle API, il metodo Search Analytics espone un massimo di 50.000 righe di dati al giorno per tipo di ricerca (web, immagine e così via, ordinate per clic).

Dettagli query

Puoi eseguire query sui dati raggruppati per pagina o proprietà.

Raggruppato per pagina

Per ottenere conteggi precisi, devi omettere le dimensioni pagina e 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 valore type come preferisci in una query separata.
  • aggregationType: deve essere byPage.

Per maggiori dettagli, tra cui le informazioni su pagine e/o query, esegui una query simile a questa, ma rischia di perdere alcuni dati:

"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 valore type come preferisci in una query separata.

Raggruppato per proprietà

Per ottenere conteggi precisi, devi omettere le dimensioni pagina e 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: puoi anche enumerare ogni valore type come preferisci in una query separata.

Per maggiori dettagli, tra cui query, paese e/o informazioni sul dispositivo, puoi evitare di perdere alcuni dati eseguendo una query simile alla 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: puoi includere qualsiasi combinazione di query, country o device.
  • type: enumera ogni valore type come preferisci 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 raggruppano 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 eliminare alcuni dati per poter calcolare i risultati in un tempo ragionevole utilizzando una quantità ragionevole di risorse di elaborazione.

Ottenere i dati relativi all'aspetto nella ricerca

L'aspetto nella ricerca non è disponibile come colonna e come qualsiasi altra dimensione. Pertanto, se vuoi visualizzare informazioni sull'aspetto nella ricerca per il tuo sito, devi seguire questa procedura:

  1. Specifica searchAppearance come unica dimensione, che raggruppa tutti i dati in base al tipo di aspetto nella ricerca senza altre dimensioni.
  2. Se vuoi, puoi eseguire una seconda query, filtrando in base a uno dei tipi di aspetto nella ricerca elencati al passaggio 1, aggiungendo alla query le dimensioni desiderate (pagina, paese, query e così via).

Per recuperare i dati su più tipi di aspetto nella ricerca, devi eseguire il secondo passaggio una volta per ciascun tipo di aspetto nella ricerca indicato al passaggio 1.

Prima query:

Visualizza 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 tuo sito è di tipo 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 al passaggio 1, insieme alle dimensioni che preferisci (pagina, dispositivo e così via). Qui applichiamo il filtro 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 tipo 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
  },
...