如何通过Google Analytics API存储用户ID并修复Android应用追踪异常？

看起来你遇到了GA配置和用户追踪的双重问题，我帮你拆解下核心问题和解决方案：

一、先修复致命的配置文件错误 #

你的global_tracker.xml完全写错了格式，GA SDK需要的是ga_trackingId作为键名，值填你的UA-ID。原来的写法会导致SDK根本无法初始化，这也是为什么你的checkConfiguration()会返回false，弹出"bad config"提示。

正确的配置应该是：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="ga_trackingId" translatable="false">UA-112531272-1</string>
</resources>

二、正确设置用户ID，实现按用户统计 #

你现在用自定义字段User来标记用户，但GA官方有专门的用户ID关联方法，用它才能在后台按用户ID查看使用频率、会话记录。同时你误用了几个API，我帮你修正代码：

private void sendScreenImageName() {
    String userAcno = preferences.getString("acno", "");
    
    // 屏幕名称建议保留类名+用户标识，方便后续排查问题
    mTracker.setScreenName("Image~" + getLocalClassName() + "~User:" + userAcno);
    // 应用版本建议在Application初始化时统一设置，不用每次发送都重复设置
    mTracker.setAppVersion(getString(R.string.appVersion));
    
    // 关键：用官方setUserId()方法绑定用户，GA会自动关联该用户的所有会话和事件
    mTracker.setUserId(userAcno);
    
    // 发送屏幕视图请求
    mTracker.send(new HitBuilders.ScreenViewBuilder().build());
    
    // 下面这行要删掉！setAppInstallerId是用来记录应用安装渠道的（比如Google Play），别用用户ID覆盖
    // mTracker.setAppInstallerId(userAcno);
}

另外注意：不要修改setClientId()，这个ID是GA用来识别设备的唯一标识，强行替换成用户ID会导致同一用户多设备的数据混乱，或者不同用户的数据被错误合并。

三、排查追踪功能失效的其他原因 #

除了配置错误，还有几个关键点要检查：

1. 确认Application类初始化正确 #

你的AnalyticsApplication必须正确初始化Tracker，并且启用自动会话追踪，示例代码如下：

public class AnalyticsApplication extends Application {
    private Tracker mTracker;

    synchronized public Tracker getDefaultTracker() {
        if (mTracker == null) {
            GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
            // 从修复后的global_tracker.xml加载配置
            mTracker = analytics.newTracker(R.xml.global_tracker);
            // 启用自动Activity会话追踪，这是保证会话统计准确的关键
            analytics.enableAutoActivityReports(this);
        }
        return mTracker;
    }
}

同时要在AndroidManifest.xml里注册这个Application，并且添加必要权限：

<application
    android:name=".AnalyticsApplication"
    ...>
    <!-- 其他组件配置 -->
</application>

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. 修正checkConfiguration()的逻辑错误 #

你原来的检查函数逻辑完全反了：如果找到正确的UA-ID，它会返回false，导致正确配置时反而弹出"bad config"。修正后的版本：

private boolean checkConfiguration() {
    XmlResourceParser parser = getResources().getXml(R.xml.global_tracker);
    boolean foundGaTag = false;
    try {
        while (parser.getEventType() != XmlResourceParser.END_DOCUMENT) {
            if (parser.getEventType() == XmlResourceParser.START_TAG) {
                String tagName = parser.getName();
                String nameAttr = parser.getAttributeValue(null, "name");
                // 标记找到ga_trackingId标签
                foundGaTag = "string".equals(tagName) && "ga_trackingId".equals(nameAttr);
            }
            if (parser.getEventType() == XmlResourceParser.TEXT && foundGaTag) {
                String trackingId = parser.getText().trim();
                // 验证追踪ID是否正确
                return "UA-112531272-1".equals(trackingId);
            }
            parser.next();
        }
    } catch (Exception e) {
        Log.w("config", "checkConfiguration failed", e);
        return false;
    }
    // 没找到ga_trackingId标签
    return false;
}

3. GA后台验证 #

• 先确认你的UA-ID在GA后台是活跃状态，没有被停用。
• 测试时可以看GA的实时报告（实时>概览），操作应用后如果能看到实时数据，说明追踪已经正常工作。常规报告可能有1-24小时的延迟，别着急。

四、验证用户ID统计 #

修复完成后，等待几个小时，你可以在GA后台的受众>用户资源管理器里，按用户ID查看单个用户的会话次数、使用时长、访问页面等数据，实现按用户维度统计使用频率的需求。

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