Firebase Analytics logEvent在Android 13中不显示的原因及解决方法

常见原因 #

• Android 13 广告ID权限变更：Android 13将AD_ID权限归类为危险权限，未申请该权限时，Firebase Analytics可能无法正常关联用户标识，导致事件无法上报或在控制台展示。
• SDK版本兼容性问题：旧版Firebase Analytics SDK未适配Android 13的权限规则，导致事件上报逻辑异常。
• 控制台延迟或过滤规则：Firebase Analytics控制台的事件展示通常有几分钟到半小时的延迟；若开启了用户/事件过滤规则，也会导致目标事件无法显示。
• 设备隐私限制：Android 13设备开启了「限制广告追踪」，或应用被禁止获取广告ID，会影响Analytics的事件上报与展示。

排查与解决步骤 #

1. 申请AD_ID权限 #

在AndroidManifest.xml中声明权限：

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

Android 13及以上需动态申请该权限：

// Kotlin示例
private val requestAdIdPermissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { isGranted ->
    // 权限申请结果处理，无需额外操作，Firebase会自动适配
}

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.AD_ID) != PackageManager.PERMISSION_GRANTED) {
        requestAdIdPermissionLauncher.launch(Manifest.permission.AD_ID)
    }
}

2. 升级Firebase SDK到兼容版本 #

确保使用适配Android 13的SDK版本（建议21.3.0及以上），在Module级build.gradle中更新：

implementation 'com.google.firebase:firebase-analytics:22.0.0' // 优先使用最新稳定版

同步项目后重新编译运行。

3. 用adb日志验证事件上报状态 #

通过命令行查看Firebase的实时日志，确认事件是否成功上报：

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

如果日志中出现Event recorded字样，说明事件已上报，只需等待控制台同步；若未出现，需检查事件上报代码逻辑。

4. 检查Firebase控制台设置 #

• 进入Analytics页面，确认未开启用户属性过滤或事件过滤，过滤规则可能会隐藏目标事件。
• 开启调试视图：在控制台的Analytics -> 调试视图中，添加当前设备的序列号（通过adb shell getprop ro.serialno获取），可实时查看调试事件，避免控制台延迟影响排查。

5. 检查设备隐私设置 #

在Android 13设备的「设置 -> 隐私 -> 广告」中，关闭「限制广告追踪」选项；若开启该选项，Firebase会限制部分事件的展示。

6. 验证事件上报代码 #

确保初始化与上报逻辑正确：

// 初始化（建议在Application类中执行）
val firebaseAnalytics = FirebaseAnalytics.getInstance(applicationContext)

// 上报事件示例
val eventBundle = Bundle().apply {
    putString(FirebaseAnalytics.Param.ITEM_ID, "test_id_001")
    putString(FirebaseAnalytics.Param.ITEM_NAME, "demo_item")
}
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, eventBundle)

避免使用自定义事件名称时包含特殊字符，确保参数符合Firebase的规则。

内容的提问来源于stack exchange，提问作者Panha Bot