Почасовая статистика в Search Analytics API

Среда, 9 апреля 2025 г.

Несколько месяцев назад мы сообщили о новом представлении последних данных об эффективности в Search Console – "24 часа". В нем можно посмотреть данные за истекшие сутки с задержкой в несколько часов. Здесь представлена информация о наиболее эффективных страницах и запросах за последнее время, а также о востребованности недавно опубликованного вами контента.

С сегодняшнего дня через Search Analytics API стала доступна почасовая статистика. Мы добавили ее поддержку, так как часто получали просьбы об этом. В отличие от Search Console, где приводится почасовая статистика лишь за последние сутки, API предоставляет данные с почасовой разбивкой за последние 10 дней. Это позволяет разрабатывать решения, в которых можно не только смотреть почасовые данные за прошедшие сутки, но и анализировать закономерности по разным дням недели, сравнивая статистику за определенный день и тот же день предыдущей недели.

Как запрашивать почасовую статистику в Search Analytics API

Чтобы вы могли получать почасовые данные от Search Analytics API, мы добавили в тело запроса к API следующие объекты:

  • HOUR – новый параметр ApiDimension, который позволяет выполнять разбивку данных ответа по часам;
  • HOURLY_ALL – новое значение dataState, предназначенное для использования при группировке данных по параметру HOUR. Это значение указывает на то, что почасовая статистика может быть неполной.

Далее приведены примеры запроса к API и ответа API.

Пример запроса к API

{
  "startDate": "2025-04-07",
  "endDate": "2025-04-07",
  "dataState": "HOURLY_ALL",
  "dimensions": [
    "HOUR"
  ]
}

Пример ответа API

{
  "rows": [
    {
      "keys": [
        "2025-04-07T00:00:00-07:00"
      ],
      "clicks": 17610,
      "impressions": 1571473,
      "ctr": 0.011206046810858348,
      "position": 10.073871456906991
    },
    {
      "keys": [
        "2025-04-07T01:00:00-07:00"
      ],
      "clicks": 18289,
      "impressions": 1662252,
      "ctr": 0.011002543537321658,
      "position": 9.5440029550272758
    },
    {
      "keys": [
        "2025-04-07T02:00:00-07:00"
      ],
      "clicks": 18548,
      "impressions": 1652038,
      "ctr": 0.011227344649457216,
      "position": 9.81503633693656
    },
    {
      "keys": [
        "2025-04-07T03:00:00-07:00"
      ],
      "clicks": 18931,
      "impressions": 1592716,
      "ctr": 0.01188598595104212,
      "position": 9.4956935197486558
    },
    {
      "keys": [
        "2025-04-07T04:00:00-07:00"
      ],
      "clicks": 20519,
      "impressions": 1595636,
      "ctr": 0.012859449147549943,
      "position": 9.4670100198290843
    },
    …
  ],
  "responseAggregationType": "byProperty"
}

Надеемся, что с новыми данными вам станет удобнее отслеживать эффективность недавно опубликованного контента и при необходимости своевременно принимать необходимые меры. Мы с нетерпением ждем вашего мнения о новом представлении и предложений о том, как сделать его лучше. Если вы хотите задать вопрос, оставить отзыв или комментарий, ищите нас в LinkedIn или заходите на справочный форум Центра Google Поиска.

Авторы: Тали Прусс (Tali Pruss), инженер-программист, и Дэниел Вайсберг (Daniel Waisberg), специалист по Google Поиску