iOS端Firebase购买事件在Google Ads中转化值为零的技术求助

安全阿岳

2026-6-22

iOS端Firebase Purchase事件无法关联Google Ads归因及转化值为0的原因分析

你使用Cordova+WebView开发移动端应用，iOS和Android端均集成Firebase Analytics，在购买页触发purchase事件的JS代码如下：

firebase.analytics.logEvent('purchase', {
    'transaction_id': transaction.request_id,
    'affiliation': transaction.affiliation,
    'value': transaction.revenue,
    'currency': 'TRY',
    'items': analytics_items
});

目前Android端通过Firebase关联Google Ads能正常追踪广告点击后的购买转化及销售额，但iOS端仅在Firebase面板可见转化值，Google Ads中仅显示转化计数、转化值始终为0；且Google Analytics的Firebase模块中，iOS的purchase事件均标记为Direct流量，Android端则来自不同流量源，推测iOS无法将购买事件与Google Ads关联，可能的原因如下：

ATT权限未正确配置或用户拒绝跟踪
iOS的App Tracking Transparency框架要求必须向用户请求跟踪权限才能获取IDFA（广告标识符）。如果未在App中实现ATT权限请求，或用户拒绝了跟踪，Firebase无法获取用于广告归因的IDFA，导致购买事件无法关联到Google Ads的点击来源，流量只能归为Direct。需确认是否在iOS原生代码或Cordova插件中正确配置了ATT权限请求逻辑，且用户允许了跟踪。
Cordova插件的iOS归因适配问题
你使用的Firebase Analytics Cordova插件可能存在iOS端归因适配缺陷：比如未正确集成AdSupport框架、插件版本过低未适配最新iOS归因规则，导致原生层的广告归因数据无法传递给WebView中的JS SDK。需检查插件版本，确认是否已针对iOS的ATT框架和广告归因做了适配。
Purchase事件参数的类型/格式兼容性问题
虽然JS代码一致，但iOS端对参数类型的校验更严格：
- 若transaction.revenue是字符串类型，Android可能自动转换为数值，但iOS可能无法识别，导致Google Ads无法读取有效转化值，需确保该参数为纯数字类型（如Number而非String）。
- 货币参数currency需严格符合ISO 4217标准，尽管TRY是合法代码，但需确认iOS端Firebase SDK是否正确解析该货币标识，否则转化值可能无法被Google Ads正常读取。
WebView与原生层的归因数据传递断裂
WebView中的Firebase JS SDK依赖原生层传递广告归因信息（如点击ID、流量源）。若iOS端原生Firebase SDK未将这些数据同步到WebView，JS上报的purchase事件无法关联到对应的广告来源。需检查Cordova的WebView配置，确认是否允许原生与JS之间的归因数据交互，或是否需要在原生层手动同步归因参数到WebView环境。
Google Ads与Firebase的关联配置遗漏
即使两端都关联了Firebase与Google Ads，iOS端可能存在配置遗漏：
- 在Google Ads设置转化目标时，是否针对iOS应用正确选择了对应的Firebase purchase事件，且开启了“转化值”跟踪选项。
- 检查Firebase项目中iOS应用的链接配置是否正确，确保Google Ads能正常拉取iOS端的转化值数据。
- 确认iOS端Firebase Analytics是否启用了广告归因功能，可检查GoogleService-Info.plist中的相关配置项。
归因时间窗口不匹配
Google Ads的归因时间窗口设置可能在iOS端存在差异，或用户的购买行为超出了iOS端的归因时间范围，导致无法关联到之前的广告点击，只能归为Direct。可检查Google Ads中的归因设置，确认iOS与Android端的时间窗口配置一致。

内容的提问来源于stack exchange，提问作者Bunyamin Kurt