원문 보기
Introducing Ads CLI: A Command-Line Interface for Meta Ads and Commerce
Blog

Introducing Ads CLI: A Command-Line Interface for Meta Ads and Commerce

2026.05.25
·Web·by Homin.Lee
#Automation#CLI#Developer Tools#Marketing API#Meta Ads

핵심 포인트

  • 1Meta는 개발자와 AI 에이전트가 Meta ad campaign을 직접 관리할 수 있는 command-line tool인 Meta Ads CLI를 도입하여, Meta Marketing API 사용 시 발생하는 반복적인 작업을 간소화합니다.
  • 2이 CLI는 campaign, ad set, ad, creative 생성 및 관리부터 Performance Insights 쿼리, product catalog 및 Dataset 관리까지 포괄적인 ad management 기능을 제공합니다.
  • 3automation을 위해 설계된 Ads CLI는 다양한 output format을 지원하며 CI/CD pipeline에 원활하게 통합되어, interactive 사용 및 automated workflow 모두에서 ad management의 효율성을 높입니다.

Meta Ads CLI는 2026년 4월 29일 John Holstein, Matt Mayberry, Andrew Kutsy, Sanjay Patel이 소개한 Meta Marketing API를 위한 명령줄 인터페이스(command-line interface, CLI) 도구입니다. 이 도구는 개발자와 AI 에이전트가 Meta 광고 캠페인을 관리할 때 코드를 직접 작성하지 않고도 캠페인을 생성, 편집, 분석할 수 있도록 지원합니다.

Meta Ads CLI가 개발된 핵심 동기는 기존 Meta Marketing API의 사용성 문제를 해결하기 위함입니다. Meta Marketing API는 강력하지만, 개발자들은 인증(authentication), 페이지네이션(pagination), 출력 포맷팅(output formatting), 오류 처리(error handling)와 같은 반복적인 작업을 수없이 코딩해야 했습니다. 이러한 반복 작업은 개발 속도를 저하시키고 광고 관리 기능을 자동화된 워크플로우에 통합하는 것을 어렵게 만들었습니다. Ads CLI는 Meta Marketing API의 기능을 예측 가능한 명령어 형태로 패키징하여, 이러한 반복적인 작업을 추상화하고 개발자와 AI 에이전트가 안정적으로 API를 사용할 수 있도록 설계되었습니다.

Meta Ads CLI가 제공하는 주요 기능과 방법론은 다음과 같습니다.

  1. 광고 생성 및 관리(Ad Creation and Management):
    • 캠페인(campaign), 광고 세트(ad set), 광고(ad), 크리에이티브(creative)를 터미널 내에서 직접 생성, 목록화(list), 업데이트(update), 삭제(delete)할 수 있습니다.
    • 모든 리소스는 기본적으로 PAUSED 상태로 생성되어, 사용자가 명시적으로 활성화하기 전까지는 라이브되지 않습니다.
    • 예시 명령어:
      • 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
      • 생성된 캠페인, 광고 세트, 광고의 상태(status)를 ACTIVE로 업데이트하여 광고를 라이브할 수 있습니다.
  1. 성과 분석(Performance Insights):
    • 다양한 지표(spend, impressions, CTR, ROAS 등)를 유연한 날짜 범위(date ranges), 연령/성별/플랫폼별 분류(breakdowns), 그리고 여러 집계 레벨(aggregation levels)로 쿼리할 수 있습니다.
    • 예시 명령어: metaadsinsightsget−−campaignidCOMPAIGNID−−fields=impressions,conversions−−date−presetlast7dmeta ads insights get --campaign_id COMPAIGN_ID --fields=impressions,conversions --date-preset last_7d
  1. 카탈로그 관리(Catalog Creation and Management):
    • 제품 카탈로그(catalogs), 제품(products), 제품 세트(product sets)를 생성하고 관리할 수 있습니다.
    • 예시 명령어: meta ads catalog create --name "My Catalog", meta ads product-item create --catalog-id 123456 --retailer-id sku_a --name "Blue Shirt" ...
  1. 데이터셋 관리(Datasets):
    • 전환 픽셀(conversion pixels)을 생성하고, 이를 광고 계정(ad accounts) 및 제품 카탈로그(product catalogs)에 연결하여 종단 간 전환 추적(end-to-end conversion tracking)을 설정할 수 있습니다.
    • 예시 명령어: meta ads dataset create --name "Website Pixel", meta ads dataset connect 111222 --ad-account-id 333444 --catalog-id 555666

Meta Ads CLI는 자동화(Automation)에 최적화되어 설계되었습니다.

  • 다양한 출력 포맷: human-readable한 테이블(table), 프로그래밍 방식 처리를 위한 JSON, 정렬/분석 도구와 연동하기 쉬운 탭으로 구분된(tab-separated) plain 텍스트 등 세 가지 출력 포맷을 지원합니다.
  • 비대화형 모드: --no-input 및 --force 옵션을 통해 모든 대화형 프롬프트(interactive prompts)를 억제하여 CI/CD 파이프라인(CI/CD pipelines)과 같은 무인 환경(unattended)에서 실행 가능합니다.
  • 표준 종료 코드(Standard Exit Codes): 성공(0), 인증 오류(3), API 오류(4) 등 명확한 종료 코드를 사용하여 오류 처리가 용이합니다.
  • 환경 변수(Environment Variables): 토큰, 비밀 값, 계정 ID(account IDs)와 같은 민감한 정보를 명령 기록이나 버전 관리 시스템에 노출하지 않도록 환경 변수를 통한 설정 방식을 제공합니다.

Meta Ads CLI는 Python 3.12 이상과 pip 또는 uv 패키지 관리 도구를 필요로 합니다.