Google Ads

Выгружайте данные об эффективности рекламных кампаний из Google Ads напрямую в ваше хранилище с помощью Renta. Интеграция упрощает централизацию маркетинговых метрик, позволяя строить продвинутую аналитику и кастомные модели атрибуции без ручной работы.

Авторизация

Для обеспечения максимальной безопасности Renta применяет протокол OAuth 2.0. Это позволяет настроить безопасное подключение без передачи ваших паролей, предоставляя сервису только те права, которые необходимы для извлечения статистики.

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

Подключение коннектора Google Ads займет всего пару минут. Следуйте этому руководству, чтобы авторизовать источник и подготовить интеграцию к работе.

Перейдите в раздел Sources и добавьте источникStep 1

В левой панели откройте Connections > Sources. Нажмите + Add source в правом верхнем углу, чтобы открыть каталог. Либо перейдите напрямую в Connections > Catalog.

Выберите Google Ads в каталогеStep 2

В каталоге откройте вкладку Sources и разверните раздел Advertising. Нажмите на карточку Google Ads, чтобы добавить подключение.

Авторизуйтесь через GoogleStep 3

На странице Add a new Google Ads connection убедитесь, что активна вкладка Configure. Прочитайте уведомление о том, что Renta запрашивает ограниченный доступ и что учетные данные будут зашифрованы. Нажмите Log in to your Google Ads account, чтобы перейти к авторизации в Google.

Страница добавления подключения Google Ads с кнопкой Log in

Выберите аккаунт GoogleStep 4

На экране входа Google выберите аккаунт, у которого есть доступ к управляющему (MCC) или клиентским аккаунтам Google Ads. Если аккаунта нет в списке, используйте Use another account.

Разрешите доступ к данным Google AdsStep 5

Проверьте запрашиваемые права — Renta сможет просматривать, редактировать, создавать и удалять ваши аккаунты и данные Google Ads для отчетов. Нажмите Allow, чтобы предоставить доступ.

Renta хочет получить доступ к вашему аккаунту Google

Укажите название источника и сохранитеStep 6

Вы вернетесь в Renta с авторизованным подключением. Укажите финальные параметры:

Source name.
Введите понятное название (например, имя аккаунта или кампании). Это название будет использоваться только в интерфейсе Renta.
Завершение настройки.
Нажмите Save, чтобы завершить настройку. Коннектор готов к использованию в пайплайнах.

Настройка подключения Google Ads — название и Save

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

При создании пайплайна с источником Google Ads вам необходимо настроить следующие параметры:

Integration type

Первая настройка формы: тип интеграции. Он определяет, соберёте вы отчёт сами или возьмёте готовый.

Тип интеграции	Описание
Custom report	Вы сами выбираете рекламные аккаунты, тип отчёта и поля. Разделы ниже описывают этот путь.
Pre-built templates	Пайплайн с фиксированным типом отчёта и набором полей. Вы выбираете только рекламные аккаунты и шаблон.

Renta предлагает один шаблон: PMax Performance report. Он создаёт пайплайн с дневными кликами, показами и расходом групп объектов Performance Max, а также статусом группы и её кампанией.

Шаблон PMax Performance report

Таблица, которую создаёт шаблон, её поля, настройки по умолчанию и типы кампаний.

Ad accounts

Сюда добавляются рекламные аккаунты Google Ads для выгрузки данных. Вы можете выбрать один или несколько аккаунтов. Список доступных источников подтягивается из Google Ads API, в том числе через менеджерские аккаунты (MCC).

Report Types

Укажите тип отчета (Report Type). Этот параметр задает уровень детализации данных и доступный набор полей.

Renta поддерживает абсолютно все ресурсы (reports), доступные в официальном Google Ads API. Это открывает широчайшие возможности для аналитики, так как вам доступен весь массив сырых данных без каких-либо ограничений.

Примеры типов отчетов:

Тип отчета	Описание
Ad Group Ad	Данные на уровне объявлений в группах объявлений.
Campaign	Данные на уровне кампаний.
Ad Group	Данные на уровне групп объявлений.
Customer	Данные на уровне клиентского аккаунта.
Ad Group Criterion	Данные по ключевым словам и таргетингу.
Keyword View	Данные по ключевым словам.
Geographic View	Данные по гео.

Parameters

Выберите параметры и метрики, которые будут выгружены в целевую таблицу. Структура сформированного набора данных полностью зависит от выбранных вами параметров. В качестве параметров выступают идентификаторы из Google Ads API.

Параметр segments.date необходим для включения партиционирования (по ключу segments_date) в вашем хранилище, а также для работы инкрементальной загрузки данных.

Параметры стоимости, такие как metrics.cost_micros, отдаются API в микро-единицах. Для получения реальной суммы в валюте необходимо делить это значение на 1 000 000 на стороне вашего хранилища.

Date Range

Выберите период для выгрузки данных. Renta позволяет выгружать исторические данные за любой выбранный период без ограничений.

Overwrite period

Укажите количество дней, данные за которые будут перезаписываться при каждой инкрементальной выгрузке. Это помогает поддерживать консистентность и обновлять конверсии, которые долетают с задержкой.

Эта настройка доступна только в том случае, если в параметрах выбран segments.date.

Расписание синхронизации

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

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

В следующей таблице описаны стратегии синхронизации, используемые Renta для Google Ads:

Стратегия Описание

Incremental load Renta будет постоянно синхронизировать ваши данные инкрементально, при условии, что поле segments.date выбрано в параметрах.

Поддерживаемые отчеты: Любой отчет (если выбрано поле segments.date).

Full overwrite Renta полностью перезаписывает весь датасет при каждой синхронизации, поскольку эти отчеты представляют собой снимки конфигурации без временных свойств, или поле даты не выбрано.

Поддерживаемые отчеты: Любой отчет (когда поле segments.date не выбрано).

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.