릴리스와 마케팅 변경
숫자가 갑자기 오르거나 내렸을 때 "그때 무엇을 바꿨지?"에 바로 답할 수 있도록, 바꾼 일을 한 줄씩 기록해요. 기록은 지표 그래프 위에 점으로 표시되고, 점을 누르면 그 전후를 비교할 수 있어요.
| 기록 | 언제 남기나 | 명령 |
|---|---|---|
| 릴리스 | 사용자가 보는 배포를 했을 때. 커밋마다가 아니라 배포마다 한 번 | allob release create |
| 마케팅 변경 | 광고·게시물·할인·스토어 정보를 바꾼 그 순간 | allob change add |
에이전트에게 맡기기
기록은 에이전트가 알아서 하게 두는 게 가장 좋아요. 프로젝트의 AGENTS.md 에 규칙을 넣어 두면, 에이전트가 배포할 때마다 스스로 릴리스를 남겨요.
코딩 에이전트에게 붙여 넣기
allob folder agents 를 실행해서 AGENTS.md 에 allob 작업 규칙을 넣어 줘. 앞으로 배포가 나가면 그 규칙대로 allob release create 로 사용자가 알아챌 변경을 한 줄씩 기록해 줘.allob folder init 으로 시작했다면 이미 들어 있어요. 마케팅 변경은 사람이 한 일이 많아서, 바꾼 직후 에이전트에게 한 줄 부탁하면 돼요.
코딩 에이전트에게 붙여 넣기
방금 Meta 광고 예산을 하루 20달러에서 40달러로 올렸어. allob change add 로 기록해 줘.릴리스 기록하기
allob release create 1.4.0 \
-c "ux: new pricing page — watch checkout_start" \
-c "fix: checkout froze on Safari" \
--platform web,ios- 줄마다 사용자가 알아챌 변경 하나를 써요. 종류는
feature(새 기능),ux(화면·흐름),price(가격),fix(버그 수정),tracking(측정 변경) 중 하나예요. - 한 줄은 80자 이내로, 무엇을 바꿨고 어떤 숫자를 볼지 써요.
- 리팩터링, 개발 도구, 문서, 의존성 업데이트, 같은 버전 재배포는 기록하지 않아요.
- 무엇이 나갔는지 헷갈리면
allob release create --dry-run으로 지난 릴리스 이후의 커밋을 볼 수 있어요.
| 옵션 | 설명 |
|---|---|
| 버전 | 제품 안에서 겹치지 않는 이름. 생략하면 배포한 날(한국 시간)로 이름을 붙여요 — 2026-10-30, 같은 날 두 번째부터 2026-10-30-2 |
--platform | 배포한 곳: web, ios, android, mac, windows |
--notes | 스토어 "새로운 기능"이나 변경 내역에 쓸 글(@파일 도 가능) |
--git | 배포한 git 커밋. 기본은 지금 폴더의 최신 커밋(HEAD) |
--reverts | 앞선 릴리스를 되돌리는 릴리스면 그 버전. 타임라인에서 두 릴리스가 이어져 보여요 |
--at | 실제 배포 시각. 나중에 기록할 때 |
--app-version | 앱 릴리스가 내보낸 앱 버전(1.2.0, 빌드까지면 1.2.0+34). 생략하면 iOS·Android·macOS 릴리스는 릴리스 버전 이름을 앱 버전으로 봐요. 날짜로 붙은 이름은 앱 버전으로 보지 않아요 |
--ota | OTA 업데이트로 내보냈으면 그 업데이트 ID(쉼표로 여러 개) |
기록한 릴리스는 allob release list, allob release view 1.4.0 으로 봐요.
앱 릴리스
앱은 업데이트가 천천히 퍼져서, 전후 비교와 함께 이 버전을 쓴 기기와 다른 버전을 쓴 기기를 나눠 비교해요(전후 비교). 그러려면 릴리스가 어느 앱 버전인지 알아야 해요.
- 스토어에 새 빌드를 낼 때는 릴리스 버전 이름을 앱 버전(예:
app.json의version)과 같게 써요. 그러면 따로 적을 게 없어요.
``sh allob release create 1.2.0 -c "ux: new onboarding — watch onboarding_done" --platform ios,android ``
- 이름이 다르면(예:
spring-update)--app-version 1.2.0을 붙여요. - OTA 업데이트(Expo EAS Update 등)는 앱 버전이 그대로라서 업데이트 ID 로 찾아요.
eas update가 출력한 플랫폼별 업데이트 ID(iOS·Android)를--ota에 적어요.
``sh allob release create 1.2.1 -c "fix: checkout froze" --platform ios,android --ota <iOS update ID>,<Android update ID> ``
앱이 이벤트에 버전을 실어 보내야 해요(앱에 측정 넣기). 앱 버전을 알면 릴리스 뒤 14일 동안 그 버전의 가입·결제 비율이 다른 버전보다 크게 떨어지는지 allob 이 지켜보고 알려 줘요(지표 이상 알림).
코딩 에이전트에게 붙여 넣기
방금 OTA 업데이트를 내보냈어. eas update 출력에서 iOS·Android 업데이트 ID 를 찾아서 allob release create 에 --ota 로 넣고, 사용자가 알아챌 변경을 한 줄씩 기록해 줘.되돌리기
배포한 변경을 되돌렸다면, 되돌린 릴리스를 새로 기록하면서 어느 릴리스를 되돌렸는지 적어요.
allob release create 1.4.1 -c "ux: back to the old pricing page" --reverts 1.4.0
allob change add ad 'Meta budget back to $20/day' --reverts ch_20261017_1400_ab12마케팅 변경은 되돌린 변경의 ID(ch_…)를 적어요. 같은 제품의 앞선 릴리스, 같은 제품의 앞선 마케팅 변경만 되돌릴 수 있어요. 마케팅 변경은 같은 종류끼리만 이어요 — 광고(ad·budget·creative 등)는 광고끼리, 글(content·publish·schedule 등)은 글끼리예요. 지표 탭에서는 되돌린 변경이 속이 빈 점으로 보이고, 되돌린 변경과 선으로 이어져요. 전후 비교에서는 두 변경을 서로 오갈 수 있어요.
스토어에 쓸 "새로운 기능" 글
릴리스마다 스토어 "새로운 기능"·변경 내역에 쓸 글을 언어별로 만들어요.
allob release notes 1.4.0 # 언어별 글 보기
allob release notes 1.4.0 --lang en --set "Dark mode is here." # 영어 글 저장
allob release notes 1.4.0 --lang en --clear # 영어 글 지우기언어별로 저장한 글이 있으면 그 글을 써요. 없으면 --notes 로 적은 노트를 쓰고, 노트도 없으면 사용자가 알아챌 변경 줄로 글을 만들어요(tracking 줄은 빼요). App Store 는 4,000자, Google Play 는 500자까지만 넣을 수 있어요(넘으면 올릴 때 거절돼요). 넘으면 표시해 줘요. 번역은 에이전트에게 맡기고 --set 으로 저장하면 돼요.
마케팅 변경 기록하기
allob change add ad 'Meta budget doubled to $40/day — watch cost per checkout'
allob change add content 'Reel: typing pet — watch landing visits'| 종류 | 언제 |
|---|---|
ad | 광고를 켜고 끄거나, 예산·타기팅·소재를 바꿨을 때 |
content | SNS·블로그에 글을 올렸을 때 |
promo | 할인이나 이벤트를 시작했을 때 |
store | 앱 스토어 정보·스크린샷을 바꿨을 때 |
- 바꾼 일 하나에 한 줄이에요. 여러 개를 바꿨으면 따로따로 기록해요.
- 한 줄은 80자 이내로, 무엇을 바꿨고(값이 있으면 전 → 후) 어떤 숫자를 볼지 써요.
- 까닭·해시태그·링크는 넣지 않아요. 나중에 타임라인에서 한눈에 찾을 수 있게요.
광고·글 올리기 도구가 바꾼 것을 기록할 때는 무엇을 바꿨는지 알 수 있는 종류를 써요. 내용은 사람이 쓰는 줄처럼 한 줄 80자까지예요. creative(소재), budget(예산), status(켜기·끄기), targeting, keyword, conversion(전환 설정), experiment, create, publish, schedule 중 하나예요. 무엇을 바꿨는지(--target channel=meta), 바꾸기 전과 후의 값(--before·--after, JSON)도 함께 남길 수 있어요.
allob change add budget 'Meta daily budget $20 → $40' --target channel=meta --before '{"daily":20}' --after '{"daily":40}'내용은 작은따옴표('…')로 감싸요. 큰따옴표 안의 $40 같은 글자는 터미널이 다른 값으로 바꿔 버려요.
제품 하나가 아니라 사업 전체에 대한 변경이면 --account-wide, 지난 일을 기록하면 --at 을 붙여요.
타임라인 보기
allob timeline view --since 90d
allob change list --area marketing --since 30d웹 화면의 제품 › 지표 탭에서는 같은 기록이 그래프 위에 점으로 나와요. 지표 보기를 참고하세요.
마케팅 캘린더
웹 화면 왼쪽 메뉴의 마케팅 캘린더는 모든 제품을 한 달력에 모아 보여 줘요. 맨 위 한 줄에서 지금 도는 광고 수, 광고가 언제까지 잡혀 있는지, 끝 날짜 없이 도는 광고 수를 먼저 알려 줘요. 제품마다 이런 줄이 있어요.
| 줄 | 보이는 것 |
|---|---|
| 제품 이름 | 날마다 그날 ROAS(그날 매출 ÷ 그날 광고비)를 색으로 — 1배 밑은 손해라 주황, 1배 근처는 옅은 회색, 1배 위는 이익이라 청록이고 1배에서 멀수록 진해요(3배 이상은 가장 진하게). 매출은 결제 서비스의 날짜, 광고비는 광고 계정 시간대의 날짜로 세요. 광고 없이 매출만 난 날은 회색 점. 광고 계정을 이었는데 매출을 모으지 않는 제품은 광고비(진할수록 많이 쓴 날)와 매출 점으로 보여요 |
| 출시 | 릴리스한 날과 버전 |
| 광고 실험 | 시작부터 끝까지 막대와 언제까지 · 쓴 돈 / 총 한도 · 하루 한도. 막대 안 진한 부분이 쓴 돈 ÷ 총 한도예요. 켜고 끄는 시간표가 있으면 아래 줄에 켜는 날이 보여요(가져온 계획은 점선) |
| 광고 캠페인 | 광고 계정의 캠페인마다 시작부터 끝까지 막대와 언제까지 · 이 기간 쓴 돈 · 예산. 도는 캠페인은 제품 색, 끝 날짜가 없으면 오른쪽 끝이 흐려져요. 시작 전은 점선 테, 끝났거나 꺼 둔 캠페인은 회색이에요 |
| 바꾼 것 | 마케팅 변경을 남긴 날 |
| SNS 글 | 올라간 글, 예약한 글(옅게), 실패한 글(빨간 테) |
캠페인의 끝은 Meta 광고 관리자에서 정한 캠페인 종료일이에요. 캠페인에 없으면 광고 세트 종료일 중 가장 늦은 날로 보여요(광고 세트 하나라도 종료일이 없으면 끝 날짜 없음). 실험으로 만든 캠페인은 실험 줄에만 보여요.
광고 계정 하나를 여러 제품이 같이 쓰면 캠페인마다 어느 제품 광고인지 정해 그 제품 줄에 보여요(광고비 합 옆에 공유 계정). 어느 제품 광고인지 모르는 캠페인은 광고 계정마다 제품을 모르는 광고 묶음에 모이고, 제품 고르기 로 정하면 그 제품 줄로 옮겨 가요. 이 묶음은 매출을 알 수 없어서 날짜마다 ROAS 대신 광고비(진할수록 많이 쓴 날)로 보여요.
캠페인 막대나 이름을 누르면 캠페인 자세히가 열려요. 상태·기간·예산·어느 제품 광고인지와 함께, 지금 보이는 기간 중 캠페인이 돈 날의 광고비·노출·클릭·클릭률·결제를 보여 줘요. 결제는 Meta 기준 결제(광고 세트에 정한 기간 안에 Meta 가 센 결제)와 allob 기준 결제(실험 광고 링크로 들어와 결제한 것)를 따로 보여 주고, 결제당 광고비·매출·ROAS 도 기준마다 따로예요. 전체 기간을 고르면 캠페인 시작부터 오늘까지로 바뀌어요. 아래에는 날마다 광고비 막대와 광고 세트·광고(소재 그림·광고비·클릭률·결제)가 있고, 광고 탭에서 보기를 누르면 그 제품 광고 탭에서 같은 캠페인을 열어요. 숫자는 광고 탭과 같은 방법으로 세요. 제품을 모르는 광고도 같은 방법으로 열리고, 광고 계정을 같이 쓰면 여기서 제품 바꾸기·제품 고르기를 할 수 있어요. 실험 막대나 이름을 누르면 광고 탭에서 실험을 눌렀을 때와 같은 화면이 열려요.
옆으로 넘기면 위의 기간 글이 지금 보이는 날로 바뀌어요. 위의 제품 버튼을 누르면 그 제품을 숨기거나 다시 보여요. 묶음의 이름(제품·광고 계정)을 누르면 그 묶음을 접어 첫 줄(광고비·매출 점·출시한 날)만 남기고, 다시 누르면 펴요. 모두 접기·모두 펴기로 한꺼번에 바꿀 수 있고, 접은 상태는 이 브라우저에 기억돼요.
날짜에 마우스를 올리면 그날 광고비·매출·ROAS 가 글로 보이고(화면 읽기도 같아요), 누르면 그날의 광고비·매출·결제·방문 기기와 그날 한 일을 볼 수 있어요. ROAS 의 매출은 전체 요약의 제품 ROAS 와 같은 매출이에요(통화가 다르면 광고 계정 통화로 바꿔요). 그날 돈을 쓴 광고는 그날 광고비·클릭·결제와 함께 보이고, 누르면 캠페인 자세히가 열려요. 처음 열면 오늘 앞 3주부터 뒤 2주까지 보이고(휴대폰은 2주), 주말과 공휴일은 흐리게 보여요. 광고비 날짜는 광고 계정 시간대 기준이에요.
아직 모르는 숫자가 있는 지난날은 빗금으로 보여요(광고 계정도 없고 매출도 난 적 없는 제품은 빗금 없이 비워 둬요). 광고비를 읽기 전인 날(광고 계정을 이었지만 아직 한 번도 못 읽었으면 모든 날), 광고비 읽기가 며칠 실패한 날(연결이 끊긴 때 등), 매출을 일부 결제 서비스에서만 모은 날, 결제 서비스 시간대로 아직 끝나지 않은 날이에요. 0 인 날과는 달라요. 이런 날이 섞여 있으면 제품 이름 옆 광고비 합에 "이상"이 붙고, 아는 날이 하나도 없으면 "광고비 모름"으로 보여요.
광고 계정을 아직 연결하지 않았어도 실험 계획은 보여요. 기간·한도·시간표는 그대로 보이고, 쓴 돈 자리에는 한도만, 제품 이름 옆에는 광고 계정 연결 전이 보여요. 모르는 숫자(빗금)와 달리, 연결하면 그때부터 쓴 돈이 채워져요.
오늘은 아직 진행 중이라 점선 테로 따로 보여요. 광고비는 그때까지 쓴 만큼이고, 매출은 하루가 끝난 뒤에 보여요. 광고 계정 시간대가 한국보다 늦으면 그 계정의 오늘이 한국 날짜로 어제라서 어제부터 진행 중으로 보여요.
allob calendar view
allob calendar view --from 2026-10-01 --to 2026-10-31 --json