mcpField
A
ads-meta

ads-meta

github.com/hainrixz营销与增长10265 次安装3 天前更新
代码仓库

关于 ads-meta

用于审查 Meta 广告账户的追踪、创意、结构和受众设置,支持 MCP 实时数据、API 数据文件或手动导出,并生成评分与报告。

主要功能

  1. 01三层数据采集方式
  2. 0250 项账户审计
  3. 03Pixel 与 CAPI 健康检查
  4. 04创意疲劳检查
  5. 05健康评分与报告

适用场景

  1. 01检查 Meta 追踪与事件质量
  2. 02发现创意疲劳和格式缺口
  3. 03审查广告系列结构与受众设置

MCP 相关

连接 Facebook MCP 并提供广告账户 ID 后,技能会调用其工具获取实时质量、实体、目录、表现和基准数据。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hainrixz/claude-ads --skill ads-meta

安装后在 Claude Code 中输入/ads-meta确认已加载。

详细介绍

Meta Ads 深度分析

Andromeda AI 引擎

Meta 的 Andromeda AI 引擎(2025 年 10 月)使用复杂度高出 10,000 倍的模型筛选广告。 创意多样性如今是提升效果的首要杠杆。相似度评分 >60% 的广告会受到检索抑制。该算法会将近乎相同的创意归为一组,并限制其投放。 100 个细微变体的效果并不比 10 个好。应优先采用真正不同的概念、角度和形式,而不是大量相似变体。

数据收集(3 层,优先免费方案)

  • 第 1 层 — MCP(有条件时优先使用):如果用户提供了 ad_account_id(格式为 act_<digits>),且 claude.ai Facebook MCP 已连接,请调用 ads/references/mcp-meta-integration.md 中列出的 Meta MCP 工具。大多数 M01-M40 检查项都可通过实时数据查询完成。
    • mcp__claude_ai_Facebook__ads_get_dataset_quality → M02-M04(EMQ、CAPI、去重)
    • mcp__claude_ai_Facebook__ads_get_ad_entities → M11-M40(结构、学习阶段、版位)
    • mcp__claude_ai_Facebook__ads_catalog_get_diagnostics → Advantage+ Shopping 健康状况
    • mcp__claude_ai_Facebook__ads_insights_performance_trend → M28(创意疲劳)
    • mcp__claude_ai_Facebook__ads_insights_industry_benchmark → 实时基准(如有,则覆盖 benchmarks.md)
  • 第 2 层 — 直接 API(同样免费;只需设置一次 OAuth):如果当前工作目录中存在 meta-data.json 文件,请将其作为数据源读取。用户会在审计前生成该文件:
    export META_ACCESS_TOKEN='...'
    python3 scripts/api/meta_fetch.py --account-id act_<id> -o meta-data.json
    
    完整设置说明见 scripts/api/README.md。在 JSON 输出中设置 data_source: "direct_api"。
  • 第 3 层 — 手动备用方案(始终可用,无需设置):导出 Ads Manager CSV + Events Manager 截图 + EMQ 分数。对于无法评估的检查项,在 JSON 输出中标记 "result": "N/A"。

然后使用 meta-audit.md 作为检查清单,按照 ads/references/audit-methodology.md 中的标准 7 步审计流程执行。生成双格式输出(依据 audit-output-schema.json 输出 meta-audit-results.json,以及 meta-audit-results.md)。

分析内容

Pixel / CAPI 健康状况(权重 30%)
  • 已在所有页面安装 Meta Pixel,且正常触发
  • Conversions API (CAPI) 已启用(iOS 14.5 之后,不启用会造成 30-40% 的数据损失)
  • 已配置事件去重(event_id 匹配,去重率 ≥90%)
  • Purchase 事件的事件匹配质量 (EMQ) ≥8.0
  • 已配置所有标准事件(ViewContent、AddToCart、Purchase、Lead)
  • 已为非标准事件创建自定义转化
  • 已为 iOS 配置聚合事件衡量 (AEM)
  • 已完成域名验证
  • 服务器端事件包含 customer_information 参数
  • Pixel 触发时使用正确的货币和价值参数
创意(权重 30%)
  • 至少启用 3 种创意形式(图片、视频、轮播、精品栏)
  • 每个广告组至少有 5 个创意(Meta 建议)
  • 创意疲劳检测:14 天内 CTR 下降 >20% = 不合格
  • 视频创意:Stories/Reels 最长 15 秒,Feed 最长 30 秒
  • 已测试 UGC/客户评价创意
  • 已测试 Dynamic Creative Optimization (DCO)
  • 广告文案:标题少于 40 个字符,主要文本少于 125 个字符
  • 创意更新频率:高投入广告每 2-4 周更新一次
账户结构(权重 20%)
  • 有意选择 Campaign Budget Optimization (CBO) 或 Ad Set Budget (ABO)
  • 广告系列整合:建议总数为 1-3 个
  • 学习阶段健康状况:"Learning Limited" 的广告组占比 <30%(>50% 为不合格)
  • 每个广告组的预算:至少为目标 CPA 的 5 倍(退出学习阶段的最低要求)
  • 广告组受众重叠率 <30%(使用 Audience Overlap 工具)
  • 广告系列命名规则一致且描述清晰
  • 电商业务已启用 Advantage+ Sales Campaigns
  • 广告系列结构简化:总数为 1-3 个(优先选择数量较少、规模较大的广告组)
受众与定向(权重 20%)
  • 开发潜在客户的频次(7 天):<3.0(警告:3-5,失败:>5)
  • 再营销频次(7 天):<8.0(警告:8-12,失败:>12)
  • 自定义受众:网站访客、客户名单、互动用户
  • 类似受众:测试多个种子受众规模(1%、3%、5%)
  • 对比测试 Advantage+ Audience 与手动定向
  • 兴趣定向:范围足够广,以便算法优化
  • 排除项:在开发潜在客户时排除购买者,并管理受众重叠
  • 检查地理位置定向是否相关

Advantage+ 评估

如果正在使用 Advantage+ 功能:

  • Advantage+ Sales Campaigns:已连接目录,并设置现有客户上限
  • Advantage+ Audience:对比其表现与手动受众
  • Advantage+ Creative:已启用增强功能(文本、亮度、音乐)
  • Advantage+ Placements:已启用(让 Meta 优化版位组合)
  • 预算分配:为 Advantage+ 广告系列分配合理的测试预算

特殊广告类别

如果广告属于受限类别:

  • 在创建广告系列前申报特殊广告类别
  • 已确认定向限制(不可使用 ZIP,仅限 18-65+ 岁,不可使用类似受众)
  • 创意符合该类别的特定政策
  • 查看 ads/references/compliance.md,了解完整要求

EMQ 优化指南

EMQ 得分状态操作
8.0-10.0优秀保持当前设置
6.0-7.9良好添加更多 customer_information 参数
4.0-5.9一般实施 CAPI,提升数据质量
<4.0较差关键:必须实施 CAPI + Enhanced Matching

最大化 EMQ 的关键参数:

  • em(电子邮件):匹配率最高的信号
  • ph(电话):匹配率第二高的信号
  • fn、ln(名字/姓氏):提升匹配准确度
  • ct、st、zp(城市、州、ZIP):地理位置匹配
  • external_id:用于跨设备匹配的 CRM/用户 ID

关键阈值

指标通过警告失败
EMQ(购买)≥8.06.0-7.9<6.0
去重率≥90%70-90%<70%
CTR≥1.0%0.5-1.0%<0.5%
创意格式≥321
每个广告组的创意数量≥53-4<3
学习受限<30%30-50%>50%
每个广告组的预算≥5x CPA2-5x CPA<2x CPA

输出

Meta Ads 健康评分
Meta Ads Health Score: XX/100 (Grade: X)

Pixel / CAPI Health: XX/100  ████████░░  (30%)
Creative:            XX/100  ██████████  (30%)
Account Structure:   XX/100  ███████░░░  (20%)
Audience:            XX/100  █████░░░░░  (20%)
交付内容
  • META-ADS-REPORT.md:包含通过/警告/失败结果的完整 50 项检查报告
  • EMQ 改进路线图
  • 创意疲劳提醒(任何 CTR 下降 >20% 的创意)
  • 按影响程度排序的快速见效项
  • Advantage+ 采用建议

Threads 版位

Threads 版位于 2026 年 1 月全面开放,月活跃用户超过 4 亿。CPM 低于 Feed/Stories。 目前约占总支出的 0.04%。这是一个新兴渠道。请评估:

  • 是否在 Advantage+ Placements 中启用了 Threads 版位?
  • 监控 CPM 和互动情况,并与其他版位对比
  • 对于在 Threads 上保持活跃的品牌,抢先布局具有优势

评论

支持 Markdown