Сущности и поля Meta Ads

Коннектор Meta Ads работает со следующими сущностями, каждая из которых содержит набор полей — как стандартных атрибутов, так и вычисляемых метрик.

Обзор сущностей

Рекламный аккаунт (account)

Рекламный аккаунт Meta Ads. Корневая сущность для всех остальных данных.

Основные поля: id, name, account_id, currency, timezone_name, account_status

Связи: содержит кампании, связан с Facebook-страницами и Instagram-аккаунтами.

Кампания (campaign)

Рекламная кампания с настройками бюджета и целью.

Основные поля:

• id — уникальный идентификатор кампании
• name — название кампании
• objective — цель (CONVERSIONS, REACH, LINK_CLICKS, etc.)
• daily_budget — дневной бюджет (в центах, конвертируется делением на 100)
• lifetime_budget — общий бюджет (в центах)
• status — статус (ACTIVE, PAUSED, DELETED, ARCHIVED)

Фильтрация: по campaign.name и campaign.id

Группа объявлений (adset)

Ad Set внутри кампании с собственными настройками бюджета и таргетинга.

Основные поля:

• id — уникальный идентификатор
• name — название группы
• campaign_id — ID родительской кампании
• daily_budget — дневной бюджет (в центах)
• lifetime_budget — общий бюджет (в центах)
• status — статус группы

Фильтрация: по adset.name и adset.id

Объявление (ad)

Отдельное объявление с креативами.

Основные поля:

• id — уникальный идентификатор
• name — название объявления
• adset_id — ID родительской группы
• creative — ID креатива
• status — статус объявления

Креативные поля (обогащение):

• thumbnail_url — URL миниатюры
• image_url — URL полноразмерного изображения
• video_id — идентификатор видео
• body — текст объявления
• link_url — целевая ссылка
• object_url — URL объекта
• title — заголовок объявления
• media_type — тип медиа: video или image

Фильтрация: по ad.name и ad.id

Статистика (insights)

Метрики эффективности, получаемые через Graph API /insights endpoint.

Основные поля:

• date_start, date_stop — период статистики
• Все метрики объединяются в одном запросе через запятую

Период по умолчанию: last_30d (доступны: today, yesterday, last_7d, last_30d)

Facebook-страница (page)

Facebook-страница, связанная с пользователем.

Основные поля: id, name, category, access_token

Связь: может быть связана с Instagram Business Account.

Instagram-аккаунт (instagram_account)

Instagram-аккаунт, связанный с Facebook-страницей.

Основные поля:

• account_id — ID Instagram-аккаунта
• name — отображаемое имя
• username — имя пользователя Instagram
• page_id — ID связанной Facebook-страницы
• page_name — название связанной страницы
• page_access_token — токен доступа страницы

Поля данных

Ключ	Название	Тип	Сущность	Фильтрация	Сортировка
campaign_name	Название кампании	string	campaign	Да	Да
campaign_id	ID кампании	string	campaign	Да	Нет
adset_name	Название группы	string	adset	Да	Да
adset_id	ID группы	string	adset	Да	Нет
ad_name	Название объявления	string	ad	Да	Да
ad_id	ID объявления	string	ad	Да	Нет
account_id	ID аккаунта	string	account	Да	Нет
account_name	Название аккаунта	string	account	Да	Да
date	Дата	date	insights	Да	Да
objective	Цель	string	campaign	Да	Нет
campaign_budget	Бюджет кампании	currency	campaign	Да	Да
adset_budget	Бюджет группы	currency	adset	Да	Да
thumbnail_url	Миниатюра	url	ad	Нет	Нет
body	Текст объявления	string	ad	Нет	Нет
link	Ссылка	url	ad	Нет	Нет
download_url	URL креатива	url	ad	Нет	Нет
video_id	ID видео	string	ad	Нет	Нет
media_type	Тип медиа	string	ad	Да	Нет
spend	Расходы	currency	insights	Да	Да
impressions	Показы	number	insights	Да	Да
clicks	Клики	number	insights	Да	Да
ctr	CTR	percent	insights	Да	Да
cpc	CPC	currency	insights	Да	Да
cpm	CPM	currency	insights	Да	Да
reach	Охват	number	insights	Да	Да
frequency	Частота	number	insights	Да	Да

Особенности работы с полями

Бюджетные поля

Поля daily_budget и lifetime_budget поступают из API Meta в центах. LightLead автоматически конвертирует их в реальную валюту делением на 100:

campaign_budget = daily_budget / 100

Креативные поля

Креативные поля (thumbnail_url, body, link, download_url, video_id) обогащаются отдельным запросом к API. При ошибках обогащения основные данные сохраняются, а креативные поля могут отсутствовать — см. Ограничения.

Поля даты

Поле date в статистике использует формат YYYY-MM-DD. Период определяется через date_start и date_stop. По умолчанию используется диапазон last_30d.

Связанные страницы

• Метрики
• Параметры запроса
• Фильтры
• Дата и время