Meta представила Ads CLI — интерфейс командной строки для работы с Meta Ads and Commerce. Инструмент рассчитан на разработчиков и AI-агентов, которые работают с Meta Marketing API и хотят управлять рекламными кампаниями прямо из терминала, без написания собственного кода.
По словам Meta, Marketing API остается мощным инструментом, но при работе с ним разработчикам постоянно приходится писать один и тот же технический код: авторизацию, пагинацию, форматирование вывода и обработку ошибок. Ads CLI решает эту проблему, объединяя Meta Marketing API в один инструмент с предсказуемыми командами для управления рекламой.
Например, через командную строку можно получить список кампаний:
meta ads campaign list
Или выгрузить статистику по кампании за последние 7 дней:
meta ads insights get --campaign_id COMPAIGN_ID --date-preset last_7d —-fields conversions,impressions
Ads CLI поддерживает несколько форматов вывода, включая JSON и plain-вывод со значениями, разделенными табуляцией. Это нужно, чтобы инструмент можно было использовать не только вручную, но и в автоматизации, скриптах, внутренних тулзах и CI/CD-пайплайнах.
Что можно делать через Ads CLI
Через Ads CLI можно создавать, просматривать, обновлять и удалять кампании, группы объявлений, объявления и креативы. По умолчанию новые объекты создаются в статусе PAUSED, поэтому кампания не запустится сразу, пока ее отдельно не переведут в активный статус.
Пример создания кампании с дневным бюджетом 50,00 в валюте рекламного аккаунта:
meta ads campaign create --name "Summer Sale" --objective OUTCOME_SALES --daily-budget 5000
Создание группы объявлений:
meta ads adset create CAMPAIGN_ID --name "My Ad Set" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --bid-amount 500 --targeting-countries US
Создание креатива с изображением и кнопкой:
meta ads creative create --name "Hero Banner" --page-id 111222333 --image ./banner.jpg --body "50% off everything!" --title "Shop Now" --link-url https://example.com/sale --call-to-action SHOP_NOW
Создание объявления на основе группы объявлений и креатива:
meta ads ad create ADSET_ID --name "Hero Banner Ad" --creative-id CREATIVE_ID После проверки кампанию, группу объявлений и объявление можно перевести в активный статус:
meta ads campaign update CAMPAIGN_ID --status ACTIVE meta ads adset update ADSET_ID --status ACTIVE meta ads ad update AD_ID --status ACTIVE
Аналитика и статистика
Ads CLI также позволяет смотреть показатели по рекламе: расходы, показы, CTR, ROAS и другие метрики. В запросах можно использовать диапазоны дат, разбивки по возрасту, полу, платформе и разные уровни агрегации.
Пример выгрузки статистики по кампании за последние 7 дней:
meta ads insights get --campaign_id COMPAIGN_ID --fields=impressions,conversions --date-preset last_7d
Это полезно для команд, которые хотят собирать отчеты автоматически, без ручной выгрузки из Ads Manager.
Каталоги и товары
Через Ads CLI можно работать не только с рекламными кампаниями, но и с каталогами. Инструмент поддерживает создание и управление каталогами, товарами и товарными наборами.
Создание каталога:
meta ads catalog create --name "My Catalog"
Добавление товара в каталог:
meta ads product-item create --catalog-id 123456 --retailer-id sku_a --name "Blue Shirt" --url https://example.com/blue_shirt --price "999" --currency "USD" --image-url https://example.com/blue_shirt.jpg
Просмотр товарных наборов:
meta ads product-set list --catalog-id 123456
Пиксели и датасеты
Отдельный блок касается datasets. Через Ads CLI можно создавать пиксели для отслеживания конверсий, подключать их к рекламным аккаунтам и каталогам товаров, а также настраивать связку для отслеживания конверсий.
Создание датасета:
meta ads dataset create --name "Website Pixel"
Подключение датасета к рекламному аккаунту и каталогу:
meta ads dataset connect 111222 --ad-account-id 333444 --catalog-id 555666
Автоматизация и AI-агенты
Meta отдельно пишет, что meta ads рассчитан на автономный запуск в CI/CD-пайплайнах, интерактивную работу в терминале и использование в скриптах.
Для этого предусмотрены три формата вывода:
- table — человекочитаемый вывод;
- json — формат для обработки через jq и другие инструменты;
- plain — простые значения, разделенные табуляцией, которые удобно передавать в sort, awk, cut и другие команды.
Также есть параметры —no-input и —force, которые отключают все интерактивные запросы.
Для обработки ошибок используются стандартные коды завершения: например, 0 для успешного выполнения, 3 для ошибки авторизации и 4 для ошибки API. Также поддерживаются переменные среды для токенов, секретов и ID рекламных аккаунтов, чтобы не хранить чувствительные данные в истории команд и системе контроля версий.
По сути, Ads CLI дает официальный способ работать с Meta Marketing API через команды: создавать кампании, группы объявлений, объявления и креативы, работать с каталогами, собирать статистику и автоматизировать рутину без ручной возни в интерфейсе.
- Для работы Ads CLI нужен Python 3.12+ и pip/uv.
