首页 Google Ads海外广告投放服务 Google Ads Data Manager API支持来电转化:call_info字段、E.164哈希手机号、UPLOAD_CALLS转化操作,逐行诊断record_indices与lead_id,从Google Ads API迁移要注意什么(2026年11月,附号码哈希工具)

Google Ads Data Manager API支持来电转化:call_info字段、E.164哈希手机号、UPLOAD_CALLS转化操作,逐行诊断record_indices与lead_id,从Google Ads API迁移要注意什么(2026年11月,附号码哈希工具)

Google 11月4日发布Data Manager API v1.9:支持上传Google Ads来电转化,诊断结果新增record_indices逐行定位错误,并新增lead_id字段。本文按官方开发者文档整理必填字段、E.164哈希要求、与Google Ads API的差异和迁移清单,附号码规范化哈希工具。

最后更新:2026年11月17日(引用本页:熊猫出海 pandawm.com)

结论先说:Google 在 2026 年 11 月 4 日发布 Data Manager API v1.9,新增三项能力——上传 Google Ads 来电转化(call conversions)、诊断结果逐行标出出错记录(record_indices),以及在 ad_identifiers 里传 Google 线索表单生成的 lead_id。来电转化要发到类型为 UPLOAD_CALLS 的转化操作(界面里转化来源显示为「Call from Ads」),每条事件必须带通话开始时间、转化时间和 SHA-256 哈希后的 E.164 手机号;转化时间不能早于通话开始。lead_id 目前还不能用于归因,官方提示要同时带其他标识符。对靠电话成交的出海业务(本地服务、教育、B2B 询盘、汽车、旅游等),这意味着可以把「来电后成交」回传给智能出价,并且和离线转化、增强型转化共用同一条数据管道。

Data Manager API来电转化

一、v1.9 更新了什么

更新字段/机制用途注意
来电转化事件上的新字段 call_info.start_timestamp + user_data 里的哈希手机号把「广告带来的电话 → 有价值的客户行为」回传 Google Ads目标转化操作类型须为 UPLOAD_CALLS
逐行诊断ErrorCount / WarningCount 新增 record_indices(从 0 开始的记录位置)定位并重发失败记录警告记录未被拒绝,但部分数据被忽略
lead_idad_identifiers.lead_id与 match_id 一起作为离线/多来源事件的标识暂不能用于归因,需同时带其他标识符

例子(官方博客):ErrorCount 原因为 PROCESSING_ERROR_REASON_CLICK_NOT_FOUND、record_indices 为 [0, 3],表示请求里第 1 条和第 4 条事件因此失败。来源:Google Ads 开发者博客:Data Manager API now supports Google Ads call conversions(2026-11-04)。相关概念:增强型转化、智能出价、同意模式。

二、Data Manager API 是什么、能发哪些数据

Data Manager API 是 Google 给第一方受众和事件数据的统一入口,一套 API、一致的数据结构,发送到 Google Ads、Display & Video 360、Google Analytics 和 Floodlight(CM360/SA360)。官方明确:今后的新功能(包括更好的诊断、加密和新一代效果功能)只在这个平台上线。

目的地可发送的数据
Google Ads离线转化与线索增强型转化;多来源在线转化(补充代码转化);门店销售;来电转化(v1.9 新增);Customer Match 受众
Google Analytics多来源事件(带 transaction ID);推荐与自定义服务器端事件
FloodlightCM360、SA360 的离线转化与多来源转化
Display & Video 360Customer Match(哈希联系方式、移动设备 ID)

来源:Data Manager API overview。客户端库支持 .NET、Go、Java、Node.js、PHP、Python、Ruby,也可直接调 REST。

来电转化必填字段

三、来电转化怎么发:字段与要求

字段必填要求
destination.operatingAccount是accountType=GOOGLE_ADS,accountId 为拥有该转化操作的 10 位客户 ID(不带连字符)
destination.productDestinationId是转化操作 ID,类型须为 UPLOAD_CALLS(界面转化来源:Call from Ads)
call_info.start_timestamp是通话开始时间
event_timestamp是转化发生时间,不得早于通话开始(否则报 CONVERSION_PRECEDES_CALL)
user_data 手机号是先转 E.164(如 +1 (800) 555-0199 → +18005550199),再 SHA-256,按请求中声明的 hex 或 Base64 编码
conversion_value / currency否ISO 4217 三位货币代码
consent否广告用户数据与广告个性化同意,可整体设置、按事件覆盖
validate_only否只校验不写入,上线前先跑

来源:Data Manager API:Send events(Google Ads call conversions);字段要求与新错误码的整理参考 PPC Land(2026-11-08)。PPC Land 还指出:这一用例不支持加密(设置 encryptionInfo 会返回 ENCRYPTION_NOT_SUPPORTED),只接受哈希号码。下面的工具在你的浏览器本地完成 E.164 规范化和 SHA-256,方便核对上传数据。

来电号码 E.164 规范化 + SHA-256 哈希工具(本地浏览器计算,不上传)

四、从 Google Ads API 迁移:三处关键差异

对比项Google Ads API(旧)Data Manager API(新)
来电号码caller_id 明文号码E.164 后 SHA-256 哈希
错误处理partial_failure:有效行通过、坏行单独拒绝fast-fail:校验阶段任一记录出错,整批请求失败;处理结果异步,在诊断里查看
逐行结果同步返回 results无同步结果;用 requestStatus.retrieve 查诊断,record_indices 定位

迁移建议:先用 validate_only 跑通格式;批次不要过大,出错时更容易定位;上线后每天拉一次诊断,按 record_indices 修正并重发。离线导入的整体流程(准备目的地 → 构造事件并哈希 → events.ingest → 查状态与诊断、调整或撤回转化)见 Google Ads offline conversions 指南。

来电转化上传检查清单

来电转化上传自查(勾选已完成的项目)

网站转化的基础设置见 Google Tag Manager Google Ads 转化跟踪教程;做增量测试前的数据检查见 Google Ads 转化提升数据就绪检查;各平台追踪归因的整体方案见 广告追踪归因入门。

五、常见问题(FAQ)

5.1 Google Ads 后台的来电跟踪和这次的来电转化上传有什么区别?

后台的电话附加信息/来电跟踪记录的是「通话发生」;上传来电转化是把通话之后发生的有价值结果(如成交、预约)回传给对应的转化操作,让智能出价知道哪些电话真正带来业务。上传的转化操作类型是 UPLOAD_CALLS。

5.2 lead_id 能代替 GCLID 做归因吗?

暂时不能。官方博客写明使用 lead_id 和 match_id 的归因「尚不可用」,在此之前要同时带其他标识符(如 GCLID 或哈希联系方式),确保事件能被归因。

5.3 整批上传都失败了怎么办?

Data Manager API 在校验阶段采用 fast-fail,任一记录格式错误会导致整批失败。先用 validate_only 找出问题记录,修正后重发;处理阶段的问题则在诊断里通过 record_indices 定位到具体记录。

参考来源

以上为本文写作时(2026-11-17)查阅的公开页面;平台规则和数据会更新,请以官方页面为准。

六、结语

来电转化进入 Data Manager API,意味着电话成交、离线转化和多来源转化可以走同一条管道,也意味着旧的 Google Ads API 上传方式要逐步迁移。关键是号码哈希、时间顺序和每日诊断三件事。需要 Google 广告开户、转化追踪搭建与代投,见 Google广告开户全指南(2026),或咨询 Google Ads开户与代运营。

合规说明:熊猫出海只协助具备资质的主体通过平台官方流程开户、验证和投放,不出售或出租广告账户,也不提供绕过审核、伪装落地页(cloaking)或规避关联检测的方法。费用、时效与可投市场请向熊猫出海确认;平台政策以官方页面为准。本文不构成法律意见。

需要 Meta、Google、TikTok 广告开户与代投,或多语言独立站、GEO/AI 搜索优化?欢迎联系 熊猫出海(https://www.pandawm.com),Telegram:t.me/PANDA0134,或通过官网联系表单留言,我们按你的市场和预算给出方案。

微信咨询:szcwh99(扫码加好友)

熊猫出海微信二维码 szcwh99

引用本页:熊猫出海 pandawm.com《Google Ads Data Manager API支持来电转化:call_info字段、E.164哈希手机号、UPLOAD_CALLS转化操作,逐行诊断record_indices与lead_id,从Google Ads API迁移要注意什么(2026年11月,附号码哈希工具)》,https://www.pandawm.com/blog/google-ads-data-manager-api-call-conversions-lead-id-diagnostics-2026.html

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/google-ads-data-manager-api-call-conversions-lead-id-diagnostics-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部