Google Ads Master

• 您正在设置新的 Google Ads 账户或接入现有账户，需要在进行任何操作之前收集配置信息、转化操作、预算和护栏设置。
• 您希望获取广告系列级别或关键词级别的效果报告——点击率（CTR）、广告支出回报率（ROAS）、搜索展示份额、每次转化费用（CPA）——并根据您实际的主要转化操作进行解读，而非混合的界面汇总数据。
• 您需要排查点击率偏低的问题、诊断转化价值差异，或分析搜索词和地理位置数据，以便做出出价、否定关键词或拆分广告系列的决策。
• 您希望根据结构化规格，以暂停状态创建新的搜索广告系列、广告组或关键词，并在写入后通过 GAQL 回读来确认已创建的内容。

• 您需要管理非搜索广告系列类型或 Google Ads 以外的平台——此技能仅适用于 Google Ads 搜索工作流。
• 您希望实现完全自动化、无需人工确认步骤的广告系列优化；此技能在执行任何写入操作之前需要明确授权。
• 您尚未完成最低限度的入门配置（客户 ID、授权、报告时区、主要转化操作）——此技能将在进行分析或写入操作之前提示您完成这些配置。

在进行任何分析或账户变更之前，Google Ads Master 会收集最低限度的必要数据集：客户 ID、OAuth/授权路径、开发者令牌、报告时区、商业模式、主要转化操作、ROAS/CPA 目标以及写入权限。这可以防止在不完整或不匹配的账户背景下采取操作。

所有广告系列、广告组和关键词的创建，默认状态为"已暂停"，除非用户明确要求其他设置。预算和出价在未经确认的情况下绝不会被修改，且每次写入操作后都会通过 GAQL 回读来汇总 ID 和状态。

绩效分析以用户确认的主要转化行动为基准，而非默认假设为购买、潜在客户或注册。在用户明确说明哪些行动计入转化之前，Google Ads 界面中混合统计的转化总数将被标记为不可靠数据。

该技能附带四个脚本：一个共享的客户端/配置辅助工具、一个广告系列摘要报告（CTR/ROAS/IS 诊断）、一个关键词级别的主要转化报告，以及一个基于 JSON 规范的已暂停搜索广告系列构建器。所有脚本均使用 google-ads Python gRPC 客户端。

建议遵循一套统一的工作流程：根据用户的实际关键词和市场，按意图分类进行细分，执行保留/观察/降低/暂停/拆分/添加否定关键词等操作，并始终在指标旁注明广告系列和关键词名称，以确保建议具有可操作性。

该技能参考内部 GAQL 查询模式及 API 注意事项，以规避已知的 REST 接口不完整性问题，并优先采用 gRPC 客户端。写入操作完成后，系统将通过回读方式确认广告系列的 ID、名称、状态及预算，广告组的 ID 与状态，以及关键词的文本、匹配类型与状态。

新用户连接其 Google Ads 账户后，技能将引导完成入门引导清单——收集客户 ID、授权信息、转化操作、目标设置及安全限制——随后运行 report_campaigns.py，生成点击率（CTR）、广告支出回报率（ROAS）及展示份额（Impression Share）的基准汇总报告。

某广告主怀疑其主要转化行为在界面中被微转化所稀释。该技能运行以已确认的主要行为为范围的 purchase_keywords.py，并呈现哪些关键词正在推动真实结果，哪些仅产生虚高计数。

广告系列点击率下降，原因尚不明确。该技能会提取搜索词和关键词数据，诊断问题是否源于广告相关性不足、匹配类型偏移或因排名导致的展示份额损失，并结合指标依据，提出具体的保留、暂停、拆分或否定关键词操作建议。

用户提供包含预算、出价策略、关键词列表、匹配类型、否定关键词、广告文案和网址的广告系列简报。该技能将简报格式化为 JSON 规格，先以演习模式运行 create_search_skeleton.py，然后以暂停状态创建广告结构，并回读所有 ID 和状态以进行确认。