Meta представила Ads CLI для управления рекламой через командную строку

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.