allob Docsallob 열기

측정

마치면 제품 이벤트가 allob 에 들어와서, 출시 직후부터 "어디서 빠지나", "어제 바꾼 화면이 결제율을 올렸나"를 숫자로 볼 수 있어요. 서버 결제 이벤트는 돈을 받을 때만, GA4 연결은 GA4 를 고를 때만 해요. 나중에 넣으면 출시 직후 숫자를 놓쳐서 출시 전에 해요.

시작하기 전에

  • allob 로그인과 제품 — 제품의 플랫폼·돈 버는 방식이 정해져 있어야 해요(제품 정하기).
  • 제품 코드 폴더 — 코딩 에이전트가 이 폴더에서 일해요.
  • 측정·광고 도구가 정해져야 처리방침과 스토어 설문을 쓸 수 있어서, 법 문서보다 먼저 해요.

코딩 에이전트에게 붙여 넣기

이 allob 사업 가이드를 읽고, 내 사업에 해당하는 할 일만 골라 진행해 줘: https://allob.app/docs/journey-measure.md
1. allob business view 와 allob path view --business 로 내 사업 모양(사업자 형태·돈 버는 방식·파는 나라)을 먼저 확인해.
2. 해당하지 않는 할 일은 왜 아닌지 한 줄로 알려 주고 allob step skip <id> --reason "…" 으로 넘겨.
3. 해당하는 할 일은 allob step view <id> 의 안내대로 하고, 끝나면 allob step done <id> --note "끝났다는 증거" 를 불러.
4. 본인 인증·서명·결제·약관 동의처럼 사람만 하는 곳에서는 멈추고 무엇을 누르면 되는지 알려 줘.
5. 되돌리기 어려운 답(과세 유형·계정 유형 등)은 내 폰으로 확인 요청이 와 — 명령이 보여 준 승인 링크를 알려 주고, 기다리는 동안 다른 할 일로 넘어가.

코드 폴더 연결하기

제품 코드 폴더를 allob 제품에 연결해요. 명령 하나(allob folder init)로 아래가 한 번에 끝나요.

  1. 폴더가 제품과 연결돼요(allob.json). 이 폴더에서는 명령마다 제품 이름을 적지 않아도 돼요.
  2. 스키마가 없으면 첫 스키마를 만들어 올려요. 앱이면 앱 열기 이벤트가 들어 있어요.
  3. 플랫폼에 맞는 측정 코드(SDK)를 받아요.
  4. 에이전트 규칙 파일에 allob 작업 규칙이 추가돼요. 다음부터 에이전트가 배포마다 변경을 기록해요.

에이전트가 끝까지 해요. 끝나면 allob path view 에서 이 할 일이 끝남으로 바뀌어요.

측정 도구 고르기

allob 말고도 GA4·Meta 픽셀·TikTok 픽셀 중 무엇을 같이 켤지 골라요. 이 제품은 측정하지 않기로 했으면 "측정 안 함" 하나만 골라요.

조건고를 길그 길의 대가
늘allob 자체 측정이벤트·퍼널·리텐션·변경 기록을 내 데이터로 봐요. 이벤트는 스키마로 정의해요
Google 검색 광고를 하거나 GA4 화면으로도 보고 싶어요GA4 도 같이Google 검색 광고 전환을 GA4 주요 이벤트로 가져와요. 처리방침에 Google 을 적어요
Meta(인스타·페이스북)에 광고할 거예요Meta 픽셀광고 최적화·전환 측정이 돼요. 페이지 주소·referrer·페이지 설명까지 가져가니 주소에 개인정보를 싣지 않아요. 처리방침·EU 동의가 필요해요
TikTok 에 광고할 거예요TikTok 픽셀Meta 픽셀과 같은 대가예요
광고 계획이 아직 없어요allob 만(+ GA4)문서·설문이 가장 단순해요. 광고를 시작할 때 픽셀을 추가하고 문서를 고쳐요
이 제품은 측정하지 않아요측정 안 함(다른 것과 같이 고를 수 없어요)이벤트 스키마·이벤트 확인 같은 측정 할 일이 모두 해당 없음이 돼요. 지표 화면엔 숫자가 없어요. 나중에 답을 바꾸면 그 할 일이 다시 켜져요

도구를 추가하면 처리방침 개정과 스토어 설문 재제출이 따라올 수 있어요. 그 비용을 먼저 보고 정해요. 한국 처리방침엔 광고·분석 위탁 업체와 국외 이전 표가 들어가요(픽셀 흐름을 위탁·제3자 제공 중 무엇으로 볼지는 법 문서에서 정해요). 픽셀·GA4 로 같이 보내는 기능은 웹 SDK 기준이에요. 앱은 확인 필요.

이벤트 스키마 만들기

이 제품만의 이벤트를 스키마에 추가하고 올려요. 처음엔 핵심 행동까지 이벤트 3~5개면 충분해요.

예: 일기 앱이면 "일기 쓰기 → 결제 화면 보기 → 결제 시작 → 결제"를 이벤트로 적고, 이 순서로 퍼널 하나를 같이 넣어요.

  1. 출시 뒤 가장 먼저 알고 싶은 질문을 이벤트·속성으로 바꿔요. 예: "결제 창에서 왜 빠지지?" → 결제 창 보기 이벤트에 "어디서 왔나" 속성.
  2. 새 이벤트보다 있는 이벤트에 속성을 추가할 수 있는지 먼저 봐요. 이벤트가 많으면 중요한 숫자가 묻혀요.
  3. 속성에 이름·이메일·생년월일·입력 내용을 넣지 않아요. 값은 정해진 목록이나 짧은 id 만 써요.
  4. 이름은 처음부터 무슨 행동인지 알 수 있게 지어요. 나중에 바꾸면 지난 숫자와 이어지지 않아요.

에이전트가 끝까지 해요. 올린 이벤트 목록은 allob step view <할 일> 의 기록에 남아요. 이벤트를 지우는 변경이 나오면 그때만 목록을 보고 정해 주세요.

코드에 넣고 이벤트 확인하기

생성된 측정 함수를 화면·버튼에 넣고 배포한 뒤, 이벤트가 실제로 들어오는지 확인해요.

  1. 이벤트는 실제로 일어나는 곳(화면·버튼)에서 보내요. 결제는 서버에서 보내요(다음 할 일).
  2. 배포 뒤 제품을 몇 번 써 보면 1분쯤 지나 allob 화면의 제품 › 지표에 이벤트가 보여요.
  3. 10분이 지나도 0건이면 멈추고 원인을 봐요: 배포됐나 → 그 코드 길을 탔나 → 기간이 맞나.

에이전트가 끝까지 해요. 들어온 이벤트는 allob 화면의 제품 › 지표에서 봐요.

서버 결제 이벤트 보내기

결제·환불·구독 해지처럼 서버만 확실히 아는 일을 서버에서 allob 으로 보내요.

결제 서비스(결제 대행, 구독 관리 도구 등)의 웹훅을 받는 코드에 몇 줄 추가해요. 결제 직전에 기기 ID 를 결제 정보에 같이 넘기면, 그 결제가 어느 퍼널·유입 경로에서 나왔는지 알 수 있어요.

  1. 스키마에 서버에서 보내는 결제 이벤트를 추가하고 올려요.
  2. 서버 키를 만들어 서버의 비밀 값에만 넣어요. 키는 만들 때 한 번만 보여요.
  3. 서버 코드 폴더에 서버 SDK 를 받아요.
  4. 결제 서명을 확인한 뒤 결제 이벤트를 보내요. 같은 알림이 두 번 와도 한 번만 세게 해요.
  5. allob 전송이 실패해도 결제 처리는 계속되게 해요.

에이전트가 끝까지 해요. 호스팅에 로그인이 필요하면 로그인만 해 주세요. 들어온 결제 이벤트는 allob 화면의 제품 › 지표에서 봐요.

GA4 연결하기

GA4 속성을 만들어 측정 id 를 스키마에 넣고, Google 계정을 allob 에 연결해 이 제품의 속성으로 골라요.

  1. GA4 에 속성과 웹 데이터 스트림을 만들어요(측정 id 예: G-XXXXXXXXXX).
  2. 측정 id 를 스키마에 넣고 올린 뒤 SDK 를 다시 받아요. GA4 이름을 적은 이벤트만 GA4 로 가요.
  3. Google 로그인으로 allob 에 연결해요. GA4 속성과 AdMob 앱을 함께 가져와요.
  4. 이 제품에 그 GA4 속성을 골라 연결해요.
  5. 유럽 방문자는 동의 전에 GA4 가 돌지 않게 지역별 동의 방식을 스키마에 적어요.
  • 브라우저가 열리면 Google 계정을 고르고 권한 허락을 눌러요. 허락할 범위(애널리틱스·AdMob 읽기)를 한 번 보고 눌러요.
  • Google 애널리틱스 계정을 처음 만들면 약관 동의 — 계정 이름(사업자 이름)과 데이터 공유 설정을 보고 동의해요.

자주 걸리는 함정

증상원인·해결
개인정보가 광고 도구로 가요주소(URL)에 되돌릴 수 있는 id 를 실었어요 → 도구로 가는 요청에서 그 부분을 지워요
이벤트 이름에 오타가 있어요손으로 쓴 이름이에요 → 생성된 함수만 써요
숫자가 0인데 계속 기다려요10분이 넘으면 배포·코드 길·기간 순으로 확인해요
검사를 통과시키려고 스키마를 넓혀요코드가 틀렸는지, 옛 기록이 섞였는지부터 가려요
화면에 이벤트 값을 그대로 그려요이벤트 값은 누구나 광고 URL 로 조작할 수 있어요 → 그릴 때 이스케이프
내 기기 이벤트가 숫자에 섞여요내 기기를 표시해 빼요 — allob 쪽 방법은 확인 필요
다른 나라에서 판다면
  • 유럽(EU·영국·스위스) — 광고·분석 도구를 켜기 전에 동의를 받아요(웹은 동의 배너, 앱 광고는 Google 동의 창). 거부한 사람은 측정에서 빠져 숫자가 줄어요(Google 동의 정책).
  • 미국(캘리포니아 등) — 픽셀로 "공유"가 있으면 "Your Privacy Choices" 링크를 두고 브라우저 거부 신호(GPC)를 지켜요. 주마다 기준이 달라요.
  • 일본 — 外部送信 고지에 어떤 도구에 무엇을 보내는지 적어요. 도구를 추가할 때마다 목록도 고쳐요(총무성 안내).

출처

공식 안내와 마지막으로 맞춰 본 날: 2026-10-18

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