광고(Meta)

Meta(페이스북·인스타그램) 광고 계정을 연결하면 캠페인 상태, 광고비, 노출, 클릭을 allob 이 보통 3시간마다 읽어 와요. 지표 탭에는 광고비, CAC, ROAS 카드가 생기고, 제품의 광고 탭에서 실험과 승인을 기다리는 요청을 봐요.

돈이 나가는 일은 사람이 정해요. 에이전트는 광고를 꺼진 채로만 만들 수 있어요. 켜기, 끄기, 예산 바꾸기는 요청이 되고, 사람이 allob 화면에서 승인해야 Meta 에 반영돼요.

#연결하기

Facebook으로 한 번 연결하면 기한 없이 계속 읽어 와요.

1. 연결 화면에서 Meta Ads 의 Facebook으로 연결을 눌러요.
2. 광고 계정이 있는 비즈니스 포트폴리오의 관리자 계정으로 페이스북에 로그인해요.
3. 비즈니스 포트폴리오를 고르고, allob 이 볼 광고 계정·페이지·픽셀을 골라 허락해요.
4. 제품의 연결 탭에서 광고 계정 고르기를 눌러 이 제품의 광고 계정을 골라요. 고르면 바로 한 번 읽어 와요.

Facebook 연결은 비즈니스 포트폴리오에 allob 전용 시스템 사용자를 만들어 이어요. 사람 계정에 묶이지 않아서 기한이 없고, 3번에서 고른 것만 볼 수 있어요. 연결을 끊으려면 Meta 비즈니스 설정 › 연결된 앱에서 allob 을 빼요.

처음 연결할 때는 광고를 읽는 권한만 받아요. 광고를 만들거나 켜려면 광고 탭의 광고 관리 권한 연결로 한 번 더 허락해요.

allob 에 Meta 광고 계정을 연결해 줘. allob connection connect meta --open 으로 Facebook 연결 화면을 열어 주고, 내가 허락하면
allob connection link <연결 id> --product <제품> --resource act:<광고 계정 id> 로 이 제품의 광고 계정을 이은 뒤 allob ads view 로 광고비가 읽히는지 확인해 줘.

#토큰으로 연결하기

Facebook 연결 대신 Meta 비즈니스 설정에서 만든 시스템 사용자 토큰을 붙여 넣어도 돼요. 토큰 연결은 광고비와 성과를 읽기만 하고, 광고를 바꾸거나 켜기 전 확인은 할 수 없어요. 토큰을 만들 때 만료를 없음(Never)으로 고르면 한 번 연결로 계속 읽어 와요. 60일로 고르면 그때마다 새 토큰을 붙여 넣어야 해요.

1. Meta 비즈니스 설정 › 시스템 사용자에서 시스템 사용자를 골라요(없으면 추가해요).
2. 자산 할당으로 광고 계정을 주고, ads_read 권한으로 토큰을 만들어요. 만료는 없음(Never)을 골라요.
3. 연결 화면에서 Meta Ads 의 토큰으로 연결을 누르고 토큰을 붙여 넣어요. 토큰은 allob 에 암호화해서 보관해요.
4. 제품의 연결 탭에서 광고 계정 고르기를 눌러 이 제품의 광고 계정을 골라요.

토큰의 앱이 "앱 비밀 증명 필요"를 켜 두었으면 읽을 수 없어요. 그 설정을 끄거나, 그 설정이 꺼진 앱의 토큰을 써 주세요.

allob 에 Meta 광고 계정을 시스템 사용자 토큰으로 연결해 줘. 내가 비즈니스 설정에서 토큰 복사 단추를 누르면
allob connection add meta-ads-key --fields '{"accessToken":"@clipboard"}' --product <제품> --resource act:<광고 계정 id> 로 넣고, allob ads view 로 광고비가 읽히는지 확인해 줘.

#광고 계정 하나를 여러 제품이 같이 쓸 때

같은 광고 계정을 여러 제품에 이으면 allob 이 캠페인마다 어느 제품 광고인지 정해 그 제품 광고비로만 세요. 광고 링크가 제품 사이트로 가거나 앱 설치 광고가 제품 앱이면 그 제품, 이 제품 실험의 캠페인이면 이 제품, 캠페인 이름에 제품 이름이 낱말로 들어 있으면 그 제품이에요. 광고 탭 위에는 이 제품 광고만 · 공유 계정 이 보여요.

어느 제품 광고인지 모르는 캠페인은 어느 제품에도 세지 않고, 마케팅 캘린더의 제품을 모르는 광고 에 모여요. 제품 고르기 를 누르고 제품을 고르면 그때부터 그 제품 광고로 세요. 잘못 정해진 캠페인은 그 제품 줄의 제품 바꾸기 로 다른 제품이나 제품을 모르는 광고로 옮기고, 자동으로 정하기 로 되돌릴 수 있어요. 보관하거나 지운 캠페인처럼 캠페인 목록에 없는 캠페인은 "목록에 없는 캠페인"으로 보여요. 광고 탭의 이 제품 캠페인 고르기 에서 고른 캠페인과 이름 앞글자(예: viva-)도 자동으로 정한 것보다 앞서요. 전체 요약의 광고비는 광고 계정마다 한 번만 세요 — 제품 광고비 합과 제품을 모르는 광고를 합한 값이에요.

allob ads filter --prefix viva-
allob ads filter --all

#지표 탭의 광고 카드

광고 실험이 없으면 CAC 와 광고 ROAS 는 보이지 않아요. 광고로 온 결제가 아직 없거나, 환불이 결제보다 많거나, 광고비를 다 아는 날이 아직 없으면(광고비를 오늘 처음 읽었거나 한 번도 못 읽음) "—"로 보여요. 광고 화면의 기간 합계, 실험 그룹마다 결제 수·매출, allob ads insights 도 같은 규칙으로 세요. 다만 실험 그룹의 결제 수는 결제 기록과 광고로 들어온 기기의 결제 이벤트 중 큰 쪽이에요. 결제 알림을 실험 뒤에 연결했거나 앱 결제에 광고 링크 정보가 안 붙으면 결제 기록이 모자랄 수 있어서요. 결제 알림을 연결하지 않았으면 결제 이벤트로만 세요(비어 있는 결제 기록을 결제 0건으로 보고 그룹을 끄자고 하지 않게). 그래서 실험 그룹의 CAC 는 지표의 CAC 와 다를 수 있어요. 매출은 늘 결제 기록으로 세서, 결제는 있는데 매출이 0인 그룹이 보일 수도 있어요. 결제한 날도 광고 계정 시간대로 세서 광고비와 같은 날에 놓아요. CAC 와 광고 ROAS 는 광고비를 다 아는 날만 세요 — 광고비를 처음 읽은 날 전과 마지막으로 읽은 날(아직 덜 끝난 날)은 빼요. 요즘 흐름의 추이 카드와 같은 날 규칙이고, 카드 아래에 센 날을 적어 줘요. 광고 실험이 아닌 캠페인의 광고비는 CAC 에 넣지 않고, 다른 길로 온 결제 수는 카드 아래에 따로 알려 줘요. 요즘 흐름의 "전체 ROAS"는 전체 매출 ÷ 계정 전체 광고비라서 광고 ROAS 와 달라요.

광고 숫자와 광고로 온 결제는 광고 계정 시간대의 날짜로 세요. 지표의 다른 숫자(방문·결제 이벤트)는 한국 시간 날짜라서, 광고 계정 시간대가 한국이 아니면 하루씩 어긋날 수 있어요.

#광고 탭의 성과와 소재

광고 탭 맨 위 광고 성과에는 고른 기간(7·30·90일)에 쓴 돈, 들어온 매출, 광고비 대비 매출(ROAS), 결제 수, 결제당 광고비가 보여요. 숫자마다 바로 앞 같은 날 수와 비교해 ▲▼ 로 알려 줘요. 앞 기간 광고비나 결제를 아직 읽지 못했으면 비교하지 않아요.

결제와 매출은 두 곳에서 따로 세고, 섞어 합하지 않아요.

Meta 가 결제를 하나라도 셌으면 Meta 숫자를 앞에, 아니면 allob 숫자를 앞에 두고 다른 쪽은 그 아래 한 줄로 보여 줘요.

아래 캠페인 표에는 캠페인 › 광고 세트 › 광고마다 광고비, 노출, 클릭, 클릭률, 결제, 전환율(결제 ÷ 클릭), 결제당 광고비, 매출, 광고비 대비 매출(ROAS)이 있어요. 클릭당 비용은 줄을 누르면 열리는 자세히 보기에 있어요. 광고 줄 앞에는 소재 썸네일이 있고, 영상 소재에는 재생 표시가 붙어요. 줄을 누르면 소재를 크게 보고(제목·본문, Meta 에서 광고 보기로 영상까지), Meta 와 allob 숫자를 따로 볼 수 있어요. ROAS 와 결제당 광고비는 이 제품 평균과 20% 넘게 차이 나면 평균보다 높은지 낮은지 ▲▼ 로 보여 주고, 좋은 쪽이면 초록, 나쁜 쪽이면 빨강으로 칠해요. 결제당 광고비만큼 쓰고도 결제가 없는 광고는 이름 옆에 결제 없음을 붙이고 요약 아래에 따로 알려 줘요.

allob 결제는 실험 그룹이 광고 세트 하나만 쓰면 그 광고 세트에, 광고가 하나뿐이면 그 광고에 연결해요. 실험에 없는 줄이나 여러 광고가 함께 쓰는 줄은 allob 숫자가 비어 있어요.

#바뀐 것은 타임라인에

캠페인, 광고 세트, 광고를 켜거나 끄거나 예산을 바꾸면 allob 이 다음에 읽을 때 알아채고 변경 타임라인에 한 줄 남겨요. 예를 들면 Meta campaign "Spring" active → paused 처럼요. 누가 바꿨는지는 allob 이 알 수 없어서 타임라인에는 Meta 에서 바뀜으로 보여요. 광고 관리자에서 바꿔도 남고, 같은 상태를 여러 번 읽어도 한 번만 남아요. 처음 연결할 때 이미 있던 상태는 남기지 않아요.

#광고 실험

실험은 가설 하나를 두고 그룹 2~6개를 비교해요. 예를 들어 "영상 소재가 이미지 소재보다 결제당 광고비가 낮다"는 가설이면 그룹이 영상·이미지 둘이에요. 그룹마다 광고 세트를 따로 두고, 광고 주소에 utm_campaign=<실험 id>&utm_content=<그룹 id> 를 붙여요. 그래야 allob 이 결제를 그룹별로 셀 수 있어요.

1. 만들기 — 에이전트가 광고를 꺼진 채로 만들고 실험으로 묶어요. 광고를 만들려면 Meta Ads 를 Facebook으로 연결하고 광고 관리 권한까지 허락해야 해요. 토큰 연결은 읽기만 해요. 광고가 이미 Meta 에 있으면 광고 탭의 실험 만들기로 직접 묶어요. 이름·가설 → 비교할 광고 세트(캠페인 하나에서 2~6개, 광고 세트 하나가 그룹 하나) → 도착 페이지 → 하루·총 한도(끝낼 날, 결제 1건당 비용 한도는 골라서) 순서로 하나씩 묻고, 실험 초안을 만들어요. 광고는 꺼진 채 그대로예요. 다 만들면 그룹마다 광고 주소에 붙일 UTM 값을 보여 줘요.
2. 예산 한도 승인 — 하루 한도와 총 한도를 요청하면 승인 화면 주소가 나와요. 사람이 보고 승인해요.
3. 켜기 전 확인 — 광고 계정이 USD 인지, 픽셀을 골랐는지, 서버 전환이 켜져 있는지, 도착 페이지가 열리는지, 광고 주소에 utm 이 있는지, 하루 예산 합이 승인한 한도 안인지, 이벤트가 들어오는지 봐요. 캠페인에 실험 그룹 밖의 광고 세트가 있으면 켜지 않아요. 캠페인을 켜면 그 광고 세트도 돈을 쓰기 때문이에요. 광고도 자기 그룹의 광고 세트 아래에 있어야 해요. 확인한 뒤 광고 세트·광고·예산이 바뀌면 다시 확인해야 켤 수 있어요.
4. 켜기 — 켜기 요청을 사람이 승인하면 allob 이 Meta 에서 지금 모습을 다시 읽고(동기화 뒤에 생긴 광고 세트도 봐요), 한도와 확인을 다시 본 뒤 캠페인 지출 한도를 승인한 총 한도로 걸고 켜요. 막히는 게 있으면 켜지 않고 이유를 보여 줘요.
   • 캠페인 지출 한도는 승인한 통화와 광고 계정 통화가 같을 때만 걸어요. 통화가 다르거나, 캠페인 없이 광고 세트만 묶은 실험이거나, Meta 가 받지 않으면 한도 없이 켜요. 이때는 승인 결과 화면에 "캠페인 지출 한도를 걸지 못했어요"가 뜨고, 총 한도는 allob 자동 점검과 직접 확인으로 지켜요.
5. 자동 점검 — 규칙(예: 결제당 광고비가 20달러를 넘으면)에 걸린 그룹이 있으면 끄자는 요청을 만들어요. 스스로 끄지는 않아요. 끌지는 사람이 정해요. 한도를 승인하기 전에는 자동 점검이 꺼져 있어서 요청을 만들지 않아요. 화면에 한도 승인 전 — 자동 점검 꺼짐이 보이면 한도 승인부터 요청하세요.

그룹별 결제는 그 실험 광고로 들어와 결제한 기기만 센 값이에요. 실제보다 적을 수 있어요. 결제가 3건보다 적은 그룹은 결제당 광고비로 판단하지 않아요.

서버 전환은 allob 이 웹 결제를 서버에서 Meta 로 보내는 거예요. allob 이 Dodo 결제 알림을 받고(결제 기록하기), 제품 › 연결에 Meta Conversions API 를 연결해 두면 보내요. 광고 차단이나 쿠키 제한으로 브라우저 픽셀이 결제를 놓쳐도 Meta 가 결제를 알아서, 광고가 결제로 이어지는 사람에게 돈을 쓰게 돼요.

• allob 이 Dodo 결제 알림을 받는데 Meta Conversions API 를 연결하지 않았으면 켜기 전 확인을 통과하지 못해요. 연결하면 돼요.
• Dodo 결제 알림이 없는 제품은 알려 주기만 하고 막지 않아요. 앱 결제(RevenueCat), 서버에서 직접 보내는 결제, 자기 서버가 Meta 로 보내는 결제는 allob 이 Meta 로 보내지 않아요. 이런 제품은 Meta 가 다른 길로 결제를 받는지 확인해 주세요.

실험이 끝나면 그때 숫자를 저장해 둬요. 광고비는 끝난 날까지만 세요. 끝난 뒤 3일 동안은 늦게 들어오는 광고비·결제를 반영해 다시 세고, 그 뒤로는 저장한 숫자를 그대로 보여 줘요. 오래된 이벤트가 지워져도 지난 실험의 숫자가 바뀌지 않아요. 끝난 실험을 다시 켜면 다음에 끝날 때 새로 저장해요. 시작한 지 90일이 넘은 실험을 가져오면 숫자를 셀 수 없어서 계획만 보여요.

켜고 끄는 시간표도 사람이 승인한 것만 따라요. 정한 시각을 지날 때만 켜고 끄고, 켤 때마다 한도를 다시 봐요. 끌 시각에는 이미 꺼져 보여도 한 번 더 꺼요.

#실험 고치기·지우기

광고 탭에서 실험을 열면 맨 아래에 고치기와 지우기가 있어요. 에이전트는 allob ads experiment update·delete 로 같은 일을 해요. 어느 쪽도 Meta 광고를 바꾸지 않아서 승인 없이 바로 돼요. 바꾼 것은 변경 타임라인에 남아요.

고칠 수 있는 것은 실험 상태에 따라 달라요.

• 메모에는 배운 점이나 다음에 해 볼 것을 적어 두세요. 끝난 실험을 돌아볼 때 같이 보여요.
• 준비 중인 실험의 광고 세트·도착 페이지·한도를 바꾸면 켜기 전 확인을 다시 해야 켤 수 있어요.
• 진행 중인 실험의 결제 1건당 비용 한도 같은 멈춤 규칙은 에이전트가 더 엄격하게만 바꿀 수 있어요. 규칙을 빼거나 느슨하게 하는 건 화면에서 직접 해요.

지우기도 상태에 따라 달라요.

• 준비 중 — 아직 켠 적이 없으니 정말 지워요. 이 실험의 기다리는 요청도 같이 닫혀요. 다만 Meta 에서 캠페인이 켜져 있으면 먼저 꺼야 지울 수 있어요.
• 끝남 — 지우지 않고 숨겨요. 실험 기록과 캘린더에서만 빠지고, 끝날 때 저장한 숫자와 변경 기록, 결제당 광고비 같은 지표 숫자는 그대로예요. 실험 기록 아래 숨긴 실험 보기에서 다시 보이게 할 수 있어요.
• 진행 중 — 지울 수 없어요. 먼저 실험 끝내기로 끄기 요청을 만들고 승인하세요.

지우거나 숨겨도 Meta 광고는 꺼지지 않아요. 마지막으로 읽었을 때 실험의 캠페인이 켜져 있었으면 확인 창에 알려 줘요.

allob ads experiment view --all 로 이 제품의 광고 실험을 보고, 끝난 실험마다 결과를 한 줄로 정리해서 allob ads experiment update <id> --spec 으로 메모(notes)에 남겨 줘.
켠 적 없는 오래된 초안은 목록만 보여 주고, 내가 고른 것만 allob ads experiment delete 로 지워 줘. 광고는 켜거나 끄지 마.

#이미 돌린 실험 가져오기

allob 을 쓰기 전에 돌렸거나 계획해 둔 실험은 allob ads experiment import 로 가져와요. 시작·끝 날짜와 상태(시작 전·진행 중·끝남), 하루·총 한도, 켜고 끄는 시간표를 그대로 넣으면 마케팅 캘린더와 광고 탭에 바로 보여요. 광고 계정을 아직 연결하지 않았으면 쓴 돈은 연결 전으로 보이고, 연결하면 채워져요.

• 가져온 한도와 시간표는 계획으로만 보여요. allob 이 그 시간표대로 광고를 켜고 끄지 않고, 켜려면 지금처럼 한도 승인과 켜기 승인을 거쳐야 해요.
• 같은 id 가 이미 있으면 건너뛰어요. 같은 파일을 두 번 넣어도 하나만 남아요.
• 먼저 --dry-run 으로 무엇이 들어갈지 확인하세요. 하나라도 틀린 실험이 있으면 아무것도 넣지 않아요.

지난 마케팅 변경도 원래 시각으로 남길 수 있어요(allob change add --at <그때 시각>).

이 폴더의 광고 실험 기록을 allob ads experiment import 로 가져와 줘. 실험마다 id·이름·가설·상태(draft·running·ended)·시작(startAt)·끝(endAt)·그룹(광고 세트 id)·하루/총 한도와 통화를 채워서 JSON 파일로 만들고,
먼저 --dry-run 으로 확인한 결과를 보여 준 뒤에 넣어 줘. 광고는 켜지 마.

광고 탭에서도 에이전트에게 맡길 수 있어요. 진행 중인 실험 카드의 성과 보기 맡기기, 실험 기록의 다음 실험 설계 맡기기를 누르면 그 실험·제품에 맞춘 프롬프트가 복사돼요. 코딩 에이전트에 붙여 넣으면 돼요.

allob ads experiment create 로 Meta 광고 실험을 만들어 줘. 가설은 "영상 소재가 이미지 소재보다 결제당 광고비가 낮다"야.
그룹마다 광고 세트를 따로 두고 광고 주소에 utm_campaign=<실험 id>&utm_content=<그룹 id> 를 붙여 줘. 광고는 모두 꺼진 채로 만들어.
예산 한도는 allob ads request caps 로 나에게 승인받고, allob ads experiment preflight 가 통과하면 켜기 요청을 만들어 줘.

#에이전트에게 맡기기

allob ads view 로 이 제품의 Meta 광고 상태를 보고, allob ads insights --days 14 로 지난 2주 광고비와 결제 수를 요약해 줘.
CAC 가 가장 높았던 날과 그날 타임라인에 기록된 변경이 있는지 allob timeline view 로 같이 알려 줘. 켜거나 끄는 건 요청만 만들고 나에게 승인받아.

MCP 를 쓰는 에이전트는 get_ads, get_ad_insights, get_ad_experiment, request_ad_change 같은 도구로 같은 일을 해요.

#알아 둘 것

• 보통 3시간마다 읽어요. 광고 계정을 연결하거나 Meta 를 다시 연결하면 바로 한 번 읽어요. 그 밖에는 숫자가 몇 시간 늦을 수 있어요. 마지막으로 읽은 때는 카드 위와 allob ads view 에 보여요.
• 바로 다시 읽고 싶으면 광고 탭의 지금 다시 읽기나 allob ads refresh 를 써요. 제품마다 10분에 한 번 할 수 있어요.
• 최근 3일 숫자는 Meta 가 나중에 고치기도 해서, 읽을 때마다 다시 읽어 덮어써요.
• Meta 호출 한도에 걸리면 다음 읽기 때(보통 3시간마다) 이어서 읽어요.
• 처음 연결할 때는 광고를 읽는 권한만 받아요.
• Facebook 연결은 기한이 없어요. 비즈니스 설정에서 allob 을 빼거나 권한을 바꾸면 연결 화면에 다시 연결하라는 표시가 떠요.
• 광고 계정 연결을 끊으면 그 제품의 광고 숫자도 지워요. 다시 연결하면 지난 30일부터 다시 읽어요.

마크다운으로 보기 · llms.txt · 개인정보 처리방침 · 이용약관