Renta / Документация / Источники / Google Search Console

Google Search Console

Renta позволяет выгружать данные Google Search Console в ваше хранилище данных: ежедневные метрики поисковой эффективности (клики, показы, CTR, среднюю позицию) с разбивками по запросу, странице, стране и устройству.

Аутентификация

Для аутентификации в Google Renta использует OAuth. Вы будете перенаправлены на Google, чтобы предоставить Renta доступ только на чтение данных Search Console.

Учётные данные шифруются при передаче и хранении и не сохраняются в прикладной базе данных Renta. Вы сохраняете контроль и можете отозвать доступ в настройках аккаунта Google в любой момент.

Подключение источника Google Search Console

Выполните следующие шаги, чтобы добавить Google Search Console как источник в Renta через OAuth-авторизацию.

Перейдите в CatalogStep 1
  1. Перейдите в раздел Connections > Catalog в левой панели.
  2. Откройте категорию Advertising и нажмите на карточку Google Search Console.
Карточка Google Search Console в категории Advertising каталога Renta
Авторизуйте подключениеStep 2

Нажмите Log in to your Google Search Console account. Вы будете перенаправлены на Google для предоставления доступа.

Страница авторизации подключения Google Search Console в Renta
Разрешите доступ в GoogleStep 3

На экране согласия Google проверьте запрашиваемые разрешения и нажмите Continue. После этого вы вернётесь в Renta.

Экран согласия Google с запросом доступа для Renta
Укажите имя подключения и сохранитеStep 4

Завершите настройку:

  1. Source name.
    Укажите имя источника данных. Оно используется только в интерфейсе Renta.
  2. Access granted.
    Убедитесь, что аккаунт подключён успешно.

Нажмите Save для завершения.

Если ваша авторизация в Google изменится (например, после смены пароля), нажмите Re-authorize на этом источнике. Подключение обновится на месте, и все пайплайны на нём продолжат работать.

Настройка подключения Google Search Console с именем источника и подтверждённым доступом
Источник созданStep 5

Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.

Список Sources с новым источником Google Search Console

Создание пайплайна Google Search Console

Выберите Google Search Console как источникStep 1

В левой панели нажмите New pipeline. На шаге Source выберите Google Search Console в списке Already connected и нажмите Next step.

Шаг выбора источника с Google Search Console в списке Already connected
Выберите подключение Google Search ConsoleStep 2

Выберите подключение Google Search Console, созданное ранее, и нажмите Next step.

Шаг выбора подключения Google Search Console
Выберите назначениеStep 3

На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.

Шаг выбора назначения с Google BigQuery
Выберите подключение назначенияStep 4

Выберите подключение назначения, в которое загружать данные, и нажмите Next step.

Шаг выбора подключения Google BigQuery

Настройка пайплайна

На финальном шаге выберите сайт, данные которого выгружать, и настройте загрузку.

Настройка отчёта

Укажите для пайплайна сайт и тип отчёта.

Выбор сайта и типа отчёта Google Search Console
  1. Websites.
    Выберите сайт Search Console, статистику которого нужно получать. В списке отображаются сайты, доступные подключённому аккаунту Google.
  2. Report Type.
    Выберите Search Analytics. Это отчёт о поисковой эффективности, те же данные, что в разделе Performance в Search Console.

Параметры

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

Выбор параметров Google Search Console
НазваниеИмя в APIОписание
Date
date		dateDate of action.
Country
text		countryThree-letter country code (ISO 3166-1 alpha-3) indicating the country from which the search originated (e.g., USA, RUS, DEU).
Device Type
text		deviceType of device used in the search. Possible values are DESKTOP, MOBILE and TABLET.
Search Query
text		queryThe search term entered by users in Google Search.
Page URL
text		pageThe page on your site shown in the search results (full canonical URL).
Clicks
int		clicksNumber of times the search result was clicked.
Impressions
int		impressionsNumber of times the search result was shown in Google Search.
Click-Through Rate
float		ctrClick-through rate calculated as clicks divided by impressions.
Average Position
float		positionThe average position of the search result in Google Search.

При выбранном параметре Search Query Google не включает в ответ анонимизированные (редкие) запросы, поэтому суммы могут быть ниже, чем в отчётах без разбивки по запросам.

Тип поиска и состояние данных

Выберите, какую поисковую поверхность покрывает статистика и включать ли свежие данные.

Выбор типа поиска и состояния данных Google Search Console с именами интеграции и таблицы

  1. Search Type Выберите тип поисковых данных для выгрузки.

    Тип поискаОписание
    WebРезультаты обычного поиска с общей вкладки (All) в Google Поиске. Не включает результаты Discover и Google News.
    DiscoverРезультаты в ленте Google Discover, персонализированные рекомендации контента.
    Google NewsРезультаты с news.google.com и из приложения Google News на Android и iOS. Не включает результаты вкладки News в Google Поиске.
    NewsРезультаты поиска с вкладки News в Google Поиске.
    ImageРезультаты поиска с вкладки Image в Google Поиске.
    VideoРезультаты видеопоиска, как правило с вкладки Videos в Google Поиске.

  2. Data state Выберите, включать ли данные, которые Google ещё не финализировал.

    Состояние данныхОписание
    AllВключает свежие (нефинализированные) данные вместе с финализированными. Свежие значения за последние дни могут измениться до финализации.
    FinalВключает только финализированные данные. Финализация обычно занимает у Google несколько дней, поэтому самые последние дни отсутствуют.

  3. Integration name Отображаемое имя пайплайна. Измените его по своему усмотрению.

  4. Table name Имя таблицы назначения. Renta предлагает имя по умолчанию вида google_search_console_{id}, при желании укажите своё.

Диапазон дат

Задайте исторический период загрузки и окно, которое перезагружается при каждом запуске.

Диапазон дат и период перезаписи Google Search Console
  1. Date start.
    Первая дата периода выгрузки. Она может быть не более чем на 90 дней в прошлом.
  2. Date end.
    Последняя дата периода выгрузки. Оставьте Today, чтобы продолжать собирать новые данные при каждом запуске.
  3. Overwrite Period.
    Окно, которое перезагружается при каждом запуске. Renta удаляет и заново вставляет данные за это окно, поэтому значения, финализированные Google после первоначальной загрузки, попадают в таблицу. Значение по умолчанию: Last 5 days.

Расписание

Выберите, как часто будет запускаться пайплайн.

Выбор типа расписания Google Search Console
Тип расписанияОписание
ManualПайплайн запускается только вручную через интерфейс или по API.
DailyПайплайн запускается раз в день в указанное время обновления.
IntervalПайплайн запускается через заданные интервалы времени.
Cron ExpressionПайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.

Выбор времени обновления и кнопка Create pipeline

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробнее в документации по расписаниям.

Стратегия синхронизации

В таблице ниже описано, как Renta синхронизирует отчёт Google Search Console.

СтратегияПоддерживаемые типы отчётовОписание
Инкрементальное обновлениеSearch AnalyticsRenta загружает данные по дням, фильтруя по дате отчёта, и партиционирует таблицы по дате. При каждом запуске окно Overwrite Period (по умолчанию последние 5 дней) удаляется и вставляется заново, поэтому значения, финализированные Google после первоначальной загрузки, заменяют свежие. Внутри каждого дня Renta запрашивает данные отдельно для десктопа, мобильных и планшетов и постранично загружает их пакетами по 10 000 строк, чтобы получить полный набор данных.

Лимиты

  1. Исторический период.
    Дата начала может быть не более чем на 90 дней в прошлом, и запуск завершится ошибкой, если дата в его окне старше 90 дней. Чтобы накопить более длинную историю, оставьте пайплайн работать по расписанию: объём накопленных в хранилище данных не ограничен.
  2. Свежесть данных.
    Google финализирует данные поисковой эффективности с задержкой в несколько дней. При Data state со значением All последние дни содержат свежие значения, которые могут измениться. Перезагрузка окна Overwrite Period заменяет их финализированными значениями при следующих запусках.
Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.