自定义维度和指标

本开发者指南介绍了如何使用 Android 版 Google Analytics(分析)SDK v4 实现自定义维度和指标。

概览

您可以:

自定义维度和指标包含两个字段:

字段名称 类型 说明
索引 Integer 自定义维度或指标的索引。此索引值以 1 起始。
String 自定义维度或指标的值。对于指标而言,此值会被解析为整数(如果指标被配置为货币类型,则值会解析为固定位数的小数值)。

设置和发送值

要设置和发送自定义维度值,请使用以下代码:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

自定义维度值可以随任何 Google Analytics(分析)命中类型发送,包括屏幕浏览、事件、电子商务交易、用户计时和社交互动。在数据处理过程中,自定义维度的范围定义将会决定哪些命中会与该维度值相关联。

要设置和发送自定义指标值,请使用以下代码:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

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

实现方面的注意事项

本节将简略介绍在实现自定义维度或指标的过程中需要注意的一些额外事项。

自定义维度的注意事项

范围为用户级或会话级的值将会应用于过去的命中

  • 范围为用户级或会话级的自定义维度值将会应用于当前会话的所有命中,包括之前的命中。如果您不希望范围为会话级或用户级的自定义维度值应用到当前会话中之前的命中,请在向命中应用该值之前开始一个新会话
  • 例如,如果您使用“会员类型”作为用户级自定义维度,而某位用户在会话过程中升级了其会员类型,您就可能想要在设置新的自定义维度值之前开始一个新会话。这可确保升级之前的命中与旧的会员类型值相关联,而新的命中则与新的值相关联。

自定义维度和数据视图(配置文件)过滤器

  • 即使一起发送的命中从数据视图(配置文件)中被滤除,用户或会话级自定义维度值仍然将与当前和/或将来会话中的所有命中相关联。
  • 如果根据自定义维度值来进行过滤,则对命中的过滤将会以相应自定义维度值的范围为依据。 详细了解过滤器和自定义维度值如何在处理您数据的过程中相互影响。

自定义指标的注意事项

自定义指标值会在报告中汇总

  • 与 Google Analytics(分析)中其他预定义的指标一样,自定义指标值会在报告中汇总。因此,如果要将您报告中的指标汇总值增加 1,您就要设置一个自定义指标值 1

自定义指标和数据视图(配置文件)过滤器

在使用自动屏幕衡量的情况下设置值

  • 要将自定义维度值应用到在使用自动屏幕衡量的情况下发送的屏幕浏览命中,请在 onStart() 期间调用 activityStart() 之前设置该值。请注意,如果值在 onStart() 执行时尚不明确,则建议您改用手动屏幕衡量。

请勿在值中发送任何个人身份信息

  • Google Analytics(分析)服务条款禁止向 Google Analytics(分析)服务器发送任何个人身份信息 (PII)。如需了解详情,请参阅服务条款