cid-tracking（CID 追踪）

CID 投流追踪技能

专为国内二类电商设计的 CID（Click ID）投流追踪技能，支持抖音巨量引擎、快手磁力引擎、腾讯广点通三大广告平台。

核心功能

✅ Click ID 生成

• 为每次广告点击生成唯一标识符
• 支持批量生成和单个生成
• CID 格式符合各平台规范

✅ 转化回传

• 订单数据回传到广告平台
• 支持自定义转化事件
• 回传状态追踪和重试机制

✅ ROI 分析

• 多平台数据聚合分析
• 实时计算投入产出比
• 按计划/创意/时段维度拆解

✅ 数据看板

• 日报/周报自动生成
• 关键指标可视化
• 趋势分析和对比

✅ 异常监控

• 消耗异常预警
• 转化率波动检测
• 低 ROI 计划自动标记

支持平台

快速开始

1. 配置 API 凭证

在 config.json 中配置各平台凭证：

{
  "oceanengine": {
    "app_id": "你的应用 ID",
    "access_token": "访问令牌"
  },
  "kuaishou": {
    "app_id": "你的应用 ID",
    "access_token": "访问令牌"
  },
  "tencent": {
    "account_id": "账户 ID",
    "secret_key": "密钥"
  }
}

2. 生成 CID 追踪链接

python scripts/cid_generator.py --platform oceanengine --campaign_id 12345

3. 获取广告数据

python scripts/data_fetcher.py --platform all --date yesterday

4. 生成 Excel 报表

python scripts/report_generator.py --output daily_report.xlsx --date 2026-03-21

5. 监控异常

python scripts/anomaly_detector.py --threshold 1.5

脚本说明

Excel 报表结构

生成的报表包含以下工作表：

1. 汇总看板 - 核心指标总览
2. 分平台数据 - 各平台详细数据
3. 计划明细 - 广告计划级别数据
4. 异常监控 - 异常计划列表
5. 趋势图表 - 消耗/转化趋势图

依赖

pip install openpyxl pandas requests matplotlib

使用示例

示例 1：生成日报

python scripts/report_generator.py \
  --output reports/daily_20260321.xlsx \
  --date 2026-03-21 \
  --platforms oceanengine,kuaishou,tencent

示例 2：回传转化

python scripts/conversion_tracker.py \
  --platform oceanengine \
  --event purchase \
  --cid CID123456 \
  --value 299.00

示例 3：检测异常

python scripts/anomaly_detector.py \
  --min-roi 1.5 \
  --max-cpa 100 \
  --notify wechat

注意事项

1. API 限流 - 各平台有调用频率限制，建议设置合理的请求间隔
2. 数据延迟 - 广告平台数据通常有 2-4 小时延迟
3. CID 有效期 - 生成的 CID 链接通常 30 天有效
4. 转化归因 - 默认 7 天点击归因窗口

故障排查

参考资料

• 巨量引擎 API 文档
• 磁力引擎 API 文档
• 广点通 API 文档
• CID 追踪最佳实践