用途
Campaign Ledger 解决的是营销归因中最基础也最容易被忽视的问题：大多数公司能告诉你每个活动带来了多少点击，也能告诉你每个客户贡献了多少收入，但很少能把两者连起来。该工具为每个营销活动分配一个唯一 ID，要求这个 ID 出现在所有相关资产的名称中，并维护一张统一台账表，从而让智能体能够回答“哪些营销带来了付费且留存的客户”。
主要能力
- ID 分配与命名规范：为每个活动分配形如
<PREFIX><NNN>的 ID（如 BK014），并规定广告名称、广告组、平台活动、UTM、邮件主题、CRM 交易记录中 ID 的放置格式。 - 命名审计：检查各平台资产是否符合命名约定，报告有效 ID 花费占比、缺失 UTM 的资产、平台上存在但台账中没有的 ID 等。
- 数据同步：按 ID 刷新各平台的花费、展示、点击，以及线索、合格通话、成交、收入和流失数据，并标注归因置信度（高/中/低）。
- 活动文件夹管理：为每个 ID 创建规范的活动文件夹，包含客户原话、报价、受众、证据门槛、UTM 基础、各智能体输出等分区。
- 证据门槛：在启动前要求设定最低花费、最低天数、最低展示、CTR 下限、CPL 上限和胜利指标，避免产生大量无结论的实验。
使用方式
该工具通过 Claude Code 的斜杠命令使用：
/campaign-ledger init— 选择前缀，审计当前命名，创建台账/campaign-ledger new "dinner angle"— 分配下一个 ID 并创建活动文件夹/campaign-ledger audit— 查找违反命名约定的资产/campaign-ledger sync— 按 ID 刷新花费和结果（每日）/campaign-ledger show BK014— 查看单个活动的端到端数据
使用前需要 Cogny（$9/月）的 MCP 网关。若没有 mcp__cogny__* 工具，需先在 https://cogny.com 注册并连接广告平台，然后在项目的 .mcp.json 中添加：
{"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
重启 Claude Code 后，首次使用会打开浏览器进行 OAuth 登录。没有 Cogny 时无法运行，但命名约定仍可手动使用。
命名约定
- 活动 ID：
<PREFIX><NNN>，如BK014 - 广告名称：
<ID>_<angle>_<format>_v<n>，如BK014_dinner-angle_ugc_v2 - 广告组：
<ID>_<audience>，如BK014_shopify-1to10m - 平台活动：
<ID>_<objective>_<short-name>，如BK014_leads_profit-review - UTM：
utm_campaign=<id-lowercase>_<slug>&utm_content=<angle>_<format>_v<n> - 邮件/新闻：
<ID> — <subject idea> - CRM 交易：备注或属性
campaign_id: BK014
格式 slug 共享列表：pain、worked-example、story、founder、comparison、myth、demo、objection、customer-words、question、static、carousel、ugc、short-video。
审计使用的正则：广告为 ^([A-Z]{2,4}\d{3})_([a-z0-9-]+)_([a-z0-9-]+)_v\d+$，其他为 ^([A-Z]{2,4}\d{3})_。
适用场景
- 需要跨多个广告平台统一追踪营销活动效果
- 希望将广告花费与 CRM 中的成交、收入、流失数据关联
- 需要规范团队命名习惯，避免“video_final_7 won”这类无意义记录
- 使用 Claude Code 进行营销工程化管理的团队
限制
- 依赖 Cogny（$9/月）的 MCP 网关，无 Cogny 时无法运行数据同步和审计功能
- 部分平台（Google/Bing 响应式搜索广告、Apple Search Ads、X 推广推文）没有广告名称字段，ID 只能放在活动和广告组/行项目上
- 归因置信度分为高、中、低，不同置信度不能混用而不标注
- 不能直接重命名或编辑平台资产，只能提出重命名映射工单
- 每个新活动必须经过
new命令分配 ID，无 ID 不得启动 - 同步时各平台保持各自货币，转换时需说明汇率
- 可选 BigQuery 功能仅 Cloud 版可用，Solo 版没有 BigQuery 或脚本