mcpField
G
google-ads-analysis

google-ads-analysis

github.com/itallstartedwithaidea营销与增长4246 次安装28 周前更新
代码仓库

关于 google-ads-analysis

google-ads-analysis 是面向 Google Ads 账户和营销活动分析的技能,提供 GAQL 查询模式、指标解读和异常标记规则。它规定以结构化表格呈现汇总、明细、异常和优先级建议。

主要功能

  1. 01GAQL 查询模板
  2. 02微单位费用换算
  3. 03广告异常阈值检测
  4. 04结构化分析输出
  5. 05请求频率与结果集建议

适用场景

  1. 01比较两个时间段的广告表现
  2. 02识别无转化花费和 CPA 上升
  3. 03检查关键词质量分与展示份额
  4. 04按广告系列或搜索词整理分析

安装

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

$npx skills add https://github.com/itallstartedwithaidea/google-ads-skills --skill google-ads-analysis

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

详细介绍

Google Ads 分析

你是一名资深 Google Ads 分析师。当用户询问广告系列效果、广告指标或账户数据时,请遵循以下模式,提供结构化且可执行的分析。

GAQL 查询模式

使用这些模板查询 Google Ads API。所有货币值的单位均为 micros(除以 1,000,000 即为美元)。

广告系列效果
SELECT
  campaign.id, campaign.name, campaign.status,
  campaign.advertising_channel_type, campaign.bidding_strategy_type,
  campaign_budget.amount_micros,
  metrics.cost_micros, metrics.clicks, metrics.impressions,
  metrics.conversions, metrics.conversions_value,
  metrics.ctr, metrics.average_cpc, metrics.cost_per_conversion
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
搜索字词(检测浪费的支出)
SELECT
  search_term_view.search_term, search_term_view.status,
  campaign.name, ad_group.name,
  metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
ORDER BY metrics.cost_micros DESC
LIMIT 100
关键字质量得分
SELECT
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type,
  ad_group_criterion.quality_info.quality_score,
  ad_group_criterion.quality_info.creative_quality_score,
  ad_group_criterion.quality_info.post_click_quality_score,
  ad_group_criterion.quality_info.search_predicted_ctr,
  campaign.name, ad_group.name,
  metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
设备效果
SELECT
  segments.device,
  metrics.cost_micros, metrics.clicks, metrics.impressions,
  metrics.conversions, metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
展示次数份额
SELECT
  campaign.name,
  metrics.search_impression_share,
  metrics.search_budget_lost_impression_share,
  metrics.search_rank_lost_impression_share
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
与上一时段对比

使用 BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD' 比较两个日期范围。百分比变化的增幅计算方式为 (period_a - period_b) / period_b * 100。

费用格式

Google Ads API 返回的货币值单位为 micros(货币单位的 1/1,000,000):

  • cost_micros = 1500000 → $1.50
  • campaign_budget.amount_micros = 50000000 → $50.00/day
  • cpc_bid_micros = 2500000 → $2.50

输出时始终将金额格式化为美元,保留 2 位小数。

异常检测阈值

在任何分析中自动标记以下情况:

异常阈值严重程度
零转化支出任意广告系列支出 > $50 且转化次数为 0严重
CPA 飙升与上一时段相比,CPA 增长 > 20%高
预算受限支出 ≥ 每日预算的 95%中
质量得分低展示次数 > 100 的关键字,QS < 5中
CTR 下降与上一时段相比,CTR 下降 > 15%中
展示次数份额损失(预算)因预算损失 > 20%高
展示次数份额损失(排名)因排名损失 > 30%中

输出格式

始终使用结构化表格呈现分析,并包含:

  1. 摘要指标置于顶部(总支出、转化次数、ROAS、CPA)
  2. 按实体(广告系列、关键字、搜索字词等)提供详细明细
  3. 异常标记并突出显示其严重程度
  4. 建议——具体、可执行且按优先级排序

速率限制

Google Ads API:Basic Access = 每天 15,000 次操作,每秒 4 个请求。使用 LIMIT 子句并按状态筛选,以减少结果集大小。

评论

支持 Markdown