谷歌Ads App推广活动referrerUrl未设置及UTM参数异常排查

• 广告后台配置排查
  • 确认你的AdWords账号已和应用对应的Google Play开发者账号完成关联，未关联的账号无法打通广告引流的referrer数据链路
  • 检查App campaign的自动标记开关状态：如果需要使用自定义UTM参数，需在谷歌广告后台关闭「自动标记覆盖手动UTM」的配置；如果使用官方自动标记，不要在广告链接中手动添加UTM参数，两者冲突会导致参数解析失败
  • 确认你创建的广告系列不属于预注册类App campaign，该类型广告的安装转化默认不返回referrer参数，属于官方规则限制
• 客户端逻辑排查
  • 你当前使用的com.android.installreferrer:installreferrer:2.2版本无兼容性问题，需确认referrer的调用时机为应用首次冷启动的第一时间，不要延迟到用户同意隐私权限、完成引导页之后再调用，Play商店的referrer缓存有效期最短仅为几小时，延迟调用会导致缓存过期无法获取
  • 调试阶段临时去掉你配置的「referrer返回not set时标记为organic」的兜底逻辑，直接输出原始返回值，排除本地逻辑误判覆盖正常返回结果的可能
  • 检查是否有其他第三方统计SDK也在调用Install Referrer接口，多个SDK并发调用会导致接口返回错误，建议统一由一个SDK获取referrer后再分发到其他业务模块
• 正常场景排除
  • 用户点击广告后未直接在跳转的Play商店页安装，而是退出后自行搜索应用、通过分享链接等其他渠道二次安装的场景，referrer会自然丢失，属于正常情况
  • 部分定制安卓系统的Google Play服务被裁剪、修改，会拦截referrer的传递，该类设备的问题无法通过客户端配置修复

内容的提问来源于stack exchange，提问作者Vishal Patel