Facebook Ads

Renta позволяет синхронизировать данные из вашего аккаунта Facebook Ads напрямую в хранилище данных, автоматизируя процесс переноса маркетинговых данных в ваш аналитический стек.

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

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

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

Выполните следующие шаги, чтобы добавить Facebook Ads в качестве источника в Renta с помощью аутентификации OAuth.

Перейдите в каталогStep 1

Перейдите в раздел Connections > Catalog в левом боковом меню.

Выберите Facebook AdsStep 2

Найдите и выберите Facebook Ads в категории Advertising.

Авторизуйте подключениеStep 3

Нажмите кнопку Log in to your Facebook Ads account. Вы будете перенаправлены на Facebook для входа через OAuth.

Предоставьте доступStep 4

Ознакомьтесь с запрашиваемыми разрешениями для предоставления Renta доступа к вашему аккаунту и нажмите Reconnect (или Continue).

Настройте подключениеStep 5

Заполните данные подключения:

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

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

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

Integration type

Выберите способ настройки выгрузки данных.

Тип	Описание
Custom report	Вы сами выбираете параметры и метрики для выгрузки. Подходит, когда нужна своя структура отчёта, давая полный контроль над выбором данных.
Pre-built templates	Используются готовые шаблоны хранилищ (Data Mart models), где набор полей уже задан. Удобно для типовых сценариев с минимальными настройками.

Шаблон Performance report

Описание схемы данных и состава полей для шаблона Facebook Ads Performance report.

Ad accounts

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

Report types

Ниже в таблице приведены доступные типы отчетов для синхронизации данных из Facebook Ads в ваше хранилище.

Тип отчета	Описание
Statistics report	Статистика рекламного аккаунта по всем уровням (кампания, группа, объявление). Включает метрики (показы, клики, spend, reach и т.п.), breakdowns и кастомные конверсии.
Campaign metadata	Метаданные кампаний (статус, бюджеты, цели, даты создания). Это снимок состояния, без метрик производительности.
Ad group metadata	Метаданные групп объявлений (бюджеты, таргетинг, оптимизации, статусы и т.п.). Это снимок состояния.
Ad metadata	Метаданные объявлений (статусы, ID кампании/группы, креатив, ссылки и т.п.). Это снимок состояния.
Ad account metadata	Метаданные аккаунта (валюта, баланс, бизнес-информация, таймзона). Снимок настроек аккаунта, без статистики.

Ad action report time

(Только для Statistics report). Определяет, когда считать конверсии и другие действия в отчетах.

Значение	Описание
Mixed	Используется модель Facebook, сочетающая impression и click.
Impression	Конверсия учитывается по показу объявления.
Conversion	Конверсия учитывается по моменту совершения действия.
Lifetime	Учитываются все действия за всё время.

Attribution settings

(Только для Statistics report). Определяет, какие настройки атрибуции использовать.

Настройка	Описание
Use account attribution setting	Используются настройки атрибуции, заданные в вашем рекламном аккаунте Facebook.
Use unified attribution setting	Используется единая модель атрибуции Facebook.

Параметры (Parameters)

В этом разделе вы можете указать метрики и измерения, которые Renta будет синхронизировать с вашим хранилищем данных.

Добавьте такие поля, как Date, Clicks, Impressions, Spend и различные ID для построения аналитических отчетов.

Выбор параметра Date (Дата) активирует партиционирование и инкрементальную загрузку в вашем хранилище. Renta поддерживает выгрузку всех метрик, измерений и разбиений (breakdowns), доступных в Facebook Marketing API.

Динамические параметры в ссылках

Renta автоматически извлекает UTM-метки из шаблонов или прямых URL объявлений. При парсинге поддерживаются следующие динамические параметры:

Плейсхолдер URL	Поле данных	Описание
ad.id	ad_id	Уникальный идентификатор объявления
ad.name	ad_name	Название объявления
adset.id	adset_id	Уникальный идентификатор группы объявлений
adset.name	adset_name	Название группы объявлений
campaign.id	campaign_name	ID кампании (в данный момент мапится в campaign_name)
campaign.name	campaign_name	Название рекламной кампании

Эти плейсхолдеры подставляются в стандартные UTM-параметры: utm_medium, utm_source, utm_campaign, utm_content и utm_term.

Пример использования в URL объявления:

https://example.com/landing?utm_source=facebook&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

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

Date Range

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

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

Overwrite period

Настройка окна перезаписи позволяет автоматически обновлять данные за прошедшие дни для учета корректировок.

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

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

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

Для автоматизации процесса обновления данных Renta предоставляет гибкие настройки расписания.

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

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

В зависимости от типа отчета платформа применяет оптимальный метод обновления данных в вашем хранилище.

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

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

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

Поддерживаемые отчеты: Statistics report если выбрано поле Date.

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

Поддерживаемые отчеты: Campaign metadata, Ad group metadata, Ad metadata, Ad account metadata, а также Statistics report когда поле Date не выбрано.

Стратегия	Описание
Incremental load	Renta будет постоянно синхронизировать ваши данные инкрементально, при условии, что поле `Date` выбрано в параметрах. Поддерживаемые отчеты: Statistics report если выбрано поле `Date`.
Full overwrite	Renta полностью перезаписывает весь датасет при каждой синхронизации, поскольку эти отчеты представляют собой снимки конфигурации без временных свойств, или поле даты не выбрано. Поддерживаемые отчеты: Campaign metadata, Ad group metadata, Ad metadata, Ad account metadata, а также Statistics report когда поле `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.