用途 该技能用于采集并结构化 GA4 与 Google Ads 数据，供跨平台分析使用，是线索质量调查、转化分析、受众洞察等任务中可复用的数据采集环节。它本质上是一份采集协议：定义从每个平台采集什么，以及以何种结构化 JSON 形式返回。技能本身不输出解释或建议，产物是数据集。
主要能力
- 采集 Google Ads 数据：广告系列设置（状态、预算、出价策略及 CPA/ROAS 目标、地理定向、URL 扩展设置、设备出价调整、网络设置）与广告系列表现（花费、转化、转化价值、ROAS）。
- 采集 GA4 数据：广告系列转化汇总、用户分层（城市、设备、浏览器、时段）、落地页（含意图分类）。
- 将两部分数据按固定 JSON 结构输出，字段来源由契约中的来源映射规定；无合法来源的字段保持 null 或缺失，不得编造。
使用方式 必需输入：Google Ads 客户 ID、精确广告系列名称（区分大小写）、GA4 属性 ID、转化事件名称；日期范围可选，默认最近 14 天。客户 ID 与 GA4 属性 ID 来自自建账户/属性登记表，广告系列名称与事件名称需查询平台或向用户确认。 流程分四步：验证输入（核对 GA4 属性登记、客户 ID 有效性、广告系列是否存在）；采集 Google Ads 数据；采集 GA4 数据；按 JSON 契约结构化输出。 已交付的唯一可直接运行命令：python scripts/query_campaign_settings.py <customer_id> "<campaign_name>"，需在包含 google-ads.yaml 的目录下运行。其余四个脚本（广告系列表现、GA4 转化汇总、GA4 用户分层、GA4 落地页）属于环境相关实现，契约文档 references/collection-contract.md 提供说明与 GA4 Data API 实现要点。 输出格式可选结构化 JSON（默认，面向程序消费）、Markdown 表格（人工查看）或仅摘要。
前置条件
- google-ads.yaml 及有效 OAuth 凭据（可参考 google-ads-api-setup 技能创建）；通过管理账户查询客户账户时需在 yaml 中设置 login_customer_id。
- Python 及 google-ads 包（pip install google-ads）。
- 自实现的 GA4 脚本需 google-analytics-data 包及 GA4 Data API 访问权限；复用 Ads OAuth 客户端时，需重新签发包含 GA4 读取作用域的刷新令牌（作用域在签发时固定，无法追加）。
适用场景 需要 GA4 转化数据与 Google Ads 广告系列交叉对照、分析转化用户分层（地域、设备、落地页、时间）、在提出建议前核实广告系列设置，或为自定义分析/智能体消费提供原始数据时使用。触发方式如用户询问某广告系列哪些落地页在转化、某广告系列的 GA4 数据、或转化用户分层情况。
限制
- 不做解释与建议：差异含义等问题应转向 ga4-campaign-cross-reference，“为什么线索质量差”转向 ga4-lead-quality-investigation。
- 不附带 GA4 侧脚本，三项 GA4 拉取与表现拉取均为需自行实现的契约。
- 所有查询在两个平台上均为只读，不做任何修改。
- 已交付脚本不提供地点名称、半径值或 URL 排除列表：它打印地理 ID，对邻近目标只检测不量化，且无法获取 URL 排除项；这些字段需从界面或自建脚本获取。
- 不是调查编排器；完整线索质量调查由 ga4-lead-quality-investigation 负责，并自动加载本技能作为采集步骤。
- 错误处理：GA4 属性不在登记表时停止并向用户确认，不得猜测；广告系列未找到时先核对精确名称（注意已交付脚本输出 ERROR: … not found 但仍以退出码 0 结束，需看控制台而非退出码）；日期范围内无数据时可扩大范围或确认事件名，空结果本身也是值得报告的发现。
- 运行后不会在本文件夹生成文件：已交付脚本仅输出到控制台，汇总 JSON 由智能体生成并在对话中返回，除非操作者要求文件。
已提供字段（示例）：客户 ID、广告系列名称、GA4 属性 ID、事件名称、日期范围与 metadata.analysis_date 共同构成自描述数据集；采集范围涵盖广告系列表现、设置、GA4 转化汇总、落地页与用户分层。其他细节如具体收费、平台覆盖范围等暂未提供。