Sleek laptop showcasing data analytics and graphs on the screen in a bright room.

Search Analytics API: nowe filtry marki, multimodal i krajów

Search Analytics API dostało filtrowanie zapytań markowych, typ danych webMultimodal i pole filterLists dla wielu krajów oraz urządzeń naraz.

Google dodało do Search Analytics API trzy nowe możliwości: filtrowanie według zapytań markowych, typ danych webMultimodal oraz pole filterLists do filtrowania wielu krajów i urządzeń w jednym żądaniu. Zmiana dotyczy osób, które pobierają dane z Search Console automatycznie lub budują własne raporty. Wszystkie opcje były wcześniej dostępne w interfejsie webowym Search Console, a teraz działają także w API.

Najważniejsze

  • Filtr zapytań markowych pozwala grupować dane według marki i porównywać wyniki zapytań markowych z niemarkowymi.
  • Typ webMultimodal zwraca dane z Google Lens, Circle to Search na Androidzie oraz z przesyłania obrazów w Wyszukiwarce.
  • Pole filterLists umożliwia filtrowanie po kilku krajach lub urządzeniach w jednym żądaniu.
  • Dane o zapytaniach markowych są dostępne tylko dla kwalifikujących się właściwości.

Co dokładnie dodano do API

Google wskazało, że zmiana odpowiada na prośby społeczności, które chciały pobierać te dane do własnych raportów i zautomatyzowanych procesów. Filtrowanie zapytań markowych służy do klasyfikacji branded i non-branded, czyli do porównania wyników marki z wynikami ogólnymi. Komunikat nie podaje, czy istnieją dodatkowe limity dla tej funkcji.

Nowa opcjaCo umożliwiaWarunek
Zapytania markowe (branded)Grupowanie i filtrowanie według klasyfikacji brandedKwalifikująca się właściwość w Search Console
Typ webMultimodalDane z Google Lens, Circle to Search i przesyłania obrazówDane w BigQuery tylko przy aktywnym masowym eksporcie
Pole filterListsFiltrowanie wielu krajów i urządzeń w jednym żądaniuBrak dodatkowego warunku w komunikacie

Dane multimodalne i BigQuery

Typ webMultimodal obejmuje ruch związany z wyszukiwaniem obrazowym i wizualnym. Dane z tego typu trafiają do BigQuery wyłącznie dla właściwości z aktywnym masowym eksportem danych. Komunikat nie podaje, od kiedy dane historyczne są dostępne w tym typie.

Co to oznacza w praktyce

Zespoły korzystające z API powinny najpierw sprawdzić, czy ich właściwości kwalifikują się do danych markowych. Dla pozostałych właściwości odpowiedź będzie pusta, więc skrypty warto zabezpieczyć przed błędnym wnioskiem o braku ruchu. Dane webMultimodal warto raportować osobno od typu web, bo mają własny typ żądania. Pole filterLists upraszcza raporty dla kilku rynków, np. polskiego i innych krajów z jednej firmy, bez osobnych zapytań dla każdego z nich. Komunikat nie podaje daty wycofania wcześniejszych sposobów pobierania tych zestawień.

Jeśli raporty z Search Console budujesz w skryptach lub w BigQuery, sprawdź najpierw kwalifikowalność właściwości do danych markowych. Dane multimodalne raportuj osobno, a zestawienia wielokrajowe przenieś na filterLists, aby zmniejszyć liczbę żądań.

Komentarz redakcji Info24

Czytaj także

Najczęstsze pytania

Czy filtr zapytań markowych działa dla każdej witryny?

Nie, dane dotyczące zapytań markowych są dostępne tylko dla kwalifikujących się właściwości w Search Console. W przypadku pozostałych właściwości odpowiedź API nie zawiera żadnych wierszy.

Co zwraca typ webMultimodal w Search Analytics API?

Typ webMultimodal zwraca dane o skuteczności z Google Lens, Circle to Search na Androidzie oraz z przesyłania obrazów w Wyszukiwarce Google. Dla właściwości z aktywnym masowym eksportem danych te dane są też dostępne w BigQuery.

Po co jest pole filterLists?

Pole filterLists pozwala filtrować dane po kilku krajach lub urządzeniach w jednym żądaniu. Wcześniej takie zestawienia wymagały osobnych zapytań dla każdego kraju lub urządzenia.