Pobieram dane o skuteczności

Możesz szybko tworzyć zapytania o dane wydajności bez przekraczania limitu, przez wykonując codzienne zapytanie dotyczące danych z jednego dnia.

Musisz wybrać informacje, które chcesz umieścić w danych: jakiego typu wyszukiwania (sieć, grafika, wideo itd.) wymiarów (strona, zapytanie, kraj lub urządzenie) i zdecydować, pogrupuj wyniki według strony lub usługę. Podczas wysyłania zapytania o stronę lub ciąg zapytania niektóre dane mogą zostać pominięte (tutaj znajdziesz przyczynę).

Omówienie

Zalecamy wykonywanie zapytania codziennie dla danych z jednego dnia przy użyciu jednego z zapytań stylów opisanych poniżej. Przeprowadzanie codziennego zapytania dotyczącego danych z 1 dnia nie powinno przekraczać dziennego limitu. Dane są zwykle dostępne po 2–3 dniach. Aby sprawdzić, które dane są dostępne, wykonaj proste zapytanie pogrupowane według daty za ostatnie 10 dni. W formie zapytania:
- Zdecyduj, czy chcesz grupować wyniki według strony czy usługi.
- Zdecyduj, czy w zapytaniu chcesz uwzględnić więcej pełnych danych czy wymiarów. Uwaga: zapytania o dane dotyczące wyglądu w wyszukiwarce (AMP, niebieski link, wynik z elementami rozszerzonymi itp.) trzeba wysyłać w ramach procesu dwuetapowego.
Przejrzyj wyniki, ponownie uruchamiając to samo zapytanie, zwiększając w żądaniu wartość startRow o 25 000, aż wyświetlisz ostatnią stronę (odpowiedź z 0 wierszami).
Opcjonalnie uruchom to samo zapytanie z innym parametrem type.

Oto przykładowy pseudokod dla pojedynczego zapytania. Możesz go wykonywać raz dziennie dla każdej wartości type, której dotyczą dane.

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

Limity danych

Oprócz limitu wykorzystania interfejsu API metoda Analityka wyszukiwania udostępnia maksymalnie 50 tys. wierszy danych dziennie dla każdego typu wyszukiwania (sieć, obraz itd. – posortowane według kliknięć).

Szczegóły zapytania

Możesz wysyłać zapytania o dane pogrupowane według strony lub usługi.

Pogrupowane według strony

Aby zwiększyć dokładność liczb, musisz pominąć takie wymiary strony i zapytania:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"

startDate / endDate: wybierz 1-dniowy okres, wybierając tę samą datę.
dimensions: opcjonalnie uwzględnij country lub device.
type: wylicz ponad każdą wartość type w osobnym zapytaniu.
aggregationType: musi być byPage.

Aby uzyskać więcej szczegółowych informacji, w tym informacje o stronie lub zapytaniu, kosztem utraty niektórych danych, uruchom takie zapytanie:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"

startDate / endDate: wybierz 1-dniowy okres, wybierając tę samą datę.
dimensions: uwzględnij page. Opcjonalnie uwzględnij dowolną kombinację atrybutów query, country lub device.
type: w oddzielnym zapytaniu wylicz każdą wartość type.

Pogrupowano według usługi

Aby zwiększyć dokładność liczb, musisz pominąć takie wymiary strony i zapytania:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"

startDate / endDate: wybierz jednodniowy okres, wybierając tę samą datę.
dimensions: opcjonalnie dodaj country lub device.
type: opcjonalnie wylicz każdą wartość type w osobnym zapytaniu.

Aby uzyskać więcej szczegółów, w tym informacje o zapytaniu, kraju lub urządzeniu, groźną utratą części danych uruchom takie zapytanie:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"

startDate / endDate: wybierz jednodniowy okres, wybierając tę samą datę.
dimensions: opcjonalnie możesz uwzględnić dowolną kombinację tych atrybutów: query, country lub device.
type: wylicz ponad każdą wartość type w osobnym zapytaniu.

Grupowanie wyników według strony lub usługi

Wyświetlenia, kliknięcia, pozycje i współczynniki klikalności są obliczane inaczej, gdy wyniki są grupowane według strony, a nie według usługi. Więcej informacji

Dlaczego utracę dane, gdy pytam o więcej szczegółów?

Gdy grupowanie odbywa się według strony lub zapytania, nasz system może pominąć niektóre dane, aby umożliwić obliczenie wyników w rozsądnym czasie przy użyciu rozsądnej ilości zasobów obliczeniowych.

Uzyskiwanie danych o wyglądzie w wyszukiwarce

Wygląd w wyszukiwarce nie jest dostępny jako kolumna razem z żadnymi innymi wymiarami. Jeśli chcesz zobaczyć informacje o wyświetleniu witryny w wyszukiwarce, musisz wykonać te czynności:

Jako jedyny wymiar możesz podać wymiar searchAppearance, który zgrupuje wszystkie dane według typu wyglądu w wyszukiwarce bez żadnych innych wymiarów.
Opcjonalnie możesz uruchomić drugie zapytanie, filtrując je według jednego z typów wyglądu w Discover wymienionych w kroku 1. Dodaj do zapytania dowolne wymiary (np. stronę, kraj, zapytanie).

Aby pobrać dane o różnych typach wyglądu w wyszukiwarce, musisz wykonać drugi krok raz dla każdego typu wyglądu w wyszukiwarce wymienionego w kroku 1.

Pierwsze zapytanie:

uzyskać listę typów wyglądu w wyszukiwarce w Twojej witrynie;

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

Wyniki:

Twoja witryna ma typ INSTANT_APP, AMP_BLUE_LINK itp.

 "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
  },...

Drugie zapytanie:

Przefiltruj listę według jednego z typów wyglądu w wyszukiwarce wymienionych w kroku 1 i podanych w nich wymiarów (strona, urządzenie itp.). Tutaj filtrujemy według kolumny 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"
        }
      ]
    }
  ]
}