CID 投流追踪技能#

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

核心功能#

✅ Click ID 生成#

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

✅ 转化回传#

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

✅ ROI 分析#

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

✅ 数据看板#

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

✅ 异常监控#

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

支持平台#

平台API 文档状态抖音巨量引擎https://oceanengine.github.io/open-platform/✅快手磁力引擎https://mp.weixin.qq.com/✅腾讯广点通https://e.qq.com/dev/✅

快速开始#

1. 配置 API 凭证#

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

json

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

2. 生成 CID 追踪链接#

bash

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

3. 获取广告数据#

bash

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

4. 生成 Excel 报表#

bash

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

5. 监控异常#

bash

python scripts/anomaly_detector.py --threshold 1.5

脚本说明#

脚本功能输入输出cid_generator.py生成 CID 追踪链接广告计划 ID追踪 URL 列表data_fetcher.py获取各平台广告数据平台、日期范围JSON 数据conversion_tracker.py转化数据回传订单数据回传结果roi_analyzer.pyROI 分析计算消耗 + 转化数据分析结果report_generator.py生成 Excel 报表聚合数据.xlsx 文件anomaly_detector.py异常检测预警历史数据预警列表

Excel 报表结构#

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

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

依赖#

bash

pip install openpyxl pandas requests matplotlib

使用示例#

示例 1：生成日报#

bash

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

示例 2：回传转化#

bash

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

示例 3：检测异常#

bash

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 调用失败凭证过期刷新 access_token数据为空日期范围无数据检查日期参数Excel 生成失败依赖缺失pip install -r requirements.txtCID 无效格式错误检查平台 CID 规范

参考资料#

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