求最新Android端Google Analytics 4自定义事件实现方案与示例

一、代码实现（Java/Kotlin） #

前提准备 #

确保项目已集成GA4 Android SDK，在app模块的build.gradle中添加依赖：

implementation "com.google.android.gms:play-services-analytics:18.0.2"

同时在AndroidManifest.xml中添加必要权限：

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

1. 初始化Tracker实例 #

Java代码

import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.Tracker;

public class MyApp extends Application {
    private Tracker mTracker;

    synchronized public Tracker getDefaultTracker() {
        if (mTracker == null) {
            GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
            // 替换为你的GA4测量ID（格式：G-XXXXXXXXXX）
            mTracker = analytics.newTracker("G-XXXXXXXXXX");
            // 启用自动屏幕跟踪（可选）
            mTracker.enableAutoActivityTracking(true);
        }
        return mTracker;
    }
}

Kotlin代码

import com.google.android.gms.analytics.GoogleAnalytics
import com.google.android.gms.analytics.Tracker

class MyApp : Application() {
    private var mTracker: Tracker? = null

    @Synchronized
    fun getDefaultTracker(): Tracker? {
        if (mTracker == null) {
            val analytics = GoogleAnalytics.getInstance(this)
            // 替换为你的GA4测量ID
            mTracker = analytics.newTracker("G-XXXXXXXXXX")
            mTracker?.enableAutoActivityTracking(true)
        }
        return mTracker
    }
}

2. 发送带自定义参数的自定义事件 #

Java代码

import com.google.android.gms.analytics.HitBuilders;

// 在Activity/Fragment中获取Tracker
Tracker tracker = ((MyApp) getApplication()).getDefaultTracker();

// 构建并发送自定义事件
tracker.send(new HitBuilders.EventBuilder()
        .setCategory("Product") // 事件类别
        .setAction("product_view") // GA4事件名称
        .setLabel("Product Detail Page") // 事件标签（可选）
        .setCustomDimension(1, "PROD_12345") // 自定义参数1（对应后台自定义维度索引1）
        .setCustomMetric(1, 199.99f) // 自定义数值参数（对应后台自定义指标索引1）
        .build());

Kotlin代码

import com.google.android.gms.analytics.HitBuilders

// 在Activity/Fragment中获取Tracker
val tracker = (application as MyApp).defaultTracker

// 构建并发送自定义事件
tracker?.send(HitBuilders.EventBuilder()
    .setCategory("Product")
    .setAction("product_view")
    .setLabel("Product Detail Page")
    .setCustomDimension(1, "PROD_12345")
    .setCustomMetric(1, 199.99f)
    .build())

二、GA4后台自定义定义配置步骤 #

1. 登录GA4管理后台，进入目标媒体资源
2. 左侧菜单栏选择自定义定义，点击创建自定义维度或创建自定义指标
3. 创建自定义维度（用于字符串型参数）：
   • 填写维度名称（如"Product ID"）
   • 选择范围为事件（匹配代码中事件级别的参数）
   • 记录该维度的索引（如1），需与代码中setCustomDimension(index, value)的索引一致
   • 保存配置
4. 创建自定义指标（用于数值型参数）：
   • 填写指标名称（如"Product Price"）
   • 选择指标类型（浮点数/整数）和格式类型（如货币）
   • 选择范围为事件
   • 记录该指标的索引（如1），需与代码中setCustomMetric(index, value)的索引一致
   • 保存配置
5. 注意：自定义定义创建后，通常需要24小时左右才能在GA4报表中看到对应的数据

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