Uzyskiwanie danych o skuteczności

Możesz szybko wykonywać zapytania na danych o skuteczności bez przekraczania limitu, uruchamiając dzienne zapytanie obejmujące dane z jednego dnia.

Musisz wybrać, jakie informacje chcesz umieścić w swoich danych: jakie typy wyszukiwania (sieć, obrazy, filmy itd.) i wymiarów (strona, zapytanie, kraj lub urządzenie), a także tego, czy chcesz grupować wyniki według strony lub usługi. W przypadku zapytania o stronę lub ciąg zapytania niektóre dane mogą zostać utracone (powód opisujemy tutaj).

Omówienie

  1. Zalecamy codzienne generowanie zapytań dotyczących danych z 1 dnia za pomocą jednego ze stylów zapytania opisanych poniżej. Wykonywanie dziennego zapytania dotyczącego danych z jednego dnia nie powinno przekraczać Twojego dziennego limitu. Dane są zwykle dostępne po 2–3 dniach. Możesz dowiedzieć się, jakie są najnowsze dostępne dane, wykonując proste zapytanie pogrupowane według daty z ostatnich 10 dni. Pisząc zapytanie:
    • Wybierz, czy chcesz pogrupować wyniki według strony lub usługi.
    • Zdecyduj, czy chcesz podać w zapytaniu więcej pełnych wartości, czy więcej wymiarów. Uwaga: aby wyświetlić zapytania o dane dotyczące wyglądu w wyszukiwarce (AMP, niebieski link, wynik z elementami rozszerzonymi itd.), musisz skorzystać z 2-etapowego procesu.
  2. Przejrzyj wyniki, uruchamiając ponownie to samo zapytanie, zwiększając wartość startRow w żądaniu o 25 000 do momentu, aż dotrzesz do ostatniej strony (odpowiedź z 0 wierszami).
  3. Opcjonalnie uruchom to samo zapytanie z innym parametrem type.

Oto pseudokod dla pojedynczego zapytania. Możesz ją uruchomić raz dziennie dla każdej wartości type, której dane chcesz poznać.

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 Search Analytics udostępnia maksymalnie 50 tys. wierszy danych dziennie na każdy typ wyszukiwania (sieć, obraz itd. posortowane według kliknięć).

Szczegóły zapytania

Dane możesz grupować według strony lub usługi.

Pogrupowane według strony

Aby umożliwić dokładne zliczanie, pomiń wymiary strony i zapytania w ten sposób:

"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 możesz użyć country lub device.
  • type: Oblicz więcej niż każdej wartości type w zależności od potrzeb w oddzielnym zapytaniu.
  • aggregationType: musi to być byPage.

Aby uzyskać więcej szczegółów, w tym informacje o stronie lub zapytaniu, możesz stracić dostęp do niektórych danych:

"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 możesz dodać dowolną kombinację atrybutów query, country lub device.
  • type: Oblicz więcej niż każdej wartości type w zależności od potrzeb w oddzielnym zapytaniu.

Pogrupowane według usługi

Aby umożliwić dokładne zliczanie, pomiń wymiary strony i zapytania w ten sposób:

"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 możesz użyć country lub device.
  • type: opcjonalnie wydzielaj więcej niż type wartość zgodnie z potrzebami w oddzielnym zapytaniu.

Aby uzyskać więcej szczegółów, w tym informacje o zapytaniu, kraju lub urządzeniu, możesz stracić dostęp do niektórych danych:

"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 dodać dowolną kombinację atrybutów query, country lub device.
  • type: Oblicz więcej niż każdej wartości type w zależności od potrzeb w oddzielnym zapytaniu.

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

Wyświetlenia, kliknięcia, pozycja i współczynnik klikalności są obliczane inaczej podczas grupowania wyników według strony, a nie według usługi. Więcej informacji

Dlaczego tracę dane, gdy potrzebuję dodatkowych informacji?

Jeśli pogrupujesz według strony lub zapytania, nasz system może usunąć część danych, aby w rozsądnym czasie obliczyć wyniki przy rozsądnej ilości zasobów obliczeniowych.

Uzyskiwanie danych o wyglądzie w wyszukiwarce

Wygląd w wyszukiwarce jest niedostępny jako kolumna w połączeniu z innymi wymiarami. Jeśli chcesz zobaczyć informacje o wyglądzie witryny w wyszukiwarce, musisz wykonać te czynności:

  1. Określ searchAppearance jako jedyny wymiar, który pogrupuje wszystkie dane według typu wyglądu w wyszukiwarce bez żadnych innych wymiarów.
  2. Opcjonalnie możesz uruchomić drugie zapytanie, filtrując je według jednego z typów wyglądu w wyszukiwarce wymienionych w kroku 1, dodając dowolne wymiary (zapytanie, kraj, zapytanie itp.).

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

Pierwsze zapytanie:

Uzyskaj listę typów wyglądu w wyszukiwarce dla swojej witryny.

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

Wyniki:

Typ Twojej witryny to 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:

Filtruj według jednego z typów wyglądu w wyszukiwarce znalezionych w kroku 1, wraz z dowolnymi wymiarami (strona, urządzenie itp.). 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:

Zestawienie danych 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
  },
...