SuperAPI AI 工具集

meta-ads

营销与增长

查看项目

更新于 10-16 06:37

技能介绍

用途

Meta Ads 是一个面向 Meta(Facebook/Instagram)广告的 AI 管理技能,目标是替代在 Ads Manager 中反复点击的操作,用纯文本每天给出真正重要的五件事。其核心判断是:90% 的广告管理本质是模式识别——花费趋势上升或下降、CTR 下滑(创意疲劳)、CPA 飙升(受众枯竭)、赢家出现、亏损广告失血。该技能负责发现这些模式,由用户做决策。

主要能力

技能通过 ./run.sh 与 ./scripts/meta-kit.sh 提供报表能力,覆盖以下报告:

  • 5 Daily Questions(每日五问):系统核心,替代约 20 分钟的 Ads Manager 点击。包括:我是否在正轨上(今日花费 vs 预期)、当前在跑什么(活跃广告系列一览)、表现如何(按广告系列看 7 天指标)、谁在赢谁在输(按广告层级排序)、是否有疲劳(CTR 趋势、频次、CPC 变化)。
  • Overview:账户级摘要与广告系列细分。
  • Campaigns:列出广告系列,可按状态过滤。
  • Top Creatives / Winners:按结果排序的广告层级表现,是放量候选。
  • Bleeders:高花费但表现差的广告,是暂停候选;会标记 CTR < 1% 或频次 > 3.5 的广告。
  • Fatigue Check:按天细分,识别 CTR 逐日下滑、频次攀升、CPC 上升等创意疲劳信号。
  • Custom:完全自定义,可指定层级、字段、细分维度(如按年龄和性别细分)。

日期预设包括:today、yesterday、last_7d(多数报告默认)、last_30d、last_90d。

品牌记忆集成

技能会读取工作区品牌文件(均为可选):

  • workspace/brand/stack.md:存储的广告账户 ID、目标 CPA/ROAS;用于自动填充账户并对照目标评估表现。
  • workspace/brand/creative-kit.md:品牌创意指南与素材;为创意建议提供上下文。
  • workspace/brand/audience.md:目标受众画像;用于解读受众表现数据。
  • workspace/brand/learnings.md:过往表现模式;用于识别重复出现的问题(如“上个月也发生过”)。

写入方面:stack.md 在首次使用时存储广告账户 ID;learnings.md 追加表现发现、疲劳模式、获胜创意特征。

使用方式

一次性设置:

  1. 配置本地适配器模式: cp .env.example .env META_KIT_MODE=mock ./scripts/meta-kit.sh doctor

  2. 在 .env 中为非 mock 运行设置账户/令牌:使用官方 Ads CLI 变量 ACCESS_TOKEN、AD_ACCOUNT_ID,可选 BUSINESS_ID。该套件仍接受 META_AD_ACCOUNT / META_SYSTEM_USER_ACCESS_TOKEN 别名以保持向后兼容。请勿将密钥提交到 git。

调用方式:当用户询问 Meta 广告、Facebook 广告、Instagram 广告或广告系列表现时,技能会:检查 workspace/brand/stack.md 中存储的广告账户 ID;检查 AD_ACCOUNT_ID / META_AD_ACCOUNT 环境变量;若两者都没有,运行 ./scripts/meta-kit.sh doctor,认证后可用 meta ads adaccount list 列出账户;运行相应的 ./run.sh 报告;结合品牌目标(来自 stack.md/learnings.md)解读结果;对 bleeders/winners 给出带理由的明确建议;未经用户明确批准绝不采取行动;将发现记录到 workspace/brand/learnings.md。

常用触发语句与对应脚本:

  • “Daily ads check” / “Run the 5 questions on my ads” / “How are my Meta ads doing?” → ./run.sh daily-check
  • “Meta ads overview for last 30 days” → ./run.sh overview --preset last_30d
  • “Show me active campaigns” → ./run.sh campaigns --status ACTIVE
  • “What are my best performing ads?” → ./run.sh winners --preset last_7d
  • “Any ads bleeding money?” / “Find underperforming ads” → ./run.sh bleeders --preset last_7d
  • “Which ads should I scale?” / “Show me the winners” → ./run.sh winners --preset last_7d
  • “Any creative fatigue?” / “Check for ad fatigue” → ./run.sh fatigue
  • 自定义细分示例:meta --output json --no-input ads insights get --breakdown age --breakdown gender --fields spend,impressions,ctr,cpc(需先配置只读 CLI 认证)

变更操作与安全

除报表外,官方 Ads CLI 可创建/更新/删除资源。在本套件中,变更类操作除非经过 dry-run 加显式批准,否则会被阻止。示例:

META_KIT_MODE=mock ./scripts/meta-kit.sh create-ad --payload examples/create-ad.json --dry-run

安全原则:所有变更操作均为高风险,需要确认。技能应始终先呈现发现与建议,为拟议变更写入 dry-run 产物,然后在任何实际执行前请求显式批准。

AI 广告经理工作流

  • 早晨(通过 cron 自动化):运行 daily-check;标记 bleeders(CTR < 1%、频次 > 3.5、CPA 超阈值);标记 winners(高 CTR、低 CPC、有放量空间);将摘要发送到 Telegram/Slack。
  • 用户(喝咖啡时约 2 分钟):阅读摘要;批准/拒绝建议;必要时追问。
  • AI(在批准后):为已确认变更生成精确的 dry-run 产物;实际变更前需要 META_KIT_MODE=live-approved + META_KIT_APPROVAL_ID;新建广告仅保持 PAUSED 状态;将决策记录到 learnings.md。

适用场景

适合需要每日快速掌握 Meta 广告投放健康度、识别创意疲劳与亏损广告、发现可放量赢家,并希望以文本摘要方式接入自动化(如 cron + Telegram/Slack)的广告运营者。也适合希望将广告数据与 GA4、GSC 等报告交叉分析以评估真实 ROAS 的场景。

限制

  • 变更类操作默认被阻止,需 dry-run 与显式批准,且新建广告仅以暂停状态创建。
  • 非 mock 运行需要配置 ACCESS_TOKEN、AD_ACCOUNT_ID 等凭据,密钥不得提交到 git。
  • 品牌记忆文件均为可选,缺失时相关上下文与对标能力受限。
  • 具体收费、价格、平台支持范围等资料未提供。