Android Firebase接入（一）--Firebase埋点（Analytics）

最新推荐文章于 2025-07-08 01:00:17 发布

Vic_wkx

最新推荐文章于 2025-07-08 01:00:17 发布

阅读量2.4w

点赞数 10

CC 4.0 BY-SA版权

分类专栏： Firebase 文章标签： Firebase埋点 Android Firebase Firebase Analytics Android埋点应用内数据上报

本文链接：https://blog.youkuaiyun.com/AlpinistWang/article/details/87369279

Firebase 专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍如何在Android应用中使用Firebase进行事件、用户属性和屏幕视图的埋点，包括配置步骤、依赖导入及示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

简介

埋点是指在app中添加数据上报，相当于在app中打印Log并保存，在app内需要的位置埋点可以帮助分析用户的行为和喜好，以便改进产品。

接入

一、配置Android应用并下载google-service.json文件

配置步骤见本系列第一篇文章:Android Firebase接入（序）–Firebase简介以及Firebase官方Demo的使用中的 “配置Android应用并下载google-service.json文件”

二、导入Firebase依赖库

项目级 build.gradle（<项目>/build.gradle）：添加classpath

buildscript {
    dependencies {
        ...    
        classpath 'com.google.gms:google-services:4.1.0'
    }
}

应用级 build.gradle（<项目>/<应用模块>/build.gradle），添加

dependencies {
    ...
    implementation 'com.google.firebase:firebase-core:16.0.1'
}
apply plugin: 'com.google.gms.google-services'

三、埋点

Firebase打点有三种类型：
1.event：最常用的类型，key-value键值对，value是bundle参数
2.user_property：用户属性
3.screen_view：屏幕属性

1.打印event

在布局中添加按钮：

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn_event"
        android:text="Event"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</android.support.constraint.ConstraintLayout>

在MainActivity中：

public class MainActivity extends AppCompatActivity implements View.OnClickListener{
    private Button btnEvent;

    private FirebaseAnalytics mFirebaseAnalytics;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //初始化Firebase
        mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
        bindView();
    }

    private void bindView() {
        btnEvent = (Button) findViewById(R.id.btn_event);
        btnEvent.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_event:
                //点击进行事件上报
                Bundle bundleEvent = new Bundle();
                bundleEvent.putLong("click_time",System.currentTimeMillis());
                bundleEvent.putString("key","value");
                mFirebaseAnalytics.logEvent("click_event",bundleEvent);
                break;
        }
    }
}

这样就埋点成功了，打点不是实时的，意味着你点击了按钮不能马上在Firebase控制台看到数据。而是在24小时之内才能看到数据。

如果在开发时想要看到实时的打点数据，可以使用DebugView，在Firebase控制台的这个位置：

使用DebugView需要在手机上启动调试模式

要在手机上启用 Analytics（分析）“调试”模式，请执行以下命令行：<package_name>填入app的包名

adb shell setprop debug.firebase.analytics.app <package_name>

“调试”模式将保持启用状态，直至您通过执行以下命令行明确停用“调试”模式：

adb shell setprop debug.firebase.analytics.app .none.

开启了调试模式之后，点击按钮后30秒内可以在DebugView中看到打点事件：

点击对应的事件可以看到参数列表：

可以看到我们的click_time和key参数都打出来了

2.打印用户属性

先在Firebase控制台新建用户属性：

填入属性字段名和简短描述：

这样就新建属性成功了。然后在程序中添加打印属性按钮：

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn_event"
        android:text="Event"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/btn_user_property"
        android:text="USER PROPERTY"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@id/btn_event"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    
</android.support.constraint.ConstraintLayout>

在MainActivity中：

public class MainActivity extends AppCompatActivity implements View.OnClickListener{
    private Button btnEvent;
    private Button btnUserProperty;

    private FirebaseAnalytics mFirebaseAnalytics;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //初始化Firebase
        mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
        bindView();
    }

    private void bindView() {
        btnEvent = (Button) findViewById(R.id.btn_event);
        btnUserProperty = (Button) findViewById(R.id.btn_user_property);
        btnEvent.setOnClickListener(this);
        btnUserProperty.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_event:
                //点击进行事件上报
                Bundle bundleEvent = new Bundle();
                bundleEvent.putLong("click_time",System.currentTimeMillis());
                bundleEvent.putString("key","value");
                mFirebaseAnalytics.logEvent("click_event",bundleEvent);
                break;
            case R.id.btn_user_property:
                //点击进行用户属性上报
                mFirebaseAnalytics.setUserProperty("property","user_property");
                break;
        }
    }
}

这样就可以打印用户属性了，不过Firebase新建属性后，几个小时后才能将属性显示在数据报告中。所以不能实时的看到打印出用户属性。Firebase提供了一个UserId的属性，可以直接使用：

在程序中设置userId属性：

//设置userId属性
mFirebaseAnalytics.setUserId("testUserId");

在Firebase控制台的DebugView可以看到user_id属性已经设置上了：

3.打印当前屏幕：

在布局中添加按钮：

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn_event"
        android:text="Event"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/btn_user_property"
        android:text="USER PROPERTY"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@id/btn_event"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/btn_current_screen"
        android:text="CURRENT SCREEN"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@id/btn_user_property"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</android.support.constraint.ConstraintLayout>

MainActivity中：

public class MainActivity extends AppCompatActivity implements View.OnClickListener{
    private Button btnEvent;
    private Button btnUserProperty;
    private Button btnCurrentScreen;

    private FirebaseAnalytics mFirebaseAnalytics;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //初始化Firebase
        mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
        bindView();
    }

    private void bindView() {
        btnEvent = (Button) findViewById(R.id.btn_event);
        btnUserProperty = (Button) findViewById(R.id.btn_user_property);
        btnCurrentScreen = (Button) findViewById(R.id.btn_current_screen);
        btnEvent.setOnClickListener(this);
        btnUserProperty.setOnClickListener(this);
        btnCurrentScreen.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_event:
                //点击进行事件上报
                Bundle bundleEvent = new Bundle();
                bundleEvent.putLong("click_time",System.currentTimeMillis());
                bundleEvent.putString("key","value");
                mFirebaseAnalytics.logEvent("click_event",bundleEvent);
                break;
            case R.id.btn_user_property:
                //设置userId属性
                mFirebaseAnalytics.setUserId("testUserId");
                //点击进行用户属性上报
                mFirebaseAnalytics.setUserProperty("property","user_property");
                break;
            case R.id.btn_current_screen:
                //点击进行当前屏幕上报
                mFirebaseAnalytics.setCurrentScreen(MainActivity.this,MainActivity.class.getSimpleName(),"onClick");
                break;
        }
    }
}

这样就将屏幕上报设置成功了，屏幕上报也不是实时的，24小时之内可以看到打点结果。一般的做法是将打印当前屏幕的点埋在onResume中，本例写在点击事件中只是为了演示用法。

附：Firebase打点工具类

public class DataReportUtils {

    private static volatile DataReportUtils instance;
    private static FirebaseAnalytics mFirebaseAnalytics;

    public static DataReportUtils getInstance() {
        if (instance == null) {
            instance = new DataReportUtils();
        }
        return instance;
    }

    private DataReportUtils() {
        mFirebaseAnalytics = FirebaseAnalytics.getInstance(RxRetrofitApp.getApplication());
    }

    /**
     * 埋点
     *
     * @param key
     * @param value
     */
    public void report(String key, Bundle value) {
        if (value == null) {
            value = new Bundle();
        }
        mFirebaseAnalytics.logEvent(key, value);
    }

    /**
     * 埋点
     *
     * @param key
     */
    public void report(String key) {
        report(key, null);
    }

}

在项目中直接使用：

// 1.携带参数的打点
Bundle values = new Bundle();
values.putString("测试数据的key","测试数据的value");
values.putInt("测试整型数据的key",666);
DataReportUtils.getInstance().report("打点key名",values);
// 2.不携带参数的打点
DataReportUtils.getInstance().report("不携带参数的打点key名");