# GreenLeaf 보고 데이터 사전 — v1 의미 계약

**작성:** 2026-10-29 · **상태:** 픽스처 생성 전 동결된 소스 사양. 영어 편집 입력. CSV는 복구된 코스 데이터가 아니라 새로 합성된 재구성입니다. [브리프](brief-v1.md)가 결정을 관할하고, [소스 맵](course-source-map.json)은 출처를 관할합니다. 실제 고객, 건강 정보, 고객 계정은 포함되지 않습니다. 인용한 수치는 영어 근거 자료의 표기를 유지해요. 천 단위 구분은 쉼표, 소수점은 마침표를 쓰며 금액은 USD 기준이에요. 화면의 요약 지표는 선택한 언어·지역에 맞게 표시될 수 있어요.

## 그레인, 기간 및 기여

하나의 표준 행은 영국에서의 UTC 유료 클릭 날짜 × 채널 × 기기 × 오디언스 × 소재 하나입니다. 14일 × 3채널 × 2기기 × 2오디언스 × 2소재 = **336행**. 원시 내보내기에는 정확 중복 1개를 포함해 **337행**이 있습니다. 캠페인은 채널에 속하며 차원을 추가하지 않습니다.

1주차: `2026-09-01`–`2026-09-07` 포함. 2주차: `2026-09-08`–`2026-09-14` 포함. 스냅샷: **`2026-09-22T23:59:59Z`**. 날짜는 UTC 기준이며 `date`은 항상 구매/이벤트 날짜가 아니라 유료 클릭 코호트 날짜를 의미합니다. 퍼널 이벤트와 첫 구매는 적격 유료 클릭 후 7일 동안 관찰됩니다. 정확한 이벤트 타임스탬프는 내보내지지 않으며, 7일 기여/관찰 기간은 생성기 구성 가정입니다. 두 완전한 기간 모두 스냅샷 시점에 성숙했습니다. 게시된 모든 기본 행에는 `is_provisional=false`이 있습니다.

지출, 노출, 클릭은 해당 코호트 날짜에 할당된 획득 활동을 설명합니다. 랜딩, 퀴즈, 구매 개수는 소스 태그가 지정된 유료 클릭 코호트와 기기/오디언스/소재 버킷을 따릅니다. 각 합성 첫 구매 고객과 매출 금액은 7일 내 마지막 적격 유료 클릭에 한 번 할당되며, 모든 이벤트 단계가 동일한 배타적 할당을 따릅니다. 교차 기기 신원 조정은 측정되지 않습니다. 배타성은 구성상 보장되며, 이 집계 파일이 독립적으로 확립한 것은 아닙니다.

## 필드

| 필드 | 유형/단위 | 의미 및 검증 |
|---|---|---|
| `row_id` | 비어 있지 않은 문자열 | 안정적인 고유 표준 행 ID. 원시 정확 중복이 이를 반복합니다. 동일 ID로 충돌하는 행은 오류입니다. |
| `date` | ISO `YYYY-MM-DD` | UTC 소스 유료 클릭 코호트 날짜, 9월 1–14일 이내. |
| `market` | enum | `UK`만. 범위는 가상 영국 출시의 유료 코호트입니다. |
| `channel` | enum | `google-search`, `linkedin`, `reddit-paid`. 유기적 Reddit 활동은 제외됩니다. |
| `campaign_id` | 정규화 후 enum | 채널당 캠페인 하나. 아래 조회 표 참조. |
| `device` | enum | `mobile` 또는 `desktop`, 할당된 소스 유료 클릭의 기기. |
| `audience_id` | enum | `skeptical` 또는 `exploring`. 검증된 고객 특성이 아니라 채널 내 상호 배타적으로 구성된 버킷. |
| `creative_id` | enum | `traceability` 또는 `value`. 채널별 형식의 메시지 가설. 아래 조회 표 참조. |
| `spend_cents` | 음이 아닌 정수 USD 센트 | 미디어 비용만. 에이전시, 소재, 도구, 급여, 기타 획득 비용 없음. |
| `impressions` | 음이 아닌 정수 | 버킷의 획득 광고 노출. 고유 인원이나 빈도가 아님. |
| `clicks` | 음이 아닌 정수 | 이 버킷에 할당된 유료 클릭. 고유 방문자가 아님. |
| `landing_sessions` | 음이 아닌 정수 | 적격 유료 클릭 후 7일 내 관찰된 소스 태그 랜딩 세션. 합성 퍼널 여정당 유지된 세션은 최대 하나. |
| `quiz_starts` | 음이 아닌 정수 | 동일한 7일 기간 내 시작하는 고유한 유지 소스 태그 퀴즈 여정. 여정당 유지된 시작 하나. 완주율 분모. |
| `quiz_completions` | 음이 아닌 정수 | 동일한 7일 기간 내 완주한 유지 퀴즈 여정. 반복 완주 집계 없음. |
| `attributed_new_customers` | 음이 아닌 정수 | 7일 내 이 구성된 퀴즈 주도 퍼널을 완료한 첫 구매 고객. 선언된 마지막 유료 클릭 규칙에 따라 한 번 할당됨. 전체 사이트 신규 고객이 아님. |
| `attributed_first_purchase_revenue_cents` | 음이 아닌 정수 USD 센트 | 할인 후, 세금 및 배송 제외한 해당 고객의 첫 구매 매출. 이 픽스처에는 환불 없음. 갱신 매출 없음. 산술 명확성을 위해 생성기가 첫 구매 고객당 USD $80(8,000센트)를 할당함. 이는 재구성 가정이며 코스 가격이나 LTV가 아님. |
| `is_provisional` | boolean | `false`은 이 행의 7일 관찰 기간이 선언된 스냅샷에서 성숙함을 의미합니다. 지원되지 않는 문자열/boolean 강제 변환은 거부하십시오. |

행별 부등식: `impressions >= clicks >= landing_sessions >= quiz_starts >= quiz_completions >= attributed_new_customers`. 이는 명시적으로 단순화된 퀴즈 주도 퍼널 구성이며 광고 내보내기의 보편적 속성이 아닙니다. 고객 수가 0인 행은 첫 구매 매출도 0이어야 하고, 고객 수가 양수인 행은 매출도 양수여야 합니다. 이 제약은 개인 수준 증거를 제공하지 않습니다.

## 표준 조회 및 원시 정리

| 채널 | 표준 캠페인 ID | 표시 이름 | 허용 원시 캠페인 ID 별칭 |
|---|---|---|---|
| `google-search` | `gl-uk-google-search` | GreenLeaf UK Search | `gl_uk_search` → `gl-uk-google-search` |
| `linkedin` | `gl-uk-linkedin` | GreenLeaf UK LinkedIn | 없음 |
| `reddit-paid` | `gl-uk-reddit-paid` | GreenLeaf UK Reddit paid | 없음 |

오디언스 `skeptical`: 소싱/용량 증거를 비교하는 증거 추구형 구매자를 위한 구성 버킷. Oliver의 검증되지 않은 페르소나에서 영감을 받음. 오디언스 `exploring`: 카테고리를 탐색하고 가치를 고려하는 구매자를 위한 구성 버킷. 실제 타기팅 사양도 무작위 처치 배정도 아니며, 신원, 직업, 건강 상태를 추론하지 않습니다.

소재 `traceability`: 예시 “Know what is in every serving”(한 번 섭취하는 분량에 무엇이 들어 있는지 확인하세요) 메시지. 소재 `value`: 예시 “Compare the value of a clearly dosed serving”(함량이 명확한 한 번 섭취 분량의 가치를 비교하세요) 메시지. Google Search의 경우 텍스트 광고 메시지 가설, LinkedIn의 경우 스폰서 피드 문구 가설, Reddit paid의 경우 프로모션 게시물 문구 가설입니다. 소재 ID는 채널 내 공유 메시지 카테고리이지 동일한 완성 광고 자산이나 승인된 주장이 아닙니다. 효능 증명이나 실제 제품 인증은 제공되지 않습니다.

바이트 단위/동일 필드 정확 중복만 제거하고 소스 행 ID를 기록하십시오. 선언된 별칭만 정규화하고 개수를 기록하십시오. 알 수 없는 ID, 예상치 못한 시장, 누락된 필드, 잘못된 날짜, 정수가 아닌 센트/개수, 음수 값, 충돌하는 중복, 불가능한 퍼널은 조용히 수리하지 말고 검증을 실패해야 합니다. 이용 불가 비율 처리를 검증하기 위해 문서화된 분모 0 행을 보존하십시오. 원시/표준 개수와 모든 차원 합계를 조정하십시오. 픽스처 생성 기록은 정확 중복, 별칭 행, 분모 0 행을 식별해야 합니다. 이 사전은 해당 행이 이미 존재한다고 가정하지 않습니다.

## 지표 및 비교 규칙

선택한 코호트/차원 내에서 합산한 다음 나누십시오. 행 수준 비율을 평균 내지 마십시오. 전체 중간 정밀도를 유지하십시오. USD는 표시할 때만 센트를 100으로 나누어 표시하십시오. 분모가 0이면 **이용 불가**이며 0/무한대가 아닙니다. 0인 이전 값에 대한 퍼센트 변화는 이용 불가입니다.

| 지표 | 정의 | 해석 |
|---|---|---|
| 퀴즈 완주율 | `sum(quiz_completions) / sum(quiz_starts)` | 주요 퍼널 KPI. 유료 모바일 1/2주차는 45%/28%로 보정되어야 함. |
| 클릭 대 시작률 | `sum(quiz_starts) / sum(clicks)` | 진단용. 퀴즈 완주율과 구분됨. |
| 클릭 대 랜딩률 | `sum(landing_sessions) / sum(clicks)` | 진단용이며 검증된 이탈률이 아님. |
| 완주 대 구매율 | `sum(attributed_new_customers) / sum(quiz_completions)` | 구성된 퀴즈 주도 퍼널 진단. |
| CTR | `sum(clicks) / sum(impressions)` | 최적화 지표. 인지도가 아님. |
| CPC (USD) | `sum(spend_cents) / sum(clicks) / 100` | 클릭당 미디어 비용. |
| CPM (USD) | `sum(spend_cents) / sum(impressions) * 1000 / 100` | 노출 1,000회당 미디어 비용. |
| 미디어 CPA (USD) | `sum(spend_cents) / sum(attributed_new_customers) / 100` | 미디어 전용 프록시. 전체 CAC가 아님. |
| 기여된 첫 주문 ROAS | `sum(attributed_first_purchase_revenue_cents) / sum(spend_cents)` | 매출/지출 비율. 이익, 증분성, LTV가 아님. |
| 첫 구매 매출 (USD) | `sum(attributed_first_purchase_revenue_cents) / 100` | 유료 코호트 기여만. $60K 월 전체 목표에 대한 판정이 아님. |

비율의 퍼센트 포인트 변화는 `(Week 2 rate - Week 1 rate) * 100`입니다. 1주차 비율이 양수일 때 상대 변화는 `(Week 2 rate / Week 1 rate - 1) * 100`입니다. 작성된 45% → 28%는 −17퍼센트 포인트, 약 −37.8% 상대와 같습니다. 다른 어떤 결과도 이 소스 계약으로 미리 정해지지 않습니다.

모바일 집계 움직임을 진단하기 전에 모바일을 채널 × 오디언스 × 소재로 계층화하십시오. 계층 `s`의 경우 고정 가중치 `w_s = Week 1 starts_s / Week 1 total starts`을 설정하십시오. `sum(w_s * Week 1 completion_rate_s)`와 `sum(w_s * Week 2 completion_rate_s)`를 비교하고 둘 다 관찰된 비율과 비교하십시오. 가중치와 개수를 게시하십시오. 양수 가중치 계층에 정의된 2주차 비율이 없으면 전체 고정 혼합 비교는 이용 불가가 됩니다. 명시적으로 제한된 공통 계층 비교는 제외된 개수/가중치를 공개해야 하며 조용히 전체를 대신할 수 없습니다. 가중치 0 계층은 0을 기여하며 비율이 필요하지 않습니다. 혼합 변화와 그룹 내 움직임은 공존할 수 있습니다. 어느 것도 원인을 증명하지 않으며, 코호트는 무작위 배정되지 않았습니다.

불완전한 스냅샷이나 잠정 기본 행은 두 전체 기간을 미확정/비비교로 만듭니다. 관찰되지 않은 성과를 0으로 취급하지 마십시오. 동일한 성숙 커버리지로 별도로 선택한 비교는 선택한 날짜, 제외 항목, 변경된 질문을 명시해야 합니다.

## 이용 불가 증거 및 소스 충돌

이용 불가: 전체 CAC, 이익, 유지율, 실현 12개월 LTV, 인지도, 증분성, 실제 전 채널/월 매출, 빈도, 노출 점유율, 이탈률, 이벤트/릴리스 로그, 고객 인터뷰, 인과 설명. 소스 자산의 별도 4.2% “quiz CVR”는 여기에 적절한 공유 분모 정의가 없으므로 가져오지 마십시오. 어떤 스크린샷의 손실 추정, 세그먼트 배수, 예산 지시, 유기적-유료 인과 이야기도 도출된 픽스처 결과가 아닙니다. 코스 사실과 새로 작성된 가정의 구분은 소스 맵을 참조하십시오.