Pobieram dane o skuteczności

Możesz szybko tworzyć zapytania o dane o wydajności bez przekraczania limitu, uruchamiają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 czy urządzenie) oraz czy pogrupować wyniki według strony lub usługi. Podczas wysyłania zapytania o stronę lub ciąg zapytania niektóre dane mogą zostać pominięte (tutaj znajdziesz przyczynę).

Przegląd

  1. Zalecamy wykonywanie zapytania codziennie dla danych z jednego dnia przy użyciu jednego ze stylów zapytań opisanych poniżej. Wykonywanie codziennego zapytania dotyczącego danych z jednego dnia nie powinno przekraczać limitu dziennego. Dane są zwykle dostępne po 2–3 dniach. Aby poznać najnowsze dostępne dane, uruchom proste zapytanie pogrupowane według daty z ostatnich 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.
  2. Przejrzyj wyniki, ponownie uruchamiając to samo zapytanie, zwiększając wartość startRow o 25 000, aż wyświetlisz ostatnią stronę (odpowiedź z 0 wierszami).
  3. Opcjonalnie uruchom to samo zapytanie z innym parametrem type.

Oto przykład pseudokodu dla pojedynczego zapytania. Możesz uruchamiać tę operację raz dziennie dla każdej wartości type, której chcesz używać w danych.

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., posortowanych 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 jednodniowy okres, wybierając tę samą datę.
  • dimensions: opcjonalnie uwzględnij country lub device.
  • type: wylicz każdą wartość type w osobnym zapytaniu.
  • aggregationType: musi być byPage.

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

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate: wybierz jednodniowy okres, wybierając tę samą datę.
  • dimensions: uwzględnij page. Opcjonalnie uwzględnij dowolną kombinację atrybutów query, country lub device.
  • type: wylicz każdą wartość type w osobnym zapytaniu.

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 uwzględnij 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 każdą wartość type w osobnym zapytaniu.

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

Gdy grupujesz wyniki według strony, a nie według usługi, wyświetlenia, kliknięcia, pozycja i współczynnik klikalności są obliczane inaczej. Więcej informacji

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

W przypadku grupowania według strony lub zapytania nasz system może usunąć część danych, aby obliczyć wyniki w rozsądnym czasie przy użyciu uzasadnionej 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 więc chcesz zobaczyć informacje o wyglądzie swojej witryny w wyszukiwarce, wykonaj te czynności:

  1. Wybierz searchAppearance jako jedyny wymiar, który będzie grupować wszystkie dane według typu wyglądu w wyszukiwarce bez innych wymiarów.
  2. Opcjonalnie uruchom drugie zapytanie, filtrując je według jednego z typów wyglądu w wyszukiwarce wymienionych w kroku 1 i dodając do niego dowolne wymagane wymiary (strona, kraj, zapytanie itp.).

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:

Pobierz listę typów wyglądu w wyszukiwarce dostępnych w Twojej witrynie.

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

Wyniki:

Twoja witryna używa typu INSTANT_APP, AMP_BLUE_LINK itd.

 "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: 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"
        }
      ]
    }
  ]
}

Wyniki:

Podział strony AMP_BLUE_LINK według typu urządzenia.

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