Jiayi Ads Analytics Expert Public

全媒体广告分析专家（公共版）

When to use

当用户提出以下意图时触发：

• "帮我出日报" / "看看昨天投放数据" / "广告日报"
• "看下今天/昨天的展点消" / "各渠道数据怎么样"
• "投放分析" / "每日投放复盘"
• 任何涉及多平台广告数据汇总分析的请求

首次使用检查（Onboarding）

每次执行日报前，先检查环境是否就绪：

1. 检查 ~/.workbuddy/mcp.json 中是否有对应平台的MCP配置
2. 对每个已配置的MCP，调用验证接口确认token有效
3. 如果某平台未配置或token失效，引导用户完成配置/刷新
4. 通过MCP的list_accounts/get_account_info等接口动态获取用户账户列表
5. 不硬编码任何账户ID——所有账户信息从API运行时获取

报告结构

Sheet 1：投放总览 & Highlight

1.1 核心指标大盘

• 全渠道日总消费 / 总展现 / 总点击 / 总转化 / 总 CPA
• 日环比（与前一天对比，标注↑↓和百分比变化）
• 周同比（与上周同天对比）

1.2 分类汇总

1.3 Highlight 总结（3-5条，一句话+数据）

🟢 好的：[结论] — [数据支撑]
🔴 差的：[问题] — [数据] — [影响]
🟡 关注：[观察点] — [数据]

1.4 现状与问题诊断（2-4条核心问题，每条含数据证据和影响评估）

1.5 历史问题追踪（从ad-report-tracker.json读取，展示到期/过期/已解决事项）

• 🔴 已过期未解决 → 升级为P0
• 🟡 今日到期 → 用当日数据给出结论
• 🟢 观察中 → 简要标注当前状态
• ✅ 近3天已解决 → 一行带过

1.6 今日 TODO（3-5条，按优先级排列，含追踪到期升级的P0）

P0（立即处理）：[具体操作] — [原因] — [预期效果]
P1（今日完成）：...
P2（本周跟进）：...

Sheet 2：搜索广告 (SEM) 明细

结构原则：总→分（先全渠道汇总→再按渠道分账户→每个账户按统一维度展开），每个渠道的分析维度必须一致。

SEM完整分析维度（缺一不可）：

• 账户×出价方式维度
• 词性维度（品牌/通用/场景/竞品）
• 计划明细
• 关键词明细（含匹配模式分析）
• 创意效果维度（标题/描述的CTR对比）
• Highlight + 问题 + TODO（具体到词+创意+匹配+出价）

2.1 SEM全渠道汇总表

注：以上账户为示例占位符，实际运行时通过MCP/API动态获取用户已配置的账户列表。

重要：转化数据获取规则

• 百度：所有账户（含CPC）都有转化数据（ocpcConversionsDetail25+3）
• 360 CPC：从 /dianjing/report/keyword 的 converts 字段获取（CPC账户也能看转化！）
• 360 OCPC：从 /dianjing/report/Ocpc 获取
• Google/Bing/搜狗：API直接返回 conversions

2.2 分词性汇总（跨渠道统一维度）

将所有渠道的计划按词性分类（品牌词/通用词/场景词/竞品词），横向对比：

2.3 各渠道计划明细（统一格式，按渠道分块展示）

每个渠道一个子表格，列固定为：

标记规则：🟢CPA<均值且有量 / 🔴CPA>均值2倍或零转化 / 🟡待观察

按消费降序排列，每渠道Top10。

2.4 关键词/检索词 Top20（跨渠道合并排序）

将所有渠道的关键词按消费合并排序：

操作建议列必须具体到操作层面（不能空泛），例如：

• "暂停（¥1,154花费仅0.5转化）"
• "出价+20%（CPA远低于均值，放量空间大）"
• "改精确匹配（当前智能匹配CTR仅1.4%）"
• "加否词'免费'（检索词分析发现大量无效流量）"

2.5 创意效果分析

创意数据获取方式（已验证可用）：

• 百度：reportType=12, levelOfDetails=7（返回name数组: [账户,计划,单元,标题,描述1,描述2]）
• Google：GAQL查 ad_group_ad 资源，含 ad_group_ad.ad.responsive_search_ad.headlines + metrics
• 360：POST /dianjing/report/creative（form-urlencoded，返回 title/clicks/views/totalCost 等）
• Bing：MCP get_ads(ad_group_id) 逐广告组查

按渠道展示创意标题/描述的效果对比（同计划内不同创意的CTR、转化率差异）：

分析维度：

• 同计划内多条创意的CTR对比：哪条标题吸引点击更多
• 转化率差异：CTR高不代表转化好，要看点击后的转化率
• 创意方向归类：功能卖点型 vs 场景痛点型 vs 数据佐证型 vs 竞品对比型
• 建议：具体到"XX计划的创意A(CTR 5.2%)优于创意B(CTR 2.1%)，建议暂停B保留A，新增C方向测试"

2.6 匹配模式效率分析

给出匹配模式优化建议：哪些词应从智能改精确（流量大但转化差），哪些词可从精确改短语（量太小需放量）。

2.7 SEM Highlight & 问题诊断 & TODO

━━━ 🟢 表现好的（继续保持/加量）━━━
具体到：[渠道]-[账户]-[计划]-[关键词]-[匹配模式]-[创意方向] → 数据 → 建议操作
例：百度「品牌词X」精确匹配 CPA低/日转化高 → 建议出价+15%争取更多展现份额
例：Google「品牌词X」精确匹配 创意"XXX" CTR高 → 优质创意,其他计划可复用此标题方向

━━━ 🔴 表现差的（需立即处理）━━━
具体到：[渠道]-[账户]-[计划]-[关键词/创意] → 数据 → 具体操作
例：Google「竞品词Y」短语匹配 消费高/低转化/CPA极高 → 立即暂停此词
例：百度 AI场景计划 创意B "XXX" CTR极低 → 暂停此创意,换功能卖点方向

━━━ 🟡 需关注（观察中）━━━
具体到对象+阈值+观察期限
例：360 OCPC CPA超出锁价14% → 观察3天，若持续超出则联系媒体调整

━━━ 📌 SEM TODO ━━━
P0: [具体操作] — 哪个平台/账户/计划/词/创意 — 怎么操作 — 预期效果
P1: ...
P2: ...

Sheet 3：信息流 & 展示广告明细

结构原则：同样总→分，统一维度。

信息流完整分析维度（缺一不可）：

• 渠道×账户维度
• 广告组明细（素材方向+定向+出价）
• 素材效率矩阵（素材类型×定向方式交叉）
• 素材创意对比（具体到创意标题/图片/视频的效果差异）
• 定向人群效率对比
• 落地页转化率对比（如有数据）
• 投放时段效率（如有数据）
• Highlight + 问题 + TODO（具体到广告组+素材+定向+出价的操作建议）

3.1 信息流全渠道汇总表

注：以上账户为示例占位符，实际运行时通过MCP/API动态获取用户已配置的账户列表。

3.2 广告组/素材明细（统一格式）

字段提取规则（从广告组命名规范中解析）：

• 素材类型：图文/横版视频/竖版视频/应用下载
• 素材方向：根据用户命名规范解析
• 定向方式：通投/排联盟-排已转化/自定义人群等
• 出价方式：OCPM/OCPC

按消费降序，标记规则同SEM。

3.3 素材效率矩阵（按素材类型×定向方式交叉分析）

标注每个格子的CPA和转化数，方便一眼看出哪个"素材×定向"组合最优。

3.4 创意素材效果对比

分析维度：

• 同方向不同素材的CTR对比：哪个创意/视频的点击率更高
• CTR vs CVR的关系：高CTR不代表高转化，要看完整漏斗
• 创意疲劳度：CTR是否在持续下降（对比近3天趋势）
• 建议：具体到"XX素材CTR下降疑似疲劳，建议更换；YY方向CTR+CVR双高，建议追加预算+复制类似素材"

素材图片获取方式：

• 腾讯广告：dynamic_creatives/get(filtering by adgroup_id) → 取 creative_components.image[].value.image_id → images/get(filtering by image_id, fields含thumb_preview_url) → 用 thumb_preview_url（CDN链接，公开可访问）
  • preview_url 是 api.e.qq.com 域名需要token才能访问，日报里必须用 thumb_preview_url
• 360展示：/display/report/cost 直接返回 materialUrls 字段（CDN链接，公开可访问）
• 搜索广告（百度/Google/360搜索/Bing）：纯文字创意，无图片

日报中的图片展示规则：

• 信息流/展示广告Sheet中，Top消费素材需展示缩略图（）
• 按消费降序展示Top10素材，每个素材含：缩略图 + 创意名 + 消费 + 点击 + CTR + 转化 + CPA
• 用于直观对比哪个视觉素材效果好/差

3.5 定向人群效率对比

3.6 信息流 Highlight & 问题诊断 & TODO

━━━ 🟢 优质组合（加预算/扩展）━━━
具体到：[广告组名] → 素材类型+定向+出价 → 数据 → 建议
例：「方向A(通投OCPM)」CPA低/有量 → 预算+50%，同时复制此方向新建横版视频素材测试

━━━ 🔴 低效组合（降预算/暂停/换素材）━━━
具体到：[广告组名] → 问题 → 具体操作
例：「方向B(OCPC)」CPA飙升仅少量转化 → 暂停此组，将预算转移给CPA低的组
例：360展示「XX人群-屏保」CTR极低 → 创意疲劳，建议更换素材

━━━ 🟡 素材/定向策略建议 ━━━
基于矩阵+创意+定向分析综合给出：
- 最优组合：[素材类型] × [定向] × [出价] 的胜出公式
- 应扩展：哪类素材方向+哪种定向正在起量
- 应收缩：哪类持续低效
- 新测试方向：基于现有数据推断可能有效的新组合（素材方向+定向+出价方式）
- 创意迭代：哪些素材需要更新（CTR下降/疲劳）

━━━ 📌 信息流 TODO ━━━
P0: [具体操作] — 哪个广告组/素材 — 怎么操作（调预算/换素材/改定向/调出价/新建测试组）— 预期效果
P1: ...
P2: ...

Sheet 4：近7日新增动作效果追踪

本模块专门追踪最近7天内新增的投放动作（加词、加创意、改匹配、加素材、新计划上线等），评估其效果，给出"有没有用"的结论和后续优化建议。

4.1 新增动作识别

通过以下方式识别近7日新增：

• 搜索广告：对比最近7天 vs 之前7天的关键词/计划/创意列表，新出现的即为"新增"
• 信息流：近7天内首次有消费记录的广告组/素材
• 也可由用户手动告知"我昨天加了XX"

4.2 新增关键词效果

结论标记：

• ✅ 有效：CPA ≤ 同计划均值，且有转化
• ⚠️ 待观察：上线≤2天，数据量不足以判断（消费<¥100 或 点击<30）
• 🔴 无效：CPA > 同计划均值 50% 以上，或花费>¥200 仍无转化

4.3 新增创意/素材效果

结论标记：

• ✅ 跑赢老素材：CTR 或 CPA 优于同组老素材均值
• ⚠️ 持平/待观察：差异<10%，或数据量不够
• 🔴 跑输老素材：CPA 高于老素材 30%+ 或 CTR 低于老素材 50%+

4.4 匹配模式/出价调整效果

4.5 新增动作总结 & 建议

✅ 有效动作（继续保持/加强）：
  - [具体动作] → [效果数据] → [下一步建议]

🔴 无效动作（需要调整/停止）：
  - [具体动作] → [效果数据] → [建议操作]

⚠️ 待观察（数据不足，继续跑2-3天再判断）：
  - [具体动作] → [当前数据] → [判断标准：达到XX则保留，否则停止]

判断"有没有用"的标准：

1. 新词/新素材：CPA ≤ 同计划/同组历史均值 → 有用
2. 匹配调整：CTR 提升且 CPA 未恶化 → 有用
3. 出价调整：量级提升且 CPA 涨幅 ≤ 10% → 有用
4. 花费 > ¥200 且 0 转化 → 确认无效，建议立即暂停
5. 上线 ≤ 2 天且消费 < ¥100 → 数据不足，标"待观察"

核心指标定义

数据拉取方式

百度搜索

• API: POST https://api.baidu.com/json/sms/service/ReportService/getRealTimeData
• 认证: JSON body header 里放 accessToken + userName（驼峰，传accounts.json里的name字段即可，任意非空字符串即可）
• body字段名必须用 realTimeRequestType（不是reportRequestType！用错会报81012）
• 必须加 unitOfTime: 5, statRange: 2
• 账户级: reportType=2, levelOfDetails=2
• 计划级: reportType=5, levelOfDetails=3
• 关键词级: reportType=14, levelOfDetails=11
• 创意级: reportType=12, levelOfDetails=7（返回name: [账户,计划,单元,标题,描述1,描述2]）
• 转化字段: ocpcConversionsDetail25（应用注册）+ ocpcConversionsDetail3（表单提交）
• conversion 字段总返回0，必须用 ocpcConversionsDetail 系列
• performanceData 必须含 impression 和 click（必填）
• Token刷新: 用 refresh-tokens 脚本（URL: https://u.baidu.com/oauth/refreshToken）
• 账户列表: 从 accounts.json 动态读取用户已配置的百度账户列表

360搜索

• 登录: POST https://api.e.360.cn/account/clientLogin（header: apiKey, body: username+passwd）
• 密码加密: MD5→hex字符串(UTF-8,32字节)→AES-CBC(key=apiSecret前16,IV=后16,无padding)→64位hex
• 所有POST请求必须用 Content-Type: application/x-www-form-urlencoded（不是JSON！）
• Token文件: 从MCP配置的token存储路径读取
• 搜索计划消耗: POST /dianjing/report/campaign (form-urlencoded: startDate=YYYY-MM-DD&endDate=YYYY-MM-DD)
• 搜索转化数据（campaign接口不返回转化！必须额外调以下接口）:
  • OCPC转化: POST /dianjing/report/Ocpc（只有OCPC账户有，T+1，字段: converts/factConverts/ocpcCpa/totalCost）
  • CPC关键词转化: POST /dianjing/report/keyword（字段含 converts/convertsCost）
  • 展示广告转化: POST /display/report/adtransform（返回 count + transform数组明细）
• 搜索创意报表: POST /dianjing/report/creative（返回 creativeId/title/clicks/views/totalCost 等）
• 展示广告消耗: POST /display/report/cost
• 账户列表: 从 accounts.json 动态读取用户已配置的360账户列表（搜索+展示）

腾讯广告

• API: GET https://api.e.qq.com/v3.0/daily_reports/get
• Token: 从MCP配置的环境变量读取（支持多组token对应不同子客账户）
• 展示互选子客: level=REPORT_LEVEL_ADGROUP, group_by=['adgroup_id']
• 搜索推广子客: level=REPORT_LEVEL_ADVERTISER_TOTAL, group_by=['date']（必须加group_by）
• 转化字段: conversions_count
• CPA 需自算: cost/conversions_count（API 不直接返回 conversion_cost）
• 费用单位: 分（需÷100转元）
• 账户列表: 从MCP配置的环境变量动态获取account_id

Google Ads

• 用 GAQL 查询 v20 API
• URL: https://googleads.googleapis.com/v20/customers/{customer_id}/googleAds:search
• Header: Authorization + developer-token + login-customer-id（如果有MCC管理账号，必须在header中加 login-customer-id=MCC的Customer ID）
• 指标: metrics.cost_micros(÷1e6=USD), metrics.impressions, metrics.clicks, metrics.ctr, metrics.conversions, metrics.cost_per_conversion
• 汇率: USD×7.2=CNY
• 账户信息: 从MCP配置的环境变量读取 customer_id、developer-token 等

Bing Ads

• 用 Python bingads SDK + ReportingServiceManager
• Account ID / Customer ID: 从MCP配置的环境变量读取
• report.Scope.AccountIds.long = [account_id], Campaigns = None
• 必须加 report.Aggregation = 'Daily'（否则报 ReportAggregation 枚举错误）
• 报表提交后自动轮询下载 CSV
• 列: TimePeriod, CampaignName, Impressions, Clicks, Ctr, AverageCpc, Spend, Conversions, CostPerConversion
• MCP get_campaigns需传多类型: 'Search DynamicSearchAds Shopping Audience PerformanceMax'

输出规则

1. 所有洞察必须有数据支撑，不做空泛评价
2. TODO 必须具体可执行，包含"哪个账户/哪个计划/做什么操作/预期效果"
3. 成本类指标环比：↑ 为恶化（红色）、↓ 为改善（绿色）
4. 效率/量级指标环比：↑ 为增长（绿色）、↓ 为下滑（红色）
5. 日报风格：简洁抓重点，不堆砌数据，每个洞察一句话
6. 默认中文输出
7. 输出格式为 HTML（单文件，含内联CSS，深色主题，清晰易读），文件名：{品牌名}_{YYYYMMDD}_广告日报.html
8. HTML 设计要求：深色背景、表格紧凑、关键数据突出（大字/颜色标记）、移动端适配
9. 用 preview_url 工具展示给用户，同时用 deliver_attachments 交付文件
10. 如当日数据为空（如还没消费），标注"截至N点数据"或"暂无消费"

Pitfalls

• 百度转化字段不是 conversion，是 ocpcConversionsDetail25 + ocpcConversionsDetail3
• 百度 performanceData 必须含 impression 和 click，否则报 invalid
• 百度 body 字段名必须是 realTimeRequestType，不是 reportRequestType（后者报81012）
• 百度必须加 unitOfTime: 5, statRange: 2
• 百度 userName 传 accounts.json 里的 name 字段（任意非空字符串即可）
• 百度 token 刷新 URL 是 https://u.baidu.com/oauth/refreshToken（不是api.baidu.com/oauth也不是iam.baidu.com）
• 腾讯广告费用单位是分不是元，要÷100
• 腾讯搜索推广子客需要用 REPORT_LEVEL_ADVERTISER_TOTAL + group_by=['date']，展示互选子客用 REPORT_LEVEL_ADGROUP + group_by=['adgroup_id']
• Google Ads API 需要 v20（v16-v18 已下线返回404）
• Google Ads 如果有MCC管理账号，必须在header中加 login-customer-id=MCC的Customer ID
• 360 OCPC 报表只有 T+1 结算数据（当天拉不到当天的转化）
• 360 展示广告 cost 接口当天数据 totalCost 可能为0（当天结算未完成），建议拉昨天
• 360 报告接口返回404时，通常是 token 过期——需重启 MCP 让360重新自动登录
• Bing 报表必须加 report.Aggregation = 'Daily'（否则枚举错误）
• Bing 报表是异步的，用 ReportingServiceManager 自动处理

Verification

• 检查每个平台是否都有数据返回（非空）
• 交叉验证：总消费 = 各渠道消费之和
• CPA 计算验证：消费/转化 = 表中 CPA 值
• 环比方向验证：成本↑标红、量级↑标绿

配套定时任务（Automation）

使用本skill建议配置以下WorkBuddy自动化任务：

Token刷新必须在日报生成之前执行（百度/腾讯token 24h过期，日报拉数据需要有效token）。

创建方式：在WorkBuddy对话中直接说"帮我创建百度token每天9点自动刷新的定时任务"即可。

日报记忆与连续性追踪

机制说明

日报不是孤立的——每天的问题诊断、TODO建议、待观察事项必须形成跨天追踪链。上一份日报说的"观察3天再判断"、"本周跟进"的事项，到期后必须在新日报中给出结论。

追踪日志文件

• 路径：{workspace}/.workbuddy/memory/ad-report-tracker.json
• 格式：JSON数组，每条记录一个待追踪事项
• 每次出日报时先读取此文件，检查是否有到期/过期事项需要回顾

追踪记录结构

{
  "id": "20260528-001",
  "created_date": "2026-05-28",
  "due_date": "2026-05-31",
  "category": "observe|action|warning",
  "priority": "P0|P1|P2",
  "platform": "百度|360|腾讯|Google|Bing|全渠道",
  "target": "具体计划/关键词/广告组名",
  "issue": "问题描述（一句话）",
  "threshold": "判断标准（如：CPA>60则暂停，CTR<1%则换素材）",
  "baseline_data": "记录时的基线数据（如：CPA=¥92, 转化4个）",
  "status": "open|resolved|escalated|expired",
  "resolution": "结束时填写结论"
}

每次出日报的追踪流程

Step 1: 读取追踪日志

• 读取 ad-report-tracker.json
• 筛选 status=open 的记录
• 按 due_date 排序，标记：🔴已过期(due_date < today) / 🟡今日到期 / 🟢未到期

Step 2: 回顾已到期事项

• 对每个已到期/今日到期的事项，用当日数据重新评估：
  • 达到threshold → 标记为 escalated，在日报TODO中升级为P0动作
  • 问题已消失/改善 → 标记为 resolved，在Highlight中标注🟢
  • 仍在观察区间内但没恶化 → 延期due_date +2天，保持open

Step 3: 生成新的追踪项

• 从当日日报的以下内容中提取新追踪项：
  • TODO中标注"观察X天"/"本周跟进"的事项
  • Sheet 4 中标记为"⚠️待观察"的新增动作
  • Highlight中标记🟡需关注的趋势
• 自动设置due_date = today + 观察天数（默认3天）

Step 4: 写入追踪日志

• 更新已有记录的status
• 追加新记录
• 保存到 ad-report-tracker.json

日报中的追踪展示

在HTML日报中新增一个固定模块（放在Highlight之后、TODO之前）：

历史问题追踪

🔴 已到期未解决（需立即处理）：
  [提出日期] 问题描述 → 当时数据 → 今日数据 → [结论+建议]

🟡 今日到期（需复查）：
  [提出日期] 问题描述 → 阈值判断标准 → 今日数据 → [达标/未达标]

🟢 观察中（未到期）：
  [提出日期] 问题描述 → 还有X天到期 → 当前状态

✅ 已解决（近3天内关闭的）：
  [提出日期→解决日期] 问题描述 ✓

追踪规则

1. 不漏追：每个TODO中含时间限定词（"观察"/"跟进"/"X天后"/"本周"）的事项必须入追踪
2. 不忘提：过期事项必须在日报中醒目展示，不能因为忘了就不提
3. 有结论：到期事项必须给出明确结论（改善/恶化/不变），不能只说"继续观察"超过2次
4. 2次延期上限：同一事项最多延期2次（共观察≤9天），超过必须升级为P0给出行动建议
5. 自动清理：resolved状态的记录保留7天后从日志中移除，避免文件膨胀