Data Manager API 事件导入助手
指导开发者通过 Google Data Manager API 实现事件与转化数据导入。
技能要求先确认目标账户类型，说明 Destination、认证账户、linked account、同意状态、validate_only 和异步诊断流程，并要求格式化、哈希和加密用户数据；因此主要数据流风险可见。扣分原因是未明确要求用户在真实上传前确认，未说明数据保留、访问控制、撤回或回滚机制，也未充分说明外部 API 上传的副作用和依赖安全。
工作流、关键字段陷阱、validate_only 分支、请求状态轮询和错误诊断说明较连贯，异常结果有一定反馈路径。扣分原因是未提供覆盖关键路径的测试或可执行脚本，只有一段 Python 片段，依赖外部文档和客户端版本，边界输入与失败处理仍不完整；静态评估按上限不超过 10 分。
明确覆盖离线转化、增强转化、点击转化及 Analytics 等事件摄入，并明确不适用于 audience ingestion；要求缺失 destination 时澄清，且列出多语言样例入口。扣分原因是输入、输出格式和非适用边界仍较简略，未说明中文使用支持，也无法从材料确认在中国大陆网络环境下访问核心 Google 服务和文档的可达性。
文档按前置条件、识别场景、样例、迁移、实施、格式化、陷阱和排障分层，包含版本 1.1、Apache-2.0、官方组织来源、安装入口及问题反馈路径。扣分原因是没有变更日志、明确维护责任人或更新承诺，FAQ 和完整示例不足，关键能力依赖另一个 setup skill 与外部页面。
该技能能帮助开发者形成 Data Manager API 事件摄入流程，并覆盖账户配置、请求构造、校验、诊断和常见字段错误。扣分原因是没有提供端到端可直接使用的实现或代表性输出，仍需读取多个外部指南、选择语言并补齐业务和错误处理；静态评估按上限不超过 7 分。
材料给出具体 API、迁移指南、格式化指南、诊断指南和多个官方客户端样例链接，并提供固定仓库修订信息，具备一定审计线索。扣分原因是未提供提交的测试套件、CI 结果或第三方执行证据，关键结论主要依赖未在材料中展开的外部文档；静态评估按上限不超过 5 分。
- 真实上传会产生外部数据变更；在生成或运行非 validate_only 请求前，应由用户确认目标账户、授权范围、同意状态和数据处理责任。
- 核心准确性依赖外部 Google 文档、客户端库和 utility library 的当前版本；应在实施前核对版本兼容性、字段定义、隐私合规和大陆网络可达性。
- 未提供回滚、重复上传防护、密钥管理、数据保留或端到端测试说明。
这个 Skill 能做什么，适合哪些场景？
该技能面向需要使用 Data Manager API `/v1/events/ingest` 导入事件或转化数据的开发者。它覆盖离线转化、潜在客户增强转化、点击转化以及 Google Analytics 网页或应用事件等场景。技能要求先确认数据目标账户类型，再参考官方发送指南和对应语言的代码示例实现集成。它还强调数据格式化、同意状态、验证模式、异步处理诊断以及常见字段错误。
指导用户确认 Google Ads、Floodlight 或 Google Analytics 等目标账户类型；要求读取官方发送事件指南、格式化指南、错误指南和必要的迁移字段映射；选择 Python、Java、PHP、Node 或 .NET 示例；初始化 IngestionServiceClient，构造 Destination 和 IngestEventsRequest，格式化用户标识符，设置同意权限和 validate_only，调用 ingest_events 获取请求 ID，并在至少 30 分钟后通过 retrieve_request_status 检查成功、部分成功、失败、错误和警告记录。
- 需要将 Google Ads 离线转化数据迁移到 Data Manager API 的开发者。
- 需要上传潜在客户增强转化或点击转化事件的广告技术团队。
- 需要将 Google Analytics 网页或应用事件发送到受支持目标的集成开发者。
- 需要从旧版 Google Ads、Google Analytics Measurement Protocol 或 Campaign Manager 360 API 迁移的工程师。
- 需要在不实际上传数据的情况下验证事件模式和字段结构的开发者。
这个 Skill 有哪些优点和局限？
- 覆盖多种事件和转化导入场景，并明确排除受众成员上传。
- 提供 Python、Java、PHP、Node 和 .NET 的官方示例入口。
- 强调异步请求后的状态诊断，避免把 HTTP 200 误判为记录处理成功。
- 列出字段命名、时间戳、点击标识符和同意枚举等具体易错点。
- 依赖外部官方文档、代码示例和客户端或工具库；源材料未提供完整可运行实现。
- 源材料未说明费用、权限配置细节或各目标产品的完整事件字段要求。
- 技能本身未提供测试套件、脚本或本地验证环境。
- 诊断处理要求异步轮询，并建议发送后至少等待 30 分钟。
如何安装这个 Skill？
在终端运行 npx skills add google/skills，然后从仓库中选择 Data Manager API Event Ingestion 技能。源材料未说明单独安装该技能时的额外参数，也未提供独立的运行时安装命令。
如何使用这个 Skill？
可向代理提出："帮我使用 Data Manager API 导入 Google Ads 离线转化事件，先确认目标账户类型，并用 Python 示例实现。" 如果目标账户类型未明确，技能要求先询问数据发送到哪里；实现时还应参考官方发送事件指南和对应语言示例。认证与客户端安装应参考 data-manager-api-setup 技能。
这个 Skill 与同类方案有什么区别？
相较于同仓库的 Data Manager API Audience Ingestion 技能，本技能处理事件与转化记录，不处理受众成员上传；认证和客户端安装则交由 Data Manager API Setup 技能说明。