Получение данных о вашей производительности

Вы можете запросить данные о производительности быстро и без превышения квоты, выполняя ежедневный запрос данных за один день.

Вы должны выбрать, какую информацию вы хотите видеть в своих данных: какие типы поиска (веб, изображения, видео и т. д.) и какие измерения (страница, запрос, страна или устройство), а также группировать ли результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).

Обзор

  1. Мы рекомендуем выполнять запрос каждый день для получения данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2–3 дня; вы можете узнать, какие данные были доступны в последнее время, выполнив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
    • Выберите, группировать ли результаты по страницам или свойствам.
    • Выберите, хотите ли вы получить больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде поиска (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
  2. Просматривайте результаты, повторно запуская тот же запрос, увеличивая значение startRow в запросе на 25 000, пока не дойдете до последней страницы (ответ с 0 строками).
  3. При необходимости запустите тот же запрос с другим параметром type .

Вот пример псевдокода для одного запроса. Вы можете запускать это один раз в день для каждого значения type , для которого вам нужны данные.

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

Ограничения данных

Помимо квоты на использование API, метод Search Analytics предоставляет максимум 50 тысяч строк данных в день для каждого типа поиска (веб-сайт, изображения и т. д. – с сортировкой по кликам).

Подробности запроса

Вы можете запрашивать данные, сгруппированные по страницам или свойствам .

Сгруппировано по страницам

Для точных подсчетов необходимо опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при необходимости укажите country и/или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.
  • aggregationType : Должно быть byPage .

Для получения более подробной информации, включая информацию о странице и/или запросе , за счет потери некоторых данных, запустите такой запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : Включить page . При необходимости укажите любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Сгруппировано по свойству

Для точных подсчетов необходимо опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при необходимости укажите country и/или device .
  • type : при желании можно перечислить каждое значение type в отдельном запросе.

Для получения более подробной информации, включая информацию о запросе, стране и/или устройстве , за счет потери некоторых данных, запустите такой запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при желании можно включить любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Группировка результатов по странице или свойству

Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.

Почему я теряю данные при запросе более подробной информации?

Когда вы группируете данные по страницам и/или запросам, наша система может удалить некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки, используя разумное количество вычислительных ресурсов.

Получение данных о появлении в результатах поиска

Внешний вид поиска недоступен в виде столбца вместе с другими измерениями. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в результатах поиска, вам необходимо выполнить следующий процесс:

  1. Укажите searchAppearance как единственное измерение, которое будет группировать все данные по типу внешнего вида поиска без других измерений.
  2. При необходимости запустите второй запрос, отфильтровав его по одному из типов поиска, перечисленных на шаге 1, добавив в запрос любые желаемые параметры (страница, страна, запрос и т. д.).

Чтобы получить данные о нескольких типах результатов поиска, необходимо выполнить второй шаг один раз для каждого типа результатов поиска, указанного в шаге 1.

Первый запрос:

Получите список типов поисковых запросов на вашем сайте.

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

Результаты:

Ваш сайт имеет тип INSTANT_APP, AMP_BLUE_LINK и т. д.

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

Второй запрос:

Фильтруйте по одному из типов внешнего вида поиска, найденных на шаге 1, а также по любым размерам, которые вам нравятся (страница, устройство и т. д.). Здесь мы фильтруем по 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"
        }
      ]
    }
  ]
}

Результаты:

Разбивка AMP_BLUE_LINK по типам устройств.

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