# GreenLeafレポーティングデータ辞書 — v1 意味論的契約

**作成日:** 2026-10-29 · **ステータス:** フィクスチャ生成前の凍結されたソース仕様。英語の編集入力。CSVは、回復されたコースデータではなく、新たに合成された再構成です。[概要](brief-v1.md)が意思決定を統治し、[ソースマップ](course-source-map.json)が出所を統治します。実在の顧客、健康情報、クライアントアカウントは含まれていません。 証拠として転載した数値は、英語の根拠資料の表記を保ちます。桁区切りはカンマ、小数点はピリオド、金額の通貨はUSDです。画面上の要約指標は、選択した言語・地域に合わせた表記になる場合があります。

## 粒度、ウィンドウ、帰属

1つの正規行は、英国における1つのUTC有料クリック日 × チャネル × デバイス × オーディエンス × クリエイティブです。14日 × 3チャネル × 2デバイス × 2オーディエンス × 2クリエイティブ = **336行**。生エクスポートには**337行**があり、1つの完全重複を含みます。キャンペーンはチャネルに属し、ディメンションを追加しません。

第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日以内の最後の適格有料クリックに一度だけ割り当てられます。すべてのイベント段階はこの同じ排他的割り当てに従います。クロスデバイスのID調整は測定されません。排他性は構築によって保証されており、この集計ファイルによって独立して確立されたものではありません。

## フィールド

| フィールド | タイプ / 単位 | 意味と検証 |
|---|---|---|
| `row_id` | 空でない文字列 | 安定した一意の正規行ID。生の完全重複はそれを繰り返します。同じIDを持つ競合する行はエラーです。 |
| `date` | ISO `YYYY-MM-DD` | UTCソース有料クリックコホート日。9月1日–14日内。 |
| `market` | 列挙型 | `UK`のみ。範囲は架空の英国立ち上げにおける有料コホートです。 |
| `channel` | 列挙型 | `google-search`、`linkedin`、`reddit-paid`。オーガニックRedditアクティビティは除外されます。 |
| `campaign_id` | 正規化後の列挙型 | チャネルごとに1つのキャンペーン。以下を参照。 |
| `device` | 列挙型 | `mobile`または`desktop`。割り当てられたソース有料クリックのデバイス。 |
| `audience_id` | 列挙型 | `skeptical`または`exploring`。チャネル内の相互排他的な構築されたバケット。検証済みの顧客特性ではありません。 |
| `creative_id` | 列挙型 | `traceability`または`value`。チャネル固有の形式を持つメッセージ仮説。以下を参照。 |
| `spend_cents` | 非負の整数USDセント | メディアコストのみ。代理店、クリエイティブ、ツール、給与、その他の獲得コストは含まれません。 |
| `impressions` | 非負の整数 | バケット内の獲得広告インプレッション。ユニークな人物やフリークエンシーではありません。 |
| `clicks` | 非負の整数 | このバケットに割り当てられた有料クリック。ユニーク訪問者ではありません。 |
| `landing_sessions` | 非負の整数 | 適格な有料クリック後7日以内に観察されたソースタグ付きランディングセッション。合成ファネルジャーニーごとに最大1つの保持セッション。 |
| `quiz_starts` | 非負の整数 | 同じ7日間のウィンドウ内に開始する、保持されたソースタグ付きクイズジャーニーの個別数。ジャーニーごとに1つの保持された開始。完了率の分母。 |
| `quiz_completions` | 非負の整数 | 同じ7日間のウィンドウ内に完了した、保持されたクイズジャーニー。繰り返しの完了カウントはありません。 |
| `attributed_new_customers` | 非負の整数 | 7日以内にこの構築されたクイズ主導ファネルを完了する初回購入顧客。宣言された最後の有料クリックルールによって一度だけ割り当てられます。全サイトの新規顧客ではありません。 |
| `attributed_first_purchase_revenue_cents` | 非負の整数USDセント | それらの顧客からの初回購入収益。割引後、税金と送料を除く。このフィクスチャには返金はありません。更新収益はありません。ジェネレーターは、算術的な明確さのために初回購入顧客ごとにUSD $80（8,000セント）を割り当てます。これは再構成の前提であり、コースの価格設定やLTVではありません。 |
| `is_provisional` | ブール値 | `false`は、この行の7日間の観察ウィンドウが宣言されたスナップショットで成熟していることを意味します。サポートされていない文字列/ブール値の強制変換は拒否します。 |

行ごとの不等式：`impressions >= clicks >= landing_sessions >= quiz_starts >= quiz_completions >= attributed_new_customers`。これは、明示的に簡略化されたクイズ主導ファネルの構築であり、広告エクスポートの普遍的な特性ではありません。顧客がゼロの行は、初回購入収益もゼロでなければなりません。正の顧客数は正の収益でなければなりません。これらの制約は個人レベルの証拠を提供しません。

## 正規ルックアップと生データのクリーンアップ

| チャネル | 正規キャンペーン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検索の場合、これらはテキスト広告のメッセージ仮説です。LinkedInの場合、スポンサードフィードのコピー仮説です。Reddit有料の場合、プロモート投稿のコピー仮説です。クリエイティブIDは、各チャネル内の共有メッセージカテゴリであり、同一の完成広告アセットや承認されたクレームではありません。有効性の証明や実際の製品認証は提供されていません。

バイト単位/等しいフィールドの完全重複のみを削除し、そのソース行IDを記録します。宣言されたエイリアスのみを正規化し、カウントを記録します。不明なID、予期しない市場、欠落フィールド、不正な日付、非整数のセント/カウント、負の値、競合する重複、不可能なファネルは、黙って修復せずに検証に失敗する必要があります。利用不可の比率の処理を検証するために、文書化されたゼロ分母行を保持します。生/正規カウントとすべてのディメンション合計を調整します。フィクスチャ生成記録は、完全重複、エイリアス行、ゼロ分母行を特定する必要があります。この辞書は、それらの行がすでに存在すると偽装しません。

## メトリクスと比較ルール

選択したコホート/ディメンション内で合計してから除算します。行レベルのレートを平均しないでください。完全な中間精度を保持します。USDは、プレゼンテーション時にのみセントを100で除算して表示します。分母がゼロの場合は**利用不可**となり、ゼロ/無限大にはなりません。ゼロの前値に対するパーセント変化は利用不可です。

| メトリクス | 定義 | 解釈 |
|---|---|---|
| クイズ完了率 | `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週のレートがない正のウェイトの層は、完全な固定ミックス比較を利用不可にします。明示的に制限された共通層の比較は、除外されたカウント/ウェイトを開示する必要があり、全体の代わりに黙って使用することはできません。ゼロウェイトの層はゼロを寄与し、レートを必要としません。ミックスの変化とグループ内の動きは共存する可能性があります。どちらも原因を証明しません。コホートはランダム化されていません。

不完全なスナップショットまたは暫定的なプライマリ行は、2つの完全な期間を未確定/比較不能にします。未観測の結果をゼロとして扱わないでください。同一の成熟カバレッジを持つ別途選択された比較は、選択された日付、除外、変更された質問を明記する必要があります。

## 利用不可の証拠とソースの競合

利用不可：完全なCAC、利益、リテンション、実現した12か月のLTV、認知度、インクリメンタリティ、真の全チャネル/月次収益、フリークエンシー、インプレッションシェア、直帰率、イベント/リリースログ、顧客インタビュー、因果的説明。ソース資産の別個の4.2%“quiz CVR”は、ここでは適切な共有分母定義がありません。それをインポートしないでください。スクリーンショットの損失見積もり、セグメント倍率、予算指示、オーガニックから有料への因果的ストーリーは、導出されたフィクスチャの結果ではありません。コースの事実と新たに作成された前提については、ソースマップを参照してください。