Google Analytics 4
Renta позволяет выгружать данные Google Analytics 4 в хранилище данных: отчёты, собранные из измерений и метрик вашего ресурса GA4, включая кастомные измерения и метрики ресурса.
Аутентификация
Renta использует OAuth для аутентификации в Google. Вы будете перенаправлены в Google, чтобы предоставить Renta ограниченный доступ к аккаунту Google Analytics.
Учётные данные шифруются при передаче и хранении и не сохраняются в прикладной базе данных Renta. Вы контролируете доступ и можете отозвать его в любой момент в настройках аккаунта Google.
Подключение источника Google Analytics 4
Выполните эти шаги, чтобы добавить Google Analytics 4 как источник в Renta через OAuth-аутентификацию.
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Analytics и нажмите на карточку Google Analytics 4.

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

Google покажет экран выбора аккаунта. Выберите аккаунт, у которого есть доступ к вашим ресурсам Google Analytics 4, и разрешите запрошенный доступ. После этого вы вернётесь в Renta.

Завершите настройку:
- Source name.
Укажите название источника данных. Оно используется только в интерфейсе Renta. - Access granted.
Убедитесь, что аккаунт подключён успешно.
Нажмите Save, чтобы завершить.
Если авторизация в Google позже изменится (например, после смены пароля), нажмите Re-authorize на этом источнике. Подключение обновится на месте, и все пайплайны на его основе продолжат работать.

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

Создание пайплайна
После подключения источника создайте пайплайн, чтобы синхронизировать данные Google Analytics 4 с назначением.
Создание пайплайна Google Analytics 4
Свяжите источник Google Analytics 4 с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Google Analytics 4 в списке Already connected и нажмите Next step.

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

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

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

Настройка пайплайна
На финальном шаге выберите, какие данные Google Analytics 4 выгружать и как Renta будет их загружать.
Настройка отчёта
У кажите аккаунт Google Analytics и ресурс, из которого нужны данные.

- Accounts.
Выберите аккаунт Google Analytics, доступный подключённому пользователю Google. - Properties.
Выберите ресурс GA4, из которого выгружать данные. Каждый пайплайн выгружает данные одного ресурса.
Измерения и метрики
Выберите параметры GA4, которые попадут в таблицу назначения. Схема вашего датасета определяется выбранными здесь параметрами.

На вкладке Dimensions отметьте измерения, по которым группируется отчёт: дата, страна, категория устройства, источник трафика и другие. Ищите параметр по названию через поле поиска или нажмите Select All.

На вкладке Metrics отметьте метрики для выгрузки: сессии, пользователи, события, доход и другие. Вкладка Selected показывает всё выбранное, а список Selected Dimensions & Metrics под селектором позволяет убрать параметр.
Renta загружает список параметров напрямую из метаданных ресурса, поэтому кастомные измерения и метрики (поля customEvent и customUser) отображаются рядом со стандартными. В таблице назначения имена колонок повторяют API-имена параметров, а двоеточия в именах кастомных полей заменяются на подчёркивания.
Включите в отчёт измерение Date. С ним каждая строка таблицы назначения соответствует одному дню, таблица партиционируется по колонке date, и Renta загружает данные инкрементально. Без него Renta перезагружает весь диапазон дат при каждом запуске.
В один отчёт можно включить до 9 измерений и 10 метрик. Это ограничение Google Analytics Data API. При создании пайплайна Renta проверяет выбранную комбинацию через GA4 API: если параметры несовместимы или превышают лимиты, вы получите ошибку валидации.
Имя таблицы и диапазон дат
Назовите пайплайн и задайте исторический период загрузки.

- Integration name.
Название пайплайна. Оно используется только в интерфейсе Renta. - Table name.
Имя таблицы в назначении. Можно оставить автоматически сгенерированное имя или задать своё. - Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Оставьте значение Today, чтобы собирать новые данные при каждом запуске.
Период перезаписи
Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске.

При каждом запуске Renta заново запрашивает отчёт начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и записываются заново, более старые данные не затрагиваются. Варианты: от Without overwrite data до Overwrite all data, по умолчанию Last 1 day.
Google Analytics обрабатывает событ ия с задержкой от 24 до 48 часов, поэтому данные за последние дни продолжают меняться после первой загрузки. Установите период перезаписи не меньше Last 3 days, чтобы подхватывать поздно обработанные события.
Расписание
Выберите, как часто запускается пайплайн.

| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily задайте Update time (точное время запуска), затем нажмите Create pipeline.

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробнее в документации по расписаниям.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

Стратегия синхронизации
Стратегия синхронизации зависит от того, включено ли в отчёт измерение Date.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Отчёты с измерением Date | Каждая строка соответствует одному дню, таблица назначения партиционируется по колонке date. При каждом запуске Renta перезагружает окно от даты последнего успешного за пуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и записываются заново, более старые партиции не затрагиваются. |
| Полная перезагрузка | Отчёты без измерения Date | В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает весь настроенный диапазон дат и заменяет датасет при каждом запуске. |
Изменение выбранных измерений или метрик обновляет схему таблицы, поэтому следующий запуск после изменения перезагружает весь диапазон дат.
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.