# Từ điển dữ liệu báo cáo GreenLeaf — hợp đồng ngữ nghĩa v1

**Người soạn:** 2026-10-29 · **Trạng thái:** đặc tả nguồn đã đóng băng trước khi tạo dữ liệu mẫu; dữ liệu biên tập tiếng Anh. CSV là một bản tái lập tổng hợp mới, không phải dữ liệu khóa học khôi phục. [Bản tóm tắt](brief-v1.md) chi phối các quyết định; [sơ đồ nguồn](course-source-map.json) chi phối nguồn gốc. Không có khách hàng thật, thông tin sức khỏe hay tài khoản khách hàng nào được đưa vào.

## Đơn vị, cửa sổ và quy cho

Một dòng chuẩn là một ngày nhấp chuột trả phí UTC × kênh × thiết bị × khán giả × sáng tạo, tại Anh. Mười bốn ngày × ba kênh × hai thiết bị × hai khán giả × hai sáng tạo = **336 dòng**. Dữ liệu xuất thô có **337 dòng**, gồm một bản trùng lặp chính xác. Chiến dịch thuộc về kênh và không thêm một chiều nào.

Tuần 1: `2026-09-01`–`2026-09-07` bao gồm. Tuần 2: `2026-09-08`–`2026-09-14` bao gồm. Ảnh chụp: **`2026-09-22T23:59:59Z`**. Các ngày là UTC và `date` luôn nghĩa là ngày nhóm nhấp chuột trả phí, không bao giờ là ngày mua/sự kiện. Sự kiện phễu và lần mua đầu được quan sát trong bảy ngày sau lượt nhấp trả phí đủ điều kiện. Dấu thời gian sự kiện chính xác không được xuất; cửa sổ quy cho/quan sát bảy ngày là một giả định xây dựng của bộ tạo. Cả hai kỳ hoàn chỉnh đã trưởng thành tại thời điểm ảnh chụp. Mọi dòng chính được xuất bản đều có `is_provisional=false`.

Chi tiêu, lượt hiển thị và lượt nhấp mô tả hoạt động thu hút được gán cho ngày nhóm đó. Số lượt trang đích, quiz và mua theo nhóm nhấp chuột trả phí được gắn thẻ nguồn và nhóm thiết bị/khán giả/sáng tạo của nó. Mỗi khách hàng lần mua đầu tổng hợp và số tiền doanh thu được gán một lần, cho lượt nhấp trả phí đủ điều kiện cuối cùng trong vòng bảy ngày; mọi giai đoạn sự kiện đều theo cùng quy tắc gán độc quyền này. Đối chiếu danh tính xuyên thiết bị không được đo. Tính độc quyền được đảm bảo bởi cấu trúc, không được xác lập độc lập bởi tệp tổng hợp này.

## Các trường

| Trường | Loại / đơn vị | Ý nghĩa và xác thực |
|---|---|---|
| `row_id` | chuỗi không rỗng | ID dòng chuẩn duy nhất ổn định. Bản trùng lặp chính xác thô lặp lại nó; các dòng xung đột có cùng ID là lỗi. |
| `date` | ISO `YYYY-MM-DD` | Ngày nhóm nhấp chuột trả phí nguồn UTC, trong tháng 9 1–14. |
| `market` | enum | Chỉ `UK`; phạm vi là các nhóm trả phí trong đợt ra mắt Anh hư cấu. |
| `channel` | enum | `google-search`, `linkedin`, `reddit-paid`. Hoạt động Reddit tự nhiên bị loại trừ. |
| `campaign_id` | enum sau chuẩn hóa | Một chiến dịch mỗi kênh; tra cứu bên dưới. |
| `device` | enum | `mobile` hoặc `desktop`, thiết bị của lượt nhấp trả phí nguồn được gán. |
| `audience_id` | enum | `skeptical` hoặc `exploring`; các nhóm xây dựng loại trừ lẫn nhau trong kênh, không phải đặc điểm khách hàng đã xác thực. |
| `creative_id` | enum | `traceability` hoặc `value`; giả thuyết thông điệp với định dạng riêng theo kênh, tra cứu bên dưới. |
| `spend_cents` | số nguyên không âm USD cents | Chỉ chi phí truyền thông. Không có chi phí agency, sáng tạo, công cụ, lương hay chi phí thu hút nào khác. |
| `impressions` | số nguyên không âm | Lượt hiển thị quảng cáo thu hút trong nhóm; không phải người duy nhất hay tần suất. |
| `clicks` | số nguyên không âm | Lượt nhấp trả phí được gán cho nhóm này; không phải khách truy cập duy nhất. |
| `landing_sessions` | số nguyên không âm | Phiên trang đích được gắn thẻ nguồn quan sát được trong bảy ngày kể từ lượt nhấp trả phí đủ điều kiện. Tối đa một phiên giữ lại cho mỗi hành trình phễu tổng hợp. |
| `quiz_starts` | số nguyên không âm | Hành trình quiz được gắn thẻ nguồn giữ lại riêng biệt bắt đầu trong cùng cửa sổ bảy ngày; một lượt bắt đầu giữ lại cho mỗi hành trình. Mẫu số của tỷ lệ hoàn thành. |
| `quiz_completions` | số nguyên không âm | Những hành trình quiz giữ lại đó hoàn thành trong cùng cửa sổ bảy ngày; không tính lặp lại lượt hoàn thành. |
| `attributed_new_customers` | số nguyên không âm | Khách hàng lần mua đầu hoàn thành phễu dẫn dắt bởi quiz đã xây dựng này trong vòng bảy ngày, được gán một lần theo quy tắc lượt nhấp trả phí cuối đã khai báo. Không phải toàn bộ khách hàng mới toàn trang. |
| `attributed_first_purchase_revenue_cents` | số nguyên không âm USD cents | Doanh thu lần mua đầu từ những khách hàng đó, sau chiết khấu, chưa tính thuế và phí vận chuyển. Không có hoàn tiền trong bộ dữ liệu này; không có doanh thu gia hạn. Bộ tạo gán USD $80 (8,000 cents) cho mỗi khách hàng lần mua đầu để rõ ràng về số học; đây là giả định tái lập, không phải giá khóa học hay LTV. |
| `is_provisional` | boolean | `false` nghĩa là cửa sổ quan sát bảy ngày của dòng này đã trưởng thành tại ảnh chụp đã khai báo. Từ chối ép kiểu chuỗi/boolean thiếu căn cứ. |

Bất đẳng thức theo dòng: `impressions >= clicks >= landing_sessions >= quiz_starts >= quiz_completions >= attributed_new_customers`. Đây là cấu trúc phễu dẫn dắt bởi quiz đơn giản hóa rõ ràng, không phải thuộc tính phổ quát của dữ liệu xuất quảng cáo. Dòng có không khách hàng phải có doanh thu lần mua đầu bằng không; số khách hàng dương phải có doanh thu dương. Những ràng buộc này không cung cấp bằng chứng cấp cá nhân.

## Tra cứu chuẩn và làm sạch dữ liệu thô

| Kênh | ID chiến dịch chuẩn | Tên hiển thị | Bí danh ID chiến dịch thô được phép |
|---|---|---|---|
| `google-search` | `gl-uk-google-search` | GreenLeaf UK Search | `gl_uk_search` → `gl-uk-google-search` |
| `linkedin` | `gl-uk-linkedin` | GreenLeaf UK LinkedIn | Không |
| `reddit-paid` | `gl-uk-reddit-paid` | GreenLeaf UK Reddit paid | Không |

Khán giả `skeptical`: nhóm xây dựng cho người mua tìm kiếm bằng chứng, so sánh bằng chứng nguồn gốc/liều lượng; lấy cảm hứng từ chân dung chưa xác thực của Oliver. Khán giả `exploring`: nhóm xây dựng cho người mua khám phá danh mục và cân nhắc giá trị. Chúng không phải đặc tả nhắm mục tiêu thật hay phân công xử lý ngẫu nhiên; không suy ra danh tính, nghề nghiệp hay tình trạng sức khỏe.

Sáng tạo `traceability`: thông điệp minh họa “Know what is in every serving” (Biết rõ thành phần trong mỗi khẩu phần). Sáng tạo `value`: thông điệp minh họa “Compare the value of a clearly dosed serving” (So sánh giá trị của mỗi khẩu phần có liều lượng rõ ràng). Đối với Google Search, đây là giả thuyết thông điệp quảng cáo văn bản; đối với LinkedIn, giả thuyết nội dung quảng cáo trên bảng tin; đối với Reddit paid, giả thuyết nội dung bài đăng được quảng bá. Các ID sáng tạo là danh mục thông điệp dùng chung trong mỗi kênh, không phải tài sản quảng cáo hoàn chỉnh giống hệt hay tuyên bố được phê duyệt. Không có bằng chứng hiệu quả hay chứng nhận sản phẩm thực tế nào được cung cấp.

Chỉ loại bỏ một bản trùng lặp chính xác từng byte/từng trường bằng nhau, ghi lại ID dòng nguồn của nó. Chỉ chuẩn hóa bí danh đã khai báo và ghi lại số lượng. Một ID không xác định, thị trường bất ngờ, trường thiếu, ngày sai định dạng, cents/số đếm không nguyên, giá trị âm, trùng lặp xung đột hay phễu bất khả thi phải khiến xác thực thất bại thay vì được sửa im lặng. Giữ lại một dòng mẫu số bằng không có tài liệu để xác minh xử lý tỷ lệ không khả dụng. Đối chiếu số lượng thô/chuẩn và mọi tổng chiều. Hồ sơ tạo dữ liệu mẫu phải xác định bản trùng lặp chính xác, dòng bí danh và dòng mẫu số bằng không; từ điển này không giả vờ những dòng đó đã tồn tại.

## Quy tắc số liệu và so sánh

Dùng tổng trong nhóm/chiều đã chọn, sau đó chia; không bao giờ lấy trung bình tỷ lệ cấp dòng. Giữ đầy đủ độ chính xác trung gian. Hiển thị USD bằng cách chia cents cho 100 chỉ ở bước trình bày. Mẫu số bằng không cho kết quả **không khả dụng**, không bao giờ bằng không/vô cực; phần trăm thay đổi so với giá trị trước bằng không là không khả dụng. Các số liệu trích từ bằng chứng gốc tiếng Anh giữ quy ước của nguồn: dấu phẩy phân cách hàng nghìn, dấu chấm phân cách phần thập phân; mọi giá trị tiền tệ đều tính bằng USD.

| Số liệu | Định nghĩa | Diễn giải |
|---|---|---|
| Tỷ lệ hoàn thành quiz | `sum(quiz_completions) / sum(quiz_starts)` | KPI phễu chính; di động trả phí Tuần 1/2 phải được hiệu chuẩn thành 45%/28%. |
| Tỷ lệ nhấp-đến-bắt đầu | `sum(quiz_starts) / sum(clicks)` | Chẩn đoán; khác với tỷ lệ hoàn thành quiz. |
| Tỷ lệ nhấp-đến-trang đích | `sum(landing_sessions) / sum(clicks)` | Chẩn đoán, không phải tỷ lệ thoát đã xác minh. |
| Tỷ lệ hoàn thành-đến-mua | `sum(attributed_new_customers) / sum(quiz_completions)` | Chẩn đoán phễu dẫn dắt bởi quiz đã xây dựng. |
| CTR | `sum(clicks) / sum(impressions)` | Số liệu tối ưu hóa; không phải nhận biết. |
| CPC (USD) | `sum(spend_cents) / sum(clicks) / 100` | Chi phí truyền thông mỗi lượt nhấp. |
| CPM (USD) | `sum(spend_cents) / sum(impressions) * 1000 / 100` | Chi phí truyền thông mỗi 1,000 lượt hiển thị. |
| CPA truyền thông (USD) | `sum(spend_cents) / sum(attributed_new_customers) / 100` | Đại diện chỉ tính truyền thông; không phải CAC đầy đủ. |
| ROAS đơn hàng đầu được quy cho | `sum(attributed_first_purchase_revenue_cents) / sum(spend_cents)` | Tỷ lệ doanh thu/chi tiêu; không phải lợi nhuận, mức tăng thêm hay LTV. |
| Doanh thu lần mua đầu (USD) | `sum(attributed_first_purchase_revenue_cents) / 100` | Chỉ quy cho nhóm trả phí; không phải phán quyết so với mục tiêu $60K trọn tháng. |

Thay đổi điểm phần trăm của một tỷ lệ là `(Week 2 rate - Week 1 rate) * 100`. Thay đổi tương đối là `(Week 2 rate / Week 1 rate - 1) * 100` khi Tuần 1 dương. Kết quả được tạo ra 45% → 28% bằng −17 điểm phần trăm và khoảng −37.8% tương đối; không có kết quả nào khác được định trước bởi hợp đồng nguồn này.

Trước khi chẩn đoán biến động tổng di động, phân tầng di động theo kênh × khán giả × sáng tạo. Đối với tầng `s`, đặt trọng số cố định `w_s = Week 1 starts_s / Week 1 total starts`. So sánh `sum(w_s * Week 1 completion_rate_s)` với `sum(w_s * Week 2 completion_rate_s)` và so sánh cả hai với tỷ lệ quan sát được. Công bố trọng số và số lượng. Một tầng có trọng số dương không có tỷ lệ Tuần 2 xác định khiến toàn bộ so sánh cơ cấu cố định không khả dụng; bất kỳ so sánh tầng chung bị hạn chế rõ ràng nào phải công bố số lượng/trọng số bị loại trừ và không thể âm thầm thay thế cho tổng thể. Một tầng có trọng số bằng không đóng góp bằng không và không cần tỷ lệ. Biến động cơ cấu và biến động trong tầng có thể cùng tồn tại. Không điều nào chứng minh nguyên nhân; các nhóm không được ngẫu nhiên hóa.

Ảnh chụp không hoàn chỉnh hoặc dòng chính tạm thời khiến hai kỳ đầy đủ chưa ổn định/không thể so sánh. Đừng xử lý kết quả chưa quan sát là bằng không. Một so sánh được chọn riêng với phạm vi trưởng thành giống hệt phải nêu rõ ngày được chọn, loại trừ và câu hỏi đã thay đổi.

## Bằng chứng không khả dụng và xung đột nguồn

Không khả dụng: CAC đầy đủ, lợi nhuận, giữ chân, LTV 12 tháng thực tế, nhận biết, mức tăng thêm, doanh thu toàn kênh/tháng thật, tần suất, thị phần hiển thị, tỷ lệ thoát, nhật ký sự kiện/phiên bản, phỏng vấn khách hàng và giải thích nhân quả. Tài sản nguồn riêng có 4.2% “quiz CVR” không có định nghĩa mẫu số dùng chung đầy đủ tại đây; đừng nhập nó. Không có ước tính tổn thất, bội số phân khúc, chỉ dẫn ngân sách hay câu chuyện nhân quả tự nhiên-sang-trả phí nào trong ảnh chụp màn hình là kết quả suy ra từ dữ liệu mẫu. Xem sơ đồ nguồn để phân biệt dữ kiện khóa học so với giả định mới được tạo ra.