Meta Ads CLI 온보딩 가이드

운영 기준

본 가이드는 멋쟁이사자처럼 비즈니스 포트폴리오에 연결된 광고 자산을 기준으로 CLI 운영 범위를 정리합니다.

자산 구조

비즈니스 포트폴리오가 광고계정, 페이지, Instagram 계정, 픽셀, 시스템 사용자의 권한과 연결 관계를 관리합니다.

광고 실행 구조

광고계정 안에서 Campaign, Ad Set, Ad가 계층을 이루고, Ad는 Creative를 참조해 실제 소재를 송출합니다.

객체 관계 모델

Meta 광고 객체는 포함 관계와 참조 관계로 구분됩니다. 캠페인, 광고세트, 광고는 광고계정 하위의 포함 관계이며, 크리에이티브·페이지·Instagram Actor·픽셀은 ID로 연결되는 참조 자산입니다.

비즈니스 포트폴리오: 멋쟁이사자처럼 ├─ 앱(App) │ └─ API 호출 주체 및 토큰 발급 컨텍스트 ├─ 시스템 사용자: test_test │ └─ 액세스 토큰 │ └─ 앱 컨텍스트에서 발급되며, 자산별 권한 범위 안에서 CLI 인증에 사용 ├─ 광고계정: act_315038936029650 (멋쟁이사자처럼) │ ├─ 캠페인: b2caiers02_meta_conversion_2606_new │ │ └─ 광고세트: new_2644_pcmo │ │ └─ 광고: ad09_v_object_c2_curriculm │ │ └──[참조]──▶ 크리에이티브: 979682101368969 │ └─ 크리에이티브 │ └─ 광고계정 단위의 소재 자산. 광고가 creative_id로 참조 ├─ Facebook 페이지: 540051412686326 (멋쟁이사자처럼) │ └──[참조됨]── 크리에이티브가 page_id로 사용 ├─ Instagram Actor: 17841416651234646 │ └──[참조됨]── 크리에이티브가 instagram_actor_id로 사용 └─ 데이터셋/픽셀 └──[참조됨]── 광고세트가 전환 최적화와 성과 측정에 사용

관계	설명	예시
포함 관계	상위 객체 안에 하위 객체가 생성됩니다.	`광고계정 -> 캠페인 -> 광고세트 -> 광고`
참조 관계	독립적으로 존재하는 자산을 ID로 연결해 사용합니다.	`광고 -> 크리에이티브`, `크리에이티브 -> 페이지`, `광고세트 -> 픽셀`
권한 주체	System User는 광고 객체의 부모가 아니라 API 호출 권한을 가진 사용자입니다.	`test_test`의 토큰으로 CLI 호출

핵심 용어 정의

아래 표는 현재 멋쟁이사자처럼 aiers 캠페인에서 확인한 값을 예시로 사용합니다.

용어	정의	현재 예시
비즈니스 포트폴리오	앱, 광고계정, 페이지, 데이터셋, 시스템 사용자 등 비즈니스 자산을 관리하는 최상위 단위입니다.	멋쟁이사자처럼
시스템 사용자	사람이 아닌 API 전용 사용자입니다. 자산별 권한을 부여받고 액세스 토큰으로 CLI를 인증합니다.	test_test
광고계정	캠페인이 생성되고 광고비, 통화, 시간대, 결제, 성과가 귀속되는 단위입니다.	`act_315038936029650`
캠페인	광고 목표와 예산 전략을 정의하는 상위 광고 단위입니다.	`b2caiers02_meta_conversion_2606_new`
광고세트	타겟, 일정, 게재 위치, 최적화 기준, 전환 이벤트를 정의합니다.	`new_2644_pcmo`
광고	광고세트 하위에서 실제 송출되는 단위입니다. 하나의 크리에이티브를 참조합니다.	`ad09_v_object_c2_curriculm`
크리에이티브	광고의 표시 내용입니다. 이미지, 영상, 문구, 링크, CTA, 게시 주체 정보가 포함됩니다.	`979682101368969`
페이지	광고가 Facebook에서 어떤 브랜드/게시자 이름으로 표시될지 결정하는 자산입니다.	`540051412686326`
Instagram Actor	Instagram 지면에서 광고가 어떤 계정으로 표시될지 결정하는 자산입니다.	`17841416651234646`
데이터셋/픽셀	웹사이트 전환 이벤트를 수집하고 광고세트의 전환 최적화와 성과 측정에 사용됩니다.	`dataset list`로 확인

1. adaccount list 2. page list / dataset list 3. campaign create 4. adset create 5. creative create 6. ad create 7. get으로 검수 8. update --status ACTIVE 9. insights get

Ad Set, Ad, Creative 차이

광고세트는 송출 조건, 광고는 실제 송출 단위, 크리에이티브는 광고에 연결되는 소재와 문구입니다.

Campaign └─ Ad Set = 누구에게, 어디에, 언제 보여줄지 └─ Ad = 실제로 송출되는 개별 광고 └─ Creative = 광고에 붙는 소재, 문구, 링크

객체	역할	현재 aiers 예시
Ad Set	타겟, 게재 위치, 일정, 예산, 최적화 기준, Pixel/Dataset을 정의합니다.	`new_2644_pcmo`
Ad	광고세트 안에서 실제로 송출되는 개별 광고입니다. 같은 광고세트 안에 여러 광고를 두어 소재별 성과를 비교합니다.	`ad09_v_object_c2_curriculm`
Creative	이미지/영상, 본문, 제목, 랜딩 URL, CTA, Page ID, Instagram Actor ID를 포함하는 표시 내용입니다.	`979682101368969`

Ad Set └─ new_2644_pcmo └─ Ad └─ ad09_v_object_c2_curriculm └─ Creative ├─ Creative ID: 979682101368969 ├─ 영상 2개 ├─ 본문 문구 ├─ 랜딩 URL ├─ CTA: APPLY_NOW ├─ Page: 540051412686326 (멋쟁이사자처럼) └─ Instagram Actor: 17841416651234646

신규 소재 운영 기준

새 소재가 생겼다고 해서 캠페인을 매번 새로 만들지는 않습니다. 변경하는 값이 소재인지, 송출 조건인지, 광고 목표인지에 따라 생성 단위를 분리합니다.

변경 대상	운영 단위	판단 기준
이미지, 영상, 카피, 썸네일, CTA, 랜딩 URL	새 Creative + 새 Ad	타겟과 최적화 조건을 유지한 채 소재 성과만 비교합니다.
연령, 지역, 관심사, 커스텀 오디언스, 배치, 일정, 최적화 이벤트, Pixel/Dataset	새 Ad Set	누구에게, 어디에, 언제, 어떤 이벤트 기준으로 최적화할지가 바뀌는 경우입니다.
캠페인 목표, 큰 예산 전략, 퍼널 목적	새 Campaign	광고 목적과 예산 전략이 바뀌면 기존 구조와 섞지 않습니다.

AIERS 운영 이관 초기에는 원본 캠페인을 직접 수정하지 않고, 원본 세팅을 먼저 백업한 뒤 복제 캠페인/광고세트에서 테스트를 시작합니다. `/Users/jeonghyeonkim/Desktop/aiers-pb`의 상세페이지별 신규 소재는 같은 비교 조건을 가진 광고세트 안에 새 광고로 추가해 성과를 비교합니다.

운영 판단 ├─ 소재만 바뀜 │ └─ Creative 생성 -> Ad 생성 ├─ 타겟/배치/최적화 조건이 바뀜 │ └─ Ad Set 분리 └─ 목표/예산 전략이 바뀜 └─ Campaign 분리

전체 위계

Business Portfolio └─ Ad Account ├─ Page / Instagram Actor ├─ Dataset / Pixel ├─ Campaign │ └─ Ad Set │ └─ Ad │ └─ creative_id -> Creative └─ Catalog / Product Feed / Product Item / Product Set

레이어	역할	CLI 사용
Business Portfolio	회사 단위 컨테이너	권한과 자산 확인
Ad Account	예산, 결제, 리포팅 경계	`adaccount list`
Page / IG Actor	광고 노출 정체성	`page list`, `creative create`
Dataset / Pixel	전환 이벤트와 최적화	`dataset list`, `adset create --pixel-id`
Campaign	목적과 큰 예산 전략	`campaign create/get/update`
Ad Set	타게팅, 지면, 일정, 최적화	`adset create/get/update`
Creative	소재, 문구, 링크, CTA	`creative create/get`
Ad	광고세트와 소재의 실행 단위	`ad create/get/update`

현재 aiers 기준값

항목	값
광고계정	`act_315038936029650` 멋쟁이사자처럼
캠페인	`b2caiers02_meta_conversion_2606_new`
캠페인 ID	`120248668493410421`
광고세트	`new_2644_pcmo`
광고세트 ID	`120248668493500421`
Page ID	`540051412686326` 멋쟁이사자처럼
Instagram Actor ID	`17841416651234646`
목적 / 최적화 / 과금	`OUTCOME_LEADS` / `OFFSITE_CONVERSIONS` / `IMPRESSIONS`

다른 광고계정에 복제할 때는 캠페인 ID, 광고세트 ID, 광고 ID, 크리에이티브 ID를 재사용하지 않습니다. 대상 계정에서 새로 생성된 ID를 써야 합니다.

결론

aiers 광고에 지정된 세팅값을 CLI에서 상당 부분 재현할 수 있습니다. 단, 동일 복제의 핵심은 CLI 자체보다 대상 광고계정이 같은 페이지, 인스타그램 Actor, 픽셀, 커스텀 오디언스, 소재에 접근할 수 있느냐입니다.

반복 생성, 조회, 성과 확인, 상태 변경은 CLI 중심으로 운영하고, 최초 권한 연결과 보안/결제/정책 이슈는 관리자 화면에서 처리하는 방식이 가장 현실적입니다.

공식 문서 기준

Ads CLI Overview · Get Started · Command Reference · Ad Creatives · Learning phase and significant edits · A/B testing · Duplicate campaigns, ad sets and ads