iOS环境下Firebase无法追踪Google Ads自定义广告系列安装/事件求助

一、确认Google Ads与Firebase的关联配置 #

• 检查Firebase项目是否已关联Google Ads账号：进入Firebase控制台「整合」板块，找到Google Ads入口，完成账号绑定，并确保广告系列的转化目标已关联到Firebase的对应事件。
• 验证Google Ads转化设置：在Google Ads后台，将转化动作设为「应用安装」，并绑定到目标Firebase应用，确认转化追踪ID配置无误。

二、检查自定义事件的发送逻辑 #

• 延迟触发自定义事件：需在first_open事件完成后再发送广告系列相关自定义事件，避免在App启动初期（如didFinishLaunchingWithOptions）直接发送，确保Firebase完成归因判断。
• 规范事件命名：自定义事件名称仅允许字母、数字、下划线，首字符为字母，例如google_ads_campaign_install，禁止使用空格或特殊字符。
• 验证事件发送代码：确保正确调用Firebase Analytics的日志方法，示例代码：

  Analytics.logEvent("custom_campaign_install", parameters: [
    "campaign_id": "your_campaign_id",
    "campaign_name": "your_campaign_name"
  ])
  

  参数需与广告系列维度匹配，且参数值不能为空。

三、排查归因核心配置 #

• 补充Info.plist配置：添加GADApplicationIdentifier（填入你的Google Ads应用ID），并将FirebaseAppDelegateProxyEnabled设为YES（启用自动归因）。
• 确认IDFA授权状态：确保用户已授权IDFA（ATTrackingManager.requestTrackingAuthorization()返回.authorized），Google Ads归因依赖IDFA，用户拒绝授权会导致归因失效。
• 使用测试设备验证：在Firebase控制台「事件」页面添加测试设备ID，通过Google Ads预览链接安装应用，检查是否能正确关联到目标广告系列。

四、处理数据延迟与控制台显示问题 #

• 等待数据同步：Firebase Analytics的广告系列关联数据通常需要2-24小时才能在控制台显示，避免刚发送事件就立即排查。
• 检查控制台筛选条件：确认时间范围覆盖事件发送时段，且未设置错误的用户群体筛选规则（如排除归因用户）。

五、补全遗漏的依赖与配置 #

• 更新Pod依赖：除Firebase/Analytics和FirebaseCore外，添加Firebase/GoogleAdsAttribution确保归因组件集成完整。
• 核对App Store信息：Firebase项目中填写的App Store ID需与App Store Connect中的一致，Bundle ID也需完全匹配。
• 确认框架集成状态：在Xcode「Build Phases」->「Link Binary With Libraries」中，确保AdSupport.framework已设置为「Embed & Sign」。

内容的提问来源于stack exchange，提问作者Muhammad Salman