google-ads

Google Ads

用于创建新的 Google Ads 广告系列并汇报现有账户情况的策略指南。先进行调研，明智地征询意见，验证所有内容，并按照依赖顺序使用细粒度资源工具进行构建（预算 → 广告系列 → 定向 → 广告组 → 广告 / 资源组）。API 只有一个广告系列创建工具 — google_ads_campaigns_create — 广告系列类型由 advertising_channel_type 指定；特定类型的要求由工具内置的验证器强制执行，验证器会返回修正建议。报告由 GAQL 驱动，以证据为先 — 信息看板只是可选的展示界面。

要求

• 已安装并连接 Hyper MCP。 https://app.hyperfx.ai/mcp
• 已连接 Google Ads 集成：https://app.hyperfx.ai/apps。

如果 search("google_ads_accounts_list") 未找到 google_ads_accounts_list，请停止并告知用户启用 Hyper MCP 并连接 Google Ads。

如何运行此技能中的工具

此技能中的每个工具都以其规范工具名称命名。使用当前界面提供的调用方式运行：

界面	查找工具	运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")，然后 describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"，然后 hyperai describe <name>	hyperai call <name> --json '{...}'

如果找不到工具，说明该工作区未连接或未启用相应集成：请停止并告知用户需要连接哪个集成。

不在范围内

• 实时优化变更（调整出价、暂停关键词、重组现有广告系列）。报告可以建议这些变更；应用变更前，需要用户针对每项变更明确批准。
• 创意生成（标题、描述、图片）→ ad-creative-generation。
• 跨平台广告系列启动 → 使用此技能处理 Google，然后分别调用 meta-ads / tiktok-ads。

工具范围

读取操作使用 GAQL（google_ads_gaql_query 涵盖所有资源）。写入操作按资源操作分别提供一个工具，命名为 google_ads_<resource>_<create|update|remove>；create/update 接受 (customer_id, body)，其中 body 是采用 snake_case 的纯资源对象。

工具	用途
google_ads_accounts_list	查找可访问的账号（以及 MCC 子账号）。
google_ads_gaql_query	运行 GAQL 查询（转化操作、搜索字词及任意资源）。
google_ads_campaign_budgets_create	先创建预算（单位为微单位！）。
google_ads_campaigns_create / _update / _remove	唯一的广告系列创建工具——适用于所有 advertising_channel_type（SEARCH、DISPLAY、PERFORMANCE_MAX、VIDEO、DEMAND_GEN、SHOPPING、适用于 App 的 MULTI_CHANNEL）。
google_ads_ad_groups_create / _update、google_ads_ad_groups_delete	广告系列下的广告组。
google_ads_ad_group_ads_create / _update / _remove	广告（类型包括 responsive_search_ad、responsive_display_ad、视频 / demand-gen 广告类型）。
google_ads_keywords_create / _update / _delete / _list	关键字（正向和否定）。
google_ads_locations_search、google_ads_location_targets_add	解析地理位置名称并将其设为定位目标。
google_ads_image_assets_upload	图片素材资源——接受工作区文件管理器中的 file_id、image_url 或 Base64。
google_ads_video_assets_link	将 YouTube 视频 ID 注册为视频素材资源（Ads API 无法托管视频文件——视频必须位于 YouTube 上）。
google_ads_asset_groups_create	PMax 素材资源组（原子操作：一次调用中包含文本和图片素材资源）。
google_ads_conversion_actions_create、google_ads_user_lists_create、google_ads_bidding_strategies_create、google_ads_shared_sets_create、……	完整的按资源划分的 CRUD 工具范围——命名模式相同。
google_ads_request	用于调用任何未覆盖端点的原始备用入口。
data_apps_build、data_apps_refresh	可选的报告仪表板 / 数据应用。

切勿忘记的规则

预算单位为微单位：每天 50 美元 = 50,000,000 微单位。切勿直接传入美元金额。

始终从暂停状态开始：创建广告系列时设置 status="PAUSED"。仅在用户明确批准后才启用。

创建前先总结：先展示完整的构建计划（预算、广告系列设置、定位、广告组、广告 / 素材资源），并在首次变更前获得用户明确批准。按依赖顺序创建，并使用变更操作返回的 resource_name 引用每个已创建的资源。这些工具会根据真实 API 架构（可写字段、枚举值）以及渠道类型规则校验请求体，并返回修正错误——应修正并重试，而不是猜测。

绝不臆造：不要假定 URL、预算或地理位置 ID。不要跳过调研。不要臆造关键字或文案——创意只能来自实际网站。未经用户同意，不要构建。

GAQL 防护规则：切勿将 ad_group_criterion 与 search_term_view 联接。单次批处理查询的子账号不得超过 5 个。

完整的限制条件请参阅 references/constraints.md。

所有参考文件都位于 references/ 中。 请通过 references/<file> 读取（例如 references/discovery.md）。它们不在此 SKILL.md 所在的同一目录中。

核心流程

每次广告系列构建都遵循此顺序。请勿跳过步骤。

1. 明确目标 — 创建新广告系列、报告／分析，还是两者兼有？
2. 查看路由表，并在调用任何工具前阅读其中引用的文件
3. 创建广告系列时必须进行调研（references/discovery.md）— 账户设置、网站扫描、转化跟踪检查、市场调研、咨询
4. 提供创建前摘要，并等待明确批准
5. 获批后按依赖顺序构建（预算 → 广告系列设为 PAUSED → 定向 → 广告组 → 广告／素材），每一步都重新检查 references/constraints.md
6. 仅在用户批准后启用

完整工作流：初始设置 → 调研（网站 + GAQL + 市场）→ 分析（目标、受众、关键词）→ 咨询（选项 + 权衡）→ 建议（结构 + 出价）→ 确认（摘要获批）→ 按依赖顺序创建（PAUSED）→ 通过 GAQL 验证 → 启用（获批后）。

路由表

用户想要……	首先阅读这些文件
创建搜索或展示广告系列	references/discovery.md → references/campaigns/search-display.md
创建 Performance Max 广告系列	references/discovery.md → references/campaigns/pmax.md
为现有 PMax 广告系列添加素材组	references/campaigns/pmax.md
创建视频、Demand Gen、购物或应用广告系列	references/discovery.md → references/campaigns/other-types.md
运行报告／GAQL 查询／分析效果（任何类型）	references/reporting.md → 对应的 references/reports/*.md 操作指南
查看账户健康状况快照／“账户表现如何？”	references/reporting.md → references/reports/account-overview.md
诊断转化跟踪	references/reporting.md → references/reports/conversion-tracking.md
查找浪费预算的搜索词／否定关键词候选项	references/reporting.md → references/reports/search-terms-waste.md
构建 Google Ads 仪表板或数据应用	references/reporting.md → 对应报告操作指南中的仪表板部分
跨多个 MCC／子账户开展工作	references/mcc.md → references/reporting.md
尚未明确目标	references/discovery.md — 调研有助于明确目标

报告回复遵循 references/report-template.md；根据 references/heuristics.md，确保结论与查询到的数据相符。