Android端Google Ads应用营销活动DDL无法在GA4F SDK/Install Referrer接收

• GA4F SDK初始化时机
  必须在Application.onCreate()中尽早完成初始化，不能延迟到Activity启动后。若初始化被隐私合规逻辑（如用户同意后才初始化）延迟，可能错过DDL回调触发窗口。需平衡合规要求与SDK启动时机，部分场景下可提前初始化并后续处理隐私授权。

• Google Ads与GA4媒体资源关联
  确认Google Ads账户已绑定对应的GA4媒体资源ID。若广告账户未关联目标GA4资源，DDL数据无法流转到GA4F SDK，导致回调无响应。

• Install Referrer SDK兼容性
  确保集成的Install Referrer SDK为最新稳定版本，且与GA4F SDK的依赖版本匹配。旧版Install Referrer可能无法正确传递DDL参数至GA4F回调。

• 应用签名一致性
  再次核对Google Ads后台配置的应用签名（SHA-1/SHA-256）与测试/发布应用的签名完全一致。测试环境使用调试签名时，需在Google Ads后台额外添加调试签名信息，否则测试场景下DDL无法触发。

• DDL监听逻辑正确性
  检查DeferredDeeplinkListener的实现是否完整，避免回调中因耗时操作或未捕获异常导致逻辑中断。正确的监听实现示例：

  FirebaseAnalytics.getInstance(getApplicationContext()).getDeferredDeeplink(new DeferredDeeplinkListener() {
      @Override
      public void onDeferredDeeplink(@Nullable Uri uri) {
          if (uri != null) {
              // 执行深度链接跳转逻辑
          }
      }
  
      @Override
      public void onDeferredDeeplinkError(@NonNull FirebaseAnalyticsException error) {
          // 记录错误日志便于排查
      }
  });
  

• 广告系列DDL开关状态
  检查目标Google Ads广告系列的设置，确认延迟深度链接功能已单独启用。部分应用安装类广告系列默认关闭该选项，即使账户级配置开启，也需手动开启系列级开关。

• 权限与广告ID配置
  确保应用已声明INTERNET和ACCESS_NETWORK_STATE权限，且未禁用广告ID（AD_ID）的获取。GA4F依赖AD_ID关联广告点击与安装行为，若AD_ID无法正常获取，DDL无法匹配到对应的安装请求。

内容的提问来源于stack exchange，提问作者Joseph Rex