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
- 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.
- 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). - 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ędnijcountry
lubdevice
.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ędnijpage
. Opcjonalnie uwzględnij dowolną kombinację atrybutówquery
,country
lubdevice
.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ędnijcountry
lubdevice
.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
lubdevice
.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:
- Wybierz
searchAppearance
jako jedyny wymiar, który będzie grupować wszystkie dane według typu wyglądu w wyszukiwarce bez innych wymiarów. - 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 }, ...