data-manager-api-event-ingestion-google-skills

1. 基本信息

项目	内容
名称	data-manager-api-event-ingestion-google-skills
作者/维护者	Google（google/skills 官方合集仓库）
来源链接	https://github.com/google/skills/tree/main/skills/ads/data-manager-api-event-ingestion
许可证	Apache-2.0（GitHub API 实测，仓库层级）
GitHub Stars	19,195（合集仓库整体，GitHub API；不代表本技能自身热度，见第 7 章说明）
Forks	1,546（合集仓库整体，GitHub API）
最新版本	metadata.version 1.1，最近一次针对本技能目录的提交为 2026-08-04（GitHub API commits）
安装方式	`npx skills add google/skills/skills/ads --agent=<平台>`

2. 功能介绍与亮点

该技能指导开发者通过 Data Manager API 的 /v1/events/ingest 端点，把线下转化、增强型潜客转化、点击转化、Google Analytics 网页/应用事件等各类事件数据上传到 Google 广告与营销生态。

正文按清晰工作流组织：第一步强制要求先与用户确认数据要发往哪个目的地（Google Ads、Floodlight、Campaign Manager 360 或 Google Analytics）——因为不同目的地对应的字段与账号结构不同，技能明确写明“不得默认假设发往 Google Ads”；随后给出 Python/Java/PHP/Node/.NET 五种语言的官方代码样例链接，以及针对四类旧版 API（Google Ads 离线转化、Google Ads Store Sales、GA Measurement Protocol、CM360 离线转化）的字段迁移映射指南，便于存量用户升级。核心是一份逐项实现清单：初始化客户端、构建 Destination 对象、用配套工具库格式化/哈希用户标识符、构造并发送 IngestEventsRequest（支持 validate_only 模式在不实际上传的情况下校验字段）、检查响应中的 field_warnings，最后按 request_id 轮询 retrieve_request_status 确认实际处理结果。技能还专设一份「Critical Gotchas」清单（如 product_destination_id 必须是数字字符串而非资源路径、event_timestamp 须严格用 RFC 3339 格式、ConsentStatus 枚举值容易写错、currency 字段名不能写成 currency_code 等），均来自真实实现中的高频出错点而非泛泛的 API 文档转述。

3. 适用场景

所属分类：集成与工作流自动化

面向需要把线下转化数据、潜客事件或 App/Web 分析事件对接进 Google Ads、Google Analytics、Campaign Manager 360 等营销系统的开发者与营销技术团队，典型场景包括：上传离线店内购买转化、为 Salesforce/CRM 中的潜客状态变化上传增强型转化、把 GA4 事件同步进 Google 营销生态，或是把此前分散在多个旧版上传接口的代码迁移到统一的 Data Manager API。

4. 跨 Agent 兼容性

Claude Code：原生支持——Google 官方文档给出专用安装命令 npx skills add google/skills/skills/ads --agent=claude-code
Codex：需适配——官方同样给出 --agent=codex 专用安装命令，但 Codex 默认沙箱不带网络访问，而正文将“抓取官方发送指南与代码样例”标为 [CRITICAL] 步骤，实际执行前需手动开启网络权限
OpenClaw：未验证——官方文档仅笼统声明兼容“支持开放 Agent Skills 标准的助手”，未见专门验证
Hermes Agent：未验证——同上，未见专门验证

5. 推荐理由

把 Data Manager API 事件上传这件容易在字段格式与异步状态确认上踩坑的事，浓缩成一份含五语言官方样例、迁移映射表与高频出错点清单的可执行操作指南，对接入 Google 广告/分析生态的团队直接可用。

6. 评分

维度	分数	说明
受欢迎程度	7	官方出品——Google 是 Data Manager API 的所有者；WebSearch 检索到 Google 官方开发者博客与第三方营销技术媒体（stape.io、ALM Corp）对该 API 本身的报道，但均未见独立第三方对本技能文件的讨论或引用
可用性	9	正文含完整实现清单、五语言官方样例、四类旧版 API 迁移映射表与高频出错点清单；最近一次维护 2026-08-04，无付费依赖
安全性	9	见下方检查清单

安全检查清单： ① 无 shell 命令执行，技能只指导生成调用官方客户端库的代码 ② 会将用户提供的事件数据（经哈希/格式化处理的用户标识符）发送至 Google 服务器，属该 API 设计初衷（转化归因），流程要求显式设置 ConsentStatus 同意状态字段 ③ 凭据通过标准 OAuth/ADC 流程管理（由配套的 data-manager-api-setup 技能负责），未见硬编码或不当存储 ④ 正文与代码样例链接中未发现可疑指令或隐藏提示注入 ⑤ 作者为 Google 官方团队，信誉无造假迹象 ⑥ License 为 Apache-2.0，明确开源可审计

7. 跟同类 Skills 相比的优势

名称	定位	与本技能的差异
data-manager-api-audience-ingestion（同为 google/skills 合集）	上传/管理广告受众名单（Customer Match、设备 ID 受众）	与本技能同属 Data Manager API 家族但处理对象不同：一个管理“受众名单”，一个管理“转化事件”，两者互补覆盖该 API 的两大用途
google-ads-api-quickstart（同为 google/skills 合集）	生成 Google Ads API 访问所需的开发者令牌、OAuth 凭据等五项基础参数	只负责“拿到访问权限”这一前置步骤，不涉及具体的事件上传逻辑
旧版分散上传方案（Google Ads API ConversionUploadService、GA4 Measurement Protocol 各自独立对接）	各目的地使用互不相通的接口与字段规范	需要开发者分别研究每套接口文档、各自处理格式差异；本技能对应的 Data Manager API 用一套统一接口覆盖全部目的地，并内置迁移映射表

8. 用户评价

该技能本身在第三方平台尚无独立于官方发布公告之外的具名用户评价。检索到的第三方内容集中在 Data Manager API 本身：营销技术媒体 stape.io 与 ALM Corp 均发布过分析文章，讨论该 API 2026 年新增的 Store Sales 转化上传与多目的地事件支持对开发团队的影响，但两篇均属技术解读而非技能使用体验。

9. 其他补充

据 Google Ads Developer Blog 2026 年 5 月的公告，Data Manager API 当月新增了向 Google Marketing Platform（Campaign Manager 360、Search Ads 360、Display & Video 360）发送事件的能力，并扩展了 Google Ads Store Sales 转化的上传支持；其中 Store Sales 转化功能仅对已列入白名单的账号开放，接入前需先确认账号资格。本技能随 API 能力迭代持续更新。

10. 安装使用方式

Claude Code / Antigravity / Cursor：npx skills add google/skills/skills/ads --agent=<对应平台名>
其他支持开放 Agent Skills 标准的助手：npx skills add google/skills/skills/ads
安装后代理会在检测到相关请求（如“上传离线转化到 Google Ads”）时自动加载该技能；也可在对话中手动通过 / 唤起
使用前需先完成 data-manager-api-setup 技能中的身份认证与客户端库安装步骤

11. 注意事项

首次调用前必须与用户确认数据目的地（Google Ads / Floodlight / CM360 / Google Analytics），四者字段结构不同，技能明确要求不得默认假设发往 Google Ads
请求处理为异步，成功返回 request_id 仅代表数据已被接收，需按技能指引至少等待 30 分钟后再轮询 retrieve_request_status，才能确认实际处理结果（成功/部分成功/失败）
涉及上传经哈希处理的用户标识符（邮箱、电话号码等），使用前应确认所在组织已具备合规的用户同意与数据处理依据，并正确设置 ConsentStatus 字段
Store Sales 等部分子功能仅对已列入白名单的账号开放，接入前需向 Google 确认账号资格