事件跟踪

本开发者指南将介绍如何使用 Android 版 Google Analytics(分析)SDK v4 来衡量您的应用中的事件。

概览

事件是一种实用的工具,可帮助您衡量用户与您的应用中的互动式组件的互动情况,例如按钮点击或游戏中某个道具的使用情况。

每个事件由 4 个字段组成,您可以使用这些字段来描述用户与您的应用内容的互动:

字段名称 类型 是否必需 说明
Category String 事件类别
Action String 事件操作
Label String 事件标签
Value Long 事件值

实现

要向 Google Analytics(分析)发送事件,请使用 HitBuilders.EventBuilder 并发送匹配,如下例所示:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setLabel(getString(labelId))
    .build());

请参见高级配置,详细了解 getTracker 方法。

非互动事件

在某些情况下,您可能需要将某个事件作为非互动事件发送。为此,请将 true 传递到 setNonInteraction

t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setNonInteraction(true)
    .build());

要详细了解非互动匹配以及何时使用这些匹配,请参阅 Google Analytics(分析)帮助中心中的非互动事件