Google Play发布排障：集成AppsFlyer时AD_ID权限缺失问题求助

问题背景 #

• 集成AppsFlyer SDK后，SDK通过清单合并自动添加com.google.android.gms.permission.AD_ID权限
• 已在Google Play应用内容板块完成Advertising ID声明
• 上传AAB时收到Google权限检测报错，提示某活动组件清单缺失AD_ID权限；生产环境中广告ID被置为全0，导致AppsFlyer将非自然安装误判为自然安装
• 反编译AAB确认权限存在，手动在源码清单声明权限后问题仍未解决

错误提示 #

Play控制台中已声明应用使用广告ID，但其中一个活动组件的清单文件缺少com.google.android.gms.permission.AD_ID权限。若不添加该权限，广告ID将被替换为一串0，这会干扰广告展示和统计收集，还可能造成收入损失。

此外，Android 13（API level 33）应用若无AD_ID权限，广告ID会被置0，可能影响广告展示和统计。

解决方案 #

• 排查清单合并冲突
  检查所有模块的AndroidManifest.xml，确认是否有第三方SDK或自定义配置通过tools:node="remove"移除了AD_ID权限：

  <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove" />
  

  若存在该代码，删除或改为tools:node="merge"以保留权限。

• 给目标活动显式绑定权限
  针对检测报错的活动组件，在其声明块内显式添加AD_ID权限声明（全局权限绑定到组件可绕过部分检测逻辑）：

  <activity
      android:name=".YourProblematicActivity"
      android:exported="true">
      <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
  </activity>
  

• 检查构建变体的动态配置
  确认release构建类型的build.gradle中，没有通过manifestPlaceholders或脚本动态移除权限：

  android {
      buildTypes {
          release {
              // 排查是否有类似动态移除逻辑
              manifestPlaceholders += [adIdPermission: "remove"]
          }
      }
  }
  

  若存在相关配置，调整为保留AD_ID权限的逻辑。

• 强制权限合并策略
  在主AndroidManifest.xml中手动声明AD_ID权限，并添加tools:replace属性强制覆盖所有模块的冲突配置：

  <uses-permission
      android:name="com.google.android.gms.permission.AD_ID"
      tools:replace="android:name" />
  

• 更新AppsFlyer SDK
  旧版本SDK可能存在清单合并逻辑缺陷，升级至官方最新版SDK，确保权限正确注入最终AAB包。

• 使用Play预扫描工具定位问题
  上传前通过Play控制台的「预发布报告」或「应用完整性」工具扫描AAB，精准定位触发报错的活动组件，针对性调整配置。

内容的提问来源于stack exchange，提问作者fisting billy