Перевод статьи с портала MOZ.
Даже если вы не так давно занимаетесь SEO, вам наверняка знаком сервис Google Search Console (GSC). Это ценный инструмент для получения информации о вашем сайте и его эффективности при органическом поиске. Тем не менее, у GSC есть свои ограничения.
В этой статье мы расскажем, как получать из Google Search Console более согласованные данные, а также как увеличить экспорт на 400%.
Ограничения Google Search Console
Google Search Console содержит несколько разделов, но мы сосредоточимся на отчете «Эффективность». С помощью панели управления GSC доступ к этому отчету можно получить двумя способами:
Рисунок 1. Отчет «Эффективность»
В отчете «Эффективность» выберите данные по запросам и страницам:
Рисунок 2. Данные по запросам и страницам
Здесь мы сталкиваемся с первой проблемой GSC: данные по запросам и по страницам разделены.
Другими словами, если я хочу увидеть запросы, по которым ранжируется определенная страница, я должен сначала нажать на вкладку «Страницы», выбрать нужную страницу, а затем вернуться назад к вкладке «Запросы». Получается весьма трудоемко.
Другая проблема связана с экспортом и состоит из двух частей:
- Данные об эффективности по запросам и страницам необходимо экспортировать отдельно.
- Экспорт ограничен 1000 строками.
Однако мы постараемся решить эти проблемы через API Google Search Console.
Что такое API Google Search Console?
Итак, теперь мы знаем, что у пользовательского интерфейса GSC есть определенные ограничения: весьма сложно связать данные запроса с данными страницы, а экспорт ограничен.
Если пользовательский интерфейс GSC представляет настройки по умолчанию, то API-интерфейс позволяет использовать особые параметры. Это требует определенных усилий, однако открывает широкие возможности для управления отчетами (по крайней мере, в области данных запросов и страниц).
API Google Search Console — удобный доступ к данным в учетной записи, а также возможность определенным образом настраивать запросы и получать конкретные результаты. С его помощью можно даже обойти некоторые настройки по умолчанию, например, экспорт, ограниченный 1000 строками.
Зачем использовать API
Как вы помните, в стандартном интерфейсе GSC данные запросов и страниц разделены. С помощью API мы можем связать данные запроса со страницей, которая ранжируется по этому запросу, так что больше не нужно перемещаться вперед и назад по отчетам и ждать, пока загрузятся все данные.
Кроме того, мы обнаружили, что экспорт ограничен 1000 строками. С помощью API мы можем запросить до 5000 строк, что на 400% больше!
Итак, давайте попробуем сделать такой запрос и получить более надежный и значимый набор данных.
Настройка
Войдите в соответствующую учетную запись Google Search Console на этой странице (в правом верхнем углу). Например, если мой сайт — example.com, то я могу просматривать эту учетную запись Search Console с помощью адреса admin@email.com.
Введите URL-адрес соответствующей учетной записи GSC:
Рисунок 3. URL-адрес учетной записи GSC
Настройте свой запрос:
1. Укажите дату начала (startDate). Формат даты: ГГГГ-ММ-ДД.
2. Укажите дату окончания (endDate).
3. Настройте параметры. Доступны следующие параметры:
- запрос (query);
- страница (page);
- устройство (device);
- и/или страна (country).
4. Настройте фильтры (дополнительно). Фильтр должен включать:
- параметры (доступные параметры: запрос, страница, устройство или страна);
- операторы (доступные операторы: contains, notContains, equals, notEquals);
- выражения (любые значения, связанные с параметрами).
5. Укажите предельное количество строк (rowLimit). С помощью API Google Search Console вы можете запросить до 5000 строк!
Для страницы в нашем примере достаточно самой простой настройки, но в других случаях она может быть весьма утомительной и запутанной. Я сделал всю неприятную работу за вас и создал файл JSON, который вы можете быстро и легко редактировать, чтобы получить желаемый результат API.
Запрос без фильтров
Вы можете отправить запрос, который не содержит в себе каких-либо фильтров. Мы укажем нужные нам даты, параметры и ограничение на количество строк, после чего отправим запрос.
Порядок, в котором вы размещаете параметры, соответствует порядку, в котором придут результаты.
API выводит данные для настольных компьютеров, мобильных устройств и планшетов по отдельности. Числа, которые вы видите в пользовательском интерфейсе Google Search Console (например, количество кликов) представляют собой совокупные данные по всем трем устройствам (если вы не применяете фильтрацию).
Также при желании вы можете включить в запрос параметр «страна» (country).
{
"startDate": "2019-11-01",
"endDate": "2020-01-31",
"dimensions":
[
"query",
"page",
"device"
],
"rowLimit": 3000
}
Запрос с фильтрами
Эта версия запроса будет включать фильтры, которые помогут получить более точный результат.
В качестве фильтров можно указать параметры/операторы/выражения. Ниже приведены примеры нескольких возможных фильтров:
- query contains go fish digital;
- page equals https://gofishdigital.com/;
- device notContains tablet.
Вероятно, как и в обычном пользовательском интерфейсе Google Search Console, для каждого параметра доступен только один фильтр.
{
"startDate": "2019-11-01",
"endDate": "2020-01-31",
"dimensions":
[
"query",
"page",
"device"
],
"dimensionFilterGroups":
[
{
"filters":
[
{
"dimension": "device",
"operator": "notContains",
"expression": "tablet"
}
]
}
],
"rowLimit": 3000
}
Выберите шаблон, с фильтром или без фильтра, и введите свои собственные значения (вы можете изменить все данные, которые идут после двоеточия, если вас не устраивают мои настройки).
Выполните запрос
Ура! Теперь у вас есть два шаблона запросов, которые вы можете редактировать на свой вкус. Давайте попробуем сделать запрос. Нажмите на поле «Текст запроса» (Request body), выберите все и вставьте свой JSON:
Рисунок 4. Запрос
Вы можете вручную настроить ключи и значения запроса, но, как я уже говорил ранее, это может быть чрезвычайно утомительным, поэтому я проделал всю работу за вас.
Прокрутите вниз и нажмите «Выполнить». На этом этапе вам также может быть предложено войти в систему.
Если все данные введены правильно, ваш запрос будет удовлетворен и API вернет нужные результаты. Если вы получили сообщение об ошибке, первым делом проверьте свой запрос, а затем, при необходимости, правильность выполненных действий и введенных данных.
Нажмите на поле в правом нижнем углу (это ответ API), выберите и скопируйте информацию.
Рисунок 5. Ответ API
Конвертация из JSON в CSV
Excel или Таблицы — гораздо более удобный инструмент для работы с данными, поэтому давайте преобразуем результаты JSON в CSV.
Используйте конвертер, например, этот, и вставьте в выходной файл JSON. Теперь вы можете экспортировать файл CSV. При необходимости обновите заголовки столбцов.
Запрос своих собственных данных
Большинство SEO-специалистов предпочитает работать в Excel, поэтому теперь вы можете запрашивать данные любым удобным способом.
Одна из наиболее частых задач — это поиск данных, связанных с определенным набором страниц. Чтобы найти совпадения, вам нужно добавить лист с набором страниц и использовать функцию ВПР (VLOOKUP).
Результат API в виде электронной таблицы также позволяет выполнять наиболее распространенные действия в Excel, такие как сортировка, фильтрация и создание диаграмм.
Больше возможностей Google Search Console
Google Search Console предоставляет важные данные для SEO-специалистов. А с помощью API вы можете не только запросить большие объемы данных, но и получить их в более компактном и связном формате.
Сегодня мы преодолели два препятствия, с которыми пользователи часто сталкиваются в стандартном интерфейсе GSC: отдельные отчеты по запросам/страницам и ограниченный экспорт. Я надеюсь, что использование API-интерфейса Google Search Console выведет ваш анализ данных и понимание процессов на новый уровень.
В то время как мои шаблоны JSON охватывают наиболее распространенные сценарии запроса, руководство Google предоставляет более подробную информацию.
Автор: Брайан Горман
P.s. Подписывайтесь на наш телеграм-канал t.me/seoantteam, чтобы первыми узнавать о выходе новых материалов. Мы публикуем только полезный контент по SEO, например, руководство по Google Alerts для построения ссылок, статья от крутого мирового эксперта про E-A-T-факторы Google или интересный эксперимент Airbnb об измерении показателей трафика сайта.
