Data Studio: построение отчётов на данных AutoPSEO

AutoPSEO не предоставляет коннектор для Data Studio — инструмента Google для дашбордов, ранее называвшегося Looker Studio. Тем не менее показатели AutoPSEO можно вывести там тремя способами: через собственный коннектор Search Console от Google (сырые данные), через CSV, экспортированный из отчёта AutoPSEO, или через таблицу Google Sheets, которую по расписанию заполняет скрипт, обращающийся к REST API AutoPSEO. Выбор зависит от того, насколько актуальным должен быть дашборд и нужны ли вам аналитические выводы AutoPSEO или достаточно сырых метрик.

Вариант 1: коннектор Search Console от Google

Коннектор Google читает данные прямо из Search Console, поэтому даёт сырые метрики без аналитики AutoPSEO. Согласно руководству Google по коннектору:

• Доступны две таблицы, Site Impression и URL Impression, и один источник данных использует только одну из них. Чтобы показать обе, добавьте в отчёт два источника данных.
• Нужен как минимум доступ на просмотр к ресурсу Search Console, причём в оба сервиса следует войти под одним и тем же аккаунтом Google.
• Site Impression охватывает результаты веб-поиска, изображений, видео и новостей; URL Impression дополнительно включает Discover и Google News.

Чтобы подключить коннектор, выберите Create → Data Source → Search Console, укажите сайт, таблицу и тип поиска по умолчанию, затем нажмите Connect.

Вариант 2: загрузка CSV из AutoPSEO

Для разового или ежемесячного дашборда экспортируйте таблицу из любого отчёта (Экспорт данных) и добавьте её через коннектор загрузки CSV-файлов в Data Studio. Как именно экспортировать, определяют требования Google к загрузке:

• Поля должны разделяться запятыми, поэтому сначала выберите в Account → CSV export format значение Standard (US / UK).
• Файл должен быть в кодировке UTF-8 и содержать строку заголовков; экспорт AutoPSEO этим требованиям соответствует.
• Все файлы, добавляемые в набор данных, должны иметь строго одинаковые столбцы в одном и том же порядке, поэтому каждый раз экспортируйте один и тот же отчёт с теми же столбцами и тем же параметром сравнения.
• Новые файлы дописываются в набор, а дубликаты не удаляются, поэтому не загружайте файлы с пересекающимися диапазонами дат.
• Размер файла — до 100 МБ, а на каждого пользователя выделяется 2 ГБ хранилища для загрузок.

Проценты экспортируются со знаком процента (27.03%), поэтому после загрузки проверьте типы полей.

Вариант 3: таблица Google Sheets, которую заполняет REST API

Чтобы дашборд обновлялся сам, настройте регулярное задание, которое записывает данные AutoPSEO в таблицу Google Sheets, и подключите эту таблицу. Коннектор Google Sheets проверяет изменённые значения и новые строки при каждом запросе данных отчётом.

1. В AutoPSEO откройте раздел MCP & API и создайте API-ключ с областью доступа Read only. Ключ показывается один раз, поэтому сохраните его в секретах вашего задания.
2. Из регулярного задания (Google Apps Script, задача cron или инструмент автоматизации) обращайтесь к REST API и записывайте строки в таблицу.
3. В Data Studio добавьте таблицу через коннектор Google Sheets и отметьте Use first row as headers.

Запрос топа поисковых запросов за последние 28 дней выглядит так:

curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
  -H "Authorization: Bearer apk_live_..."

Каждый ответ приходит в формате JSON: результат находится в поле data, а сведения о вызове — в поле meta. REST API предоставляет те же 19 инструментов Search Console и GA4, что и сервер MCP: ресурсы, строки поисковой аналитики, топ запросов, страниц и стран, сравнение периодов, изменения позиций, новые и потерянные позиции, спад контента, каннибализацию, бенчмарк CTR, перехват страниц (page poaching), проверку URL, файлы Sitemap, аннотации, а также обзор GA4, разбивки и ключевые события. Топ запросов и топ страниц возвращают до 1000 строк, топ стран — до 300, а search-analytics — до 5000 необработанных строк для одного или двух измерений. Количество вызовов ограничено: 60 в минуту на ключ и 1000 в час на аккаунт, а документ OpenAPI 3.1 по адресу https://app.autopseo.com/v1/openapi.json описывает каждый параметр.

Какой вариант выбрать

Если дашборд нужен в основном для того, чтобы показать клиенту цифры, проще может оказаться ссылка на общий отчёт или регулярный отчёт в Slack или Teams. В нашем FAQ о Search Console в Looker Studio коннектор Google разобран подробнее.