Фильтры Meta Ads

Коннектор Meta Ads поддерживает фильтрацию данных на уровне запроса к API. Фильтры позволяют сузить выборку до нужных кампаний, групп объявлений, объявлений или значений метрик.

Типы фильтров

Фильтр по кампании (campaign_filter)

Фильтрация по названию или ID кампании.

Поддерживаемые операторы:

• EQUAL — точное совпадение
• NOT_EQUAL — не равно
• CONTAIN — содержит подстроку
• NOT_CONTAIN — не содержит подстроку

Логика: AND, OR

Сущность: campaign

Примеры:

• Название кампании содержит "Black Friday" → campaign.name CONTAIN "Black Friday"
• Исключить кампанию с ID 123456 → campaign.id NOT_EQUAL "123456"

Фильтр по группе объявлений (adset_filter)

Фильтрация по названию или ID группы объявлений.

Поддерживаемые операторы:

• EQUAL — точное совпадение
• NOT_EQUAL — не равно
• CONTAIN — содержит подстроку
• NOT_CONTAIN — не содержит подстроку

Логика: AND, OR

Сущность: adset

Фильтр по объявлению (ad_filter)

Фильтрация по названию или ID объявления.

Поддерживаемые операторы:

• EQUAL — точное совпадение
• NOT_EQUAL — не равно
• CONTAIN — содержит подстроку
• NOT_CONTAIN — не содержит подстроку

Логика: AND, OR

Сущность: ad

Фильтр по метрикам (metric_filter)

Фильтрация по числовым значениям метрик.

Поддерживаемые операторы:

• EQUAL — равно
• NOT_EQUAL — не равно
• GREATER_THAN — больше
• LESS_THAN — меньше

Логика: AND, OR

Сущность: insights

Примеры:

• Расходы больше 100 → spend GREATER_THAN 100
• CTR меньше 1% → ctr LESS_THAN 1
• Показы больше 1000 и клики больше 50 → impressions GREATER_THAN 1000 AND clicks GREATER_THAN 50

Логические операторы

Фильтры можно комбинировать с помощью логических операторов:

AND (И)

Оба условия должны выполняться одновременно.

campaign.name CONTAIN "Sale" AND spend GREATER_THAN 50

OR (ИЛИ)

Достаточно выполнения хотя бы одного условия.

campaign.name CONTAIN "Spring" OR campaign.name CONTAIN "Summer"

Приоритет операторов

При комбинировании AND и OR в одном фильтре:

• AND имеет более высокий приоритет, чем OR
• Для явного управления приоритетом используйте группировку

Применение фильтров

Фильтры применяются на уровне API-запроса к Graph API, что означает:

1. Фильтрация до агрегации: данные отфильтровываются на стороне Meta до передачи в LightLead
2. Экономия трафика: уменьшается объём передаваемых данных
3. Быстрее запросы: меньше данных = быстрее ответ

Ограничения

• Фильтры по креативным полям (thumbnail_url, body, link, video_id) не поддерживаются на уровне API
• Текстовые фильтры нечувствительны к регистру
• Максимальное количество условий в одном запросе определяется ограничениями Graph API

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

• Сущности и поля
• Метрики
• Параметры запроса
• Примеры использования