营销审计
- 作者仓库星标 5,641
- 作者更新于 实时读取
- 作者仓库 claude-ads
- 领域
- 安全
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @AgriciDaniel · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: ads-google
description: Google Ads deep analysis covering Search, Performance Max, AI Max, Display, YouTube, and Demand…
category: 安全
runtime: 无特殊运行时
---
# ads-google 输出预览
## PART A: 任务判断
- 适用问题:安全审计、密钥扫描、权限检查或风险分析。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“Process / What to Analyze / Conversion Tracking (25% weight)”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于安全审计、密钥扫描、权限检查或风险分析,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“Process / What to Analyze / Conversion Tracking (25% weight)”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 原文出现了 `/careers`、`/admin`、`/thank-you` 这类斜杠命令;如果你的 Agent 支持命令触发,优先用命令开场,再补充目标和边界。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件。
先用一个小任务确认它会围绕“Process / What to Analyze / Conversion Tracking (25% weight)”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: ads-google
description: Google Ads deep analysis covering Search, Performance Max, AI Max, Display, YouTube, and Demand…
category: 安全
source: AgriciDaniel/claude-ads
---
# ads-google
## 什么时候使用
- 把安全方向的常用动作沉淀成 Agent 可调用的技能 适合处理安全审计、密钥扫描、权限检查和风险分析,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤;通常不…
- 面向安全审计、密钥扫描、权限检查或风险分析,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「Process / What to Analyze / Conversion Tracking (25% weight)」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "ads-google" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> Process / What to Analyze / Conversion Tracking (25% weight)
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} Google Ads Deep Analysis
Process
- Collect Google Ads account data (export, Change History, Search Terms Report)
- Validate: confirm data covers ≥30 days and includes Search Terms Report before proceeding
- Read
ads/references/google-audit.mdfor full 80-check audit - Read
ads/references/benchmarks.mdfor Google-specific benchmarks - Read
ads/references/scoring-system.mdfor weighted scoring - Evaluate all applicable checks as PASS, WARNING, or FAIL
- Validate: confirm all 80 checks evaluated before calculating score
- Calculate Google Ads Health Score (0-100)
- Generate findings report with action plan
What to Analyze
Conversion Tracking (25% weight)
- Google tag (gtag.js) installed and firing on all pages
- Enhanced Conversions active (hashed first-party data)
- Consent Mode v2 implemented (required for EU/EEA)
- Conversion actions mapped correctly (primary vs secondary)
- Offline conversion import configured (for lead gen)
- Server-side tagging via GTM (recommended for accuracy)
- Attribution model: data-driven preferred (last-click as fallback only)
- Conversion lag analysis (are conversions still trickling in?)
Wasted Spend (20% weight)
- Search Terms Report reviewed (last 30 days minimum)
- Negative keyword coverage adequate (shared lists + campaign-level)
- Display placement audit (exclude low-quality sites)
- Invalid click rate within norms (<10%)
- Broad Match only used with Smart Bidding (NEVER without it)
- Brand/non-brand campaigns separated
- Geographic targeting precise (no wasted international spend)
Negative Keyword Rules (critical: bad negatives kill campaigns):
- NEVER suggest Broad Match negatives unless explicitly justified; they block too broadly
- Default to Exact Match
[keyword]for specific irrelevant queries - Use Phrase Match
"keyword"for irrelevant intent patterns - Source negatives from actual Search Terms Report irrelevant queries, NOT guesses
- Group into themed lists: Informational (how-to, DIY, what is), Job-seeker (jobs, careers, salary), Competitor (only if intentionally excluded), Free-intent (free, crack, torrent)
- Recommend Shared Negative Lists at the account level, not just campaign-level
- Review existing negatives for over-blocking (are any negatives accidentally blocking converting queries?)
Account Structure (15% weight)
- Campaign-level organization follows business logic
- Ad groups themed tightly (15-20 keywords max per group)
- RSA ad groups have ≥3 active ads
- PMax campaigns structured correctly (asset groups, signals)
- SKAGs evaluated (migrate to themed groups if present)
- Campaign labels/naming conventions consistent
Keywords (15% weight)
- Match type strategy appropriate (Exact → Phrase → Broad progression)
- Quality Score distribution (aim ≥7 average)
- Low QS keywords flagged (<5 = FAIL, 5-6 = WARNING)
- Keyword cannibalization check (same keywords in multiple campaigns)
- Impression share tracked for top keywords
- Keyword bid adjustments set for devices/locations/audiences
Ads (15% weight)
- RSA: ≥8 unique headlines, ≥3 descriptions per ad group
- RSA: ad strength "Good" or "Excellent" (not "Poor" or "Average")
- Pin usage minimal and strategic (over-pinning reduces RSA flexibility)
- Ad extensions: sitelinks (≥4), callouts (≥4), structured snippets, image
- Dynamic keyword insertion used appropriately
- Ad copy includes CTA, value proposition, differentiators
Settings (10% weight)
- ECPC (Enhanced CPC) flagged as deprecated. Migrate to full Smart Bidding (tCPA/tROAS/Maximize)
- Bid strategy appropriate for campaign maturity and goals
- Budget pacing: no campaigns limited by budget (unless intentional)
- Ad schedule aligned with business hours/conversion patterns
- Device bid adjustments set based on performance data
- Location targeting: "Presence" not "Presence or Interest"
- Network settings: Search Partners reviewed, Display opt-out for Search
GAQL & Data Accuracy
Before analyzing data, read ads/references/gaql-notes.md for known GAQL field incompatibilities,
deduplication patterns, and filter scope best practices. Key rules:
- Deduplicate keywords by
(ad_group_id + keyword_text + match_type)before any analysis - Only analyze ENABLED campaigns and ad groups (exclude paused/removed)
- Filter to keywords with impressions > 0 for theme coherence checks (G03)
- Apply legacy BMM heuristic: BROAD + Manual CPC = legacy BMM, not intentional broad (G17)
- Only flag wasted spend on terms with >$10 spend AND 0 conversions (G16)
- Count shared negative keyword lists alongside campaign-level negatives (G14/G15)
Google Ads MCP Integration (Optional)
For automated data collection, connect the Google Ads MCP server:
- Tools available:
search(GAQL queries),list_accessible_customers - Setup: Configure in
.mcp.jsonor Claude Code MCP settings - Customer ID: Extract from CLAUDE.md under Accounts > Google Ads, or ask the user
- Fallback: If MCP is not configured, fall back to manual data export (the default workflow)
When MCP is available, use it to pull Search Terms Reports, keyword data, conversion actions, and campaign structure automatically instead of requiring manual exports.
PMax Deep Dive
If Performance Max campaigns exist, additionally evaluate:
- Asset group diversity (text, images, video, feeds)
- Audience signals configured (custom segments, lists, demographics)
- URL expansion settings reviewed (opt-out of irrelevant pages)
- Brand exclusions applied (prevent cannibalizing brand search), available for all advertisers
- Campaign-level negative keywords now available for ALL advertisers
- Search themes utilized (2024 feature)
- Final URL expansion: enabled or disabled with justification
- Insights tab reviewed (search categories, audience segments)
AI Max for Search (2026)
AI Max layers broad match + keywordless targeting on existing Search campaigns. 14% avg conversion lift for non-retail brands at similar CPA/ROAS (Google Ads blog, May 2025). DSA, ACA, and campaign-level broad match auto-migrate into AI Max by end of September 2026; new DSA campaign creation via the Google Ads API ends Sept 2026. Strong negative keyword lists are a hard prerequisite. Independent data across 250+ campaigns shows more conservative real-world results (+13% median revenue, +16% median CPA) — set expectations accordingly.
Detection & API field
AI Max is enabled per-campaign via ai_max_setting.enable_ai_max (Google Ads
API v21+). Check the campaign's ai_max_setting resource for current state.
Audit checklist
If AI Max for Search is available or active:
- Field check:
campaign.ai_max_setting.enable_ai_max = truefor eligible Search campaigns (or documented opt-out reason) - Broad Match + Smart Bidding combo verified — AI Max effectively forces broad match expansion; without Smart Bidding (tCPA/tROAS/Maximize Conv) it bleeds spend
- Search Term Matching — review the
search_term_matching_typedistribution in the Search Terms Report (close variants vs broader matches); FAIL if the broader-match share exceeds 60% on a non-Smart-Bidding campaign - AI Brief configured — Google's new structured brand context input. Audit for: business name, value prop (≤200 chars), target audience descriptor, forbidden topics / off-brand language list, regional / legal disclaimers
- Text customization rules — AI Max generates headline + description variants from the brief. Audit for: locked legal phrases, banned competitor names, approved disclaimer text, pin discipline on must-include claims
- Final URL Expansion (FUE) controls — confirm URL include/exclude lists
prevent AI Max routing traffic to checkout-skip pages, password-gated pages,
or 404s. Audit
url_expansion_opt_outif you've explicitly disabled FUE - Brand exclusions applied — campaign-level brand exclusion list to prevent cannibalizing brand search; same mechanism as PMax brand exclusions
- Text disclaimers (rolling out May 2026+) — if your vertical requires disclaimers (health, finance, legal, crypto), confirm Google's new structured text disclaimer field is populated
- Budget impact — AI Max can shift spend ±30% in the first 7 days. Confirm budget pacing rules and shared budgets won't starve adjacent campaigns
- Negative keyword coverage — AI Max broadens reach 3-5x; existing negative lists must scale. Reuse the negative keyword rules from the Wasted Spend section but apply at 3x the historical volume
DSA Migration Pre-Flight Checklist
The Sept 2026 auto-migration moves Dynamic Search Ads, Automatically Created Assets (ACA), and campaign-level broad-match Search campaigns into AI Max whether or not the advertiser is ready. Run this pre-flight before the migration deadline:
- Inventory DSA campaigns — query
campaign.advertising_channel_sub_type IN (SEARCH_DYNAMIC, ...). List campaign IDs, monthly spend, conversion volume so the migration can be staged by risk - Inventory ACA-enabled campaigns —
campaign.ad_strength_settingswith auto-generated headlines enabled - Inventory campaign-level broad-match Search campaigns without AI Max yet enabled — these will migrate by default
- Tracking template audit — DSAs often use
{lpurl}ValueTrack parameters. Confirm tracking templates resolve correctly when AI Max generates a different final URL via FUE. Re-test parameter substitution with a synthetic AI Max landing URL - Negative keyword pre-staging — pull the last 90 days of DSA search terms; pre-stage the irrelevant ones as Exact/Phrase negatives on a Shared Negative List before migration
- AI Brief drafted — write a draft Brief for each migrating campaign so Google has structured brand context at migration time, not generic crawled content
- URL controls staged — Final URL Expansion include/exclude lists prepared per campaign (especially for /careers, /admin, /thank-you, /404 paths that DSAs typically excluded by URL pattern rules)
- Brand exclusion lists prepared — campaign-level brand exclusion file (same format as PMax)
- Bidding strategy migration — Manual CPC and ECPC DSA campaigns MUST move to Smart Bidding before AI Max migration. Pre-stage tCPA or tROAS targets per migrating campaign
- Conversion tracking pre-flight — AI Max attribution relies heavily on Enhanced Conversions + Consent Mode V2; confirm both are active and verified per the Conversion Tracking section before migration
- Reporting baseline — capture 28-day pre-migration metrics (CTR, CVR, CPA, ROAS, Search Lost IS by rank/budget) so post-migration impact can be measured cleanly
Document the migration risk per campaign as LOW (Smart Bidding + strong negatives + good AI Brief), MEDIUM (Smart Bidding but weak negatives or no Brief), or HIGH (Manual CPC, weak negatives, generic Brief). Stage migrations starting LOW → HIGH and pause MEDIUM/HIGH if conversion volume drops >25% in the first 7 days.
Demand Gen Campaigns
Replaced Video Action Campaigns (auto-upgrade began July 2025). Adding image assets to a video-only campaign drives 20% more conversions at the same CPA (Google Ads blog). Frequency capping NOT supported.
If Demand Gen campaigns exist, evaluate:
- Video + image asset mix present (combined format drives 20% more conversions vs video-only at same CPA)
- Audience signals configured (custom segments, lookalikes)
- Conversion tracking aligned with upper/mid-funnel goals
- Note: frequency capping is not available. Monitor reach vs frequency manually
Key Thresholds
| Metric | Pass | Warning | Fail |
|---|---|---|---|
| Quality Score (avg) | ≥7 | 5-6 | <5 |
| CTR (Search) | ≥6.66% | 3-6.66% | <3% |
| CVR (Search) | ≥7.52% | 3-7.52% | <3% |
| CPC (Search) | ≤$5.26 | $5.26-8.00 | >$8.00 |
| Wasted Spend | <10% | 10-20% | >20% |
| Ad Strength | Good+ | Average | Poor |
| Invalid Clicks | <5% | 5-10% | >10% |
Output
Google Ads Health Score
Google Ads Health Score: XX/100 (Grade: X)
Conversion Tracking: XX/100 ████████░░ (25%)
Wasted Spend: XX/100 ██████████ (20%)
Account Structure: XX/100 ███████░░░ (15%)
Keywords: XX/100 █████░░░░░ (15%)
Ads: XX/100 ████████░░ (15%)
Settings: XX/100 ██████████ (10%)
Deliverables
GOOGLE-ADS-REPORT.md: Full 80-check findings with pass/warning/fail- Wasted spend estimate (monthly $ value)
- Quick Wins sorted by impact
- PMax-specific recommendations (if applicable)
- Keyword health matrix with QS, CTR, CVR per keyword group
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核