CID 投流追踪技能

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

核心功能

✅ Click ID 生成

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

✅ 转化回传

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

✅ ROI 分析

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

✅ 数据看板

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

✅ 异常监控

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

支持平台

快速开始

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/cidgenerator.py --platform oceanengine --campaignid 12345

3. 获取广告数据

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

4. 生成 Excel 报表

bash
python scripts/reportgenerator.py --output dailyreport.xlsx --date 2026-03-21

5. 监控异常

bash
python scripts/anomaly_detector.py --threshold 1.5

脚本说明

Excel 报表结构

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

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

故障排查

参考资料

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