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

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

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

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

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

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

Integration type
Выберите способ настройки выгрузки данных.
| Тип | Описание |
|---|---|
| Custom report | Вы сами выбираете параметры и метрики для выгрузки. Подходит, когда нужна своя структура отчёта, давая полный контроль над выбором данных. |
| Pre-built templates | Используются готовые шаблоны хранилищ (Data Mart models), где набор полей уже задан. Удобно для типовых сценариев с минимальными настройками. |
Ad accounts
Список доступных рекламных аккаунтов Facebook, подключённых через источник. Выбирается аккаунт (или несколько), из которого будут браться данные.
Report types
Тип выгружаемого отчёта:
| Тип отчета | Описание |
|---|---|
| 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
Поля (метрики и измерения), которые попадут в целевую таблицу (например, Date, Clicks, Impressions, Spend, Campaign ID).
Выбор параметра Date включает партиционирование и инкрементальную выгрузку в вашем назначении.
Date Range
Выберите период выгрузки данных – вы можете указать любой необходимый исторический промежуток времени.
Overwrite period
Выберите период времени, который будет перезаписываться. Каждый день данные за этот период будут удаляться и загружаться заново, что гарантирует целостность данных и учет долетевших конверсий.
Эта настройка становится доступной только в том случае, если в параметрах выбрано поле Date.
Расписание синхронизации
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' не выбрано). |
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.