SuperAPI AI 工具集

ads-conciencia

营销与增长

查看项目

更新于 10-28 00:49

技能介绍

用途

该技能解决广告平台与真实业务结果之间的信息差。平台统计点击和消息数量,但无法判断这些消息是否转化为客户,还是无效流量。/ads conciencia 让 Claude 明确意识到这一差距:存储用户按日期填写的答案,按计划再次询问,并与平台指标交叉比对,计算活动的真实成功率。

主要能力

  • 注册活动:记录活动名称、转化渠道(WhatsApp / Messenger / IG DM / 表单 / 电话 / 落地页)、平均客单价与货币(可选,用于估算 ROAS)、检查频率(默认 7 天)。
  • 定期检查:按计划向用户询问真实业务数据,包括真实对话数、有真实意向的合格线索数、成交客户数、收入(可选)、垃圾线索数及备注。
  • 交叉比对:将用户报告的业务数据与平台指标(花费、点击、消息/线索)结合,计算累计指标、最新指标和趋势。
  • 生成报告:输出人类可读的 Markdown 文件,包含已知信息、未知信息、解读和下一步建议。
  • 状态管理:列出所有活动及其状态、检查次数、成交率和下次检查时间。

使用方式

子命令路由:

  • 无参数:若有逾期活动则进入检查;若无活动则进入注册;否则查看最近更新的活动。
  • registrar:注册一个或多个活动。
  • checkin:检查所有逾期活动或用户指定的活动。
  • ver [<key>]:交叉比对并渲染,不提问。
  • lista:列出活动简表。

注册示例:

python3 scripts/conciencia.py register --platform meta --campaign-id 120210000000001 \
  --name "WhatsApp Clínica" --objective messages --channel whatsapp \
  --ticket-value 2400 --currency MXN --every 7

记录已知事实:

python3 scripts/conciencia.py know meta-120210000000001 \
  --fact "CPL de plataforma 52 MXN (auditoría 2026-10-20)" --source audit

检查示例:

python3 scripts/conciencia.py checkin meta-120210000000001 --json '{
  "period_from": "2026-10-20", "period_to": "2026-10-27",
  "source_of_platform_metrics": "mcp",
  "platform_metrics": {"spend": 2800, "clicks": 850, "messages": 55},
  "user_reported": {"conversations": 40, "qualified": 14, "closed": 6,
                    "revenue": null, "junk": 12, "notes": "preguntan precio y desaparecen"}
}'

查看与渲染:

python3 scripts/conciencia.py show <key>
python3 scripts/conciencia.py render <key> --out conciencia-de-campana.md

适用场景

  • 转化目标为线索、消息、电话或表单的广告活动。
  • 成交发生在 WhatsApp、Messenger、IG DM、表单或电话中的业务。
  • 需要了解平台指标与真实业务结果之间差距的营销人员。

限制

  • 电商且已配置购买像素的活动不需要此技能,因为平台已能追踪销售。
  • 用户未报告的业务结果一律记为 null,显示为 N/A,绝不写 0。
  • 比率仅从双方均有报告的检查中计算。
  • 不修改广告账户,仅读取平台数据并向用户提问。
  • 数据存储于 ~/.claude-ads/conciencia/<platform>-<campaign_id>.json,由脚本管理,不可手动编辑。
  • 平台指标获取优先级:MCP → scripts/api/<platform>_fetch.py → 请求导出或截图;若均不可用,则留空并说明,绝不估算。