Android 版 Google Analytics（分析）SDK v2（旧版）- 概览

借助 Android 版 Google Analytics（分析）SDK，开发者可以轻松从其应用中收集用户互动数据。本文档将概述此 SDK 的价值，并指导您开始使用单个媒体资源 ID 和 EasyTracker 衡量应用效果。

简介

借助 Android 版 Google Analytics（分析）SDK，开发者可以轻松从其应用中收集用户互动数据。然后，开发者可以使用 Google Analytics（分析）报告来衡量：

  • 使用其应用的活跃用户数量。
  • 使用其应用的用户来自世界上的哪些地方。
  • 特定功能的使用率。
  • 应用内购买和交易。
  • 应用崩溃的次数和类型。
  • 以及许多其他实用指标。

此外，Android 版 Google Analytics（分析）SDK 还可让您端到端地全面了解营销渠道（从 Google Play 安装、应用内购买和交易）的效果，以便监控移动营销广告系列的效果。

准备工作

在开始实现 SDK 之前，请确保您已备妥：

使用入门

开始使用SDK有三个步骤：

  1. 更新 AndroidManifest.xml
  2. 添加 EasyTracker 方法
  3. 创建 analytics.xml 文件

完成上述步骤后，您将可以使用 Google Analytics（分析）衡量以下内容：

  • 应用安装
  • 活跃用户和受众特征
  • 屏幕和用户互动度
  • 崩溃和异常

1. 更新 AndroidManifest.xml

通过添加以下权限更新您的 AndroidManifest.xml 文件：

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

2. 添加 EasyTracker 方法

将 send 方法添加到每个 Activities 的 onStart() 和 onStop() 方法中，如以下示例所示：

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // The rest of your onStart() code.
    EasyTracker.getInstance().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

请注意，EasyTracker 需要先获取 Context，然后才能调用其方法。在上面的示例中，此行：

EasyTracker.getInstance.activityStart(this);

负责设置上下文。不过，如果您需要在其他类或方法中调用 EasyTracker，需要先调用 EasyTracker 的 setContext(Context ctx) 方法：

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. 创建 analytics.xml 文件

在 Android 版 Google Analytics（分析）SDK 版本 2 中，配置选项通过本指南中名为 analytics.xml 的 XML 资源文件进行管理。您需要在项目的 res/values 目录中创建此文件，并添加您的跟踪 ID。以下示例展示了如何添加跟踪 ID 以及启用 Activity 和异常衡量：

<?xml version="1.0" encoding="utf-8" ?>

<resources>
  <!--Replace placeholder ID with your tracking ID-->
  <string name="ga_trackingId">UA-XXXX-Y</string>

  <!--Enable automatic activity tracking-->
  <bool name="ga_autoActivityTracking">true</bool>

  <!--Enable automatic exception tracking-->
  <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

您的 lint 检查工具可能会针对在跟踪 ID 中使用短划线符号 ('-') 的情况向您发出警告。您可以通过向 <resources> 标记添加其他属性来消除该警告：

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

有关可用于配置实现的参数的完整列表，请参阅 analytics.xml 参数参考。

恭喜！您的应用已设置完毕，可以向 Google Analytics（分析）发送数据了。

后续步骤

您可以使用 Google Analytics（分析）执行更多操作，包括衡量广告系列、应用内付款和交易以及用户互动事件。请参阅以下开发者指南，了解如何在您的实现中添加这些功能：

  • 高级配置 – 详细了解高级配置选项，包括如何使用多个跟踪器。
  • 衡量广告系列 – 了解如何实现广告系列衡量功能，以了解是哪些渠道和广告系列推高了应用安装量。
  • 衡量事件 – 了解如何使用事件来衡量用户与互动式内容（例如按钮、视频或其他媒体）的互动度。
  • 衡量应用内付款 – 了解如何衡量应用内付款和交易。
  • 用户计时 – 了解如何在应用中衡量用户计时，以此衡量内容加载时间、媒体互动时间等指标。
  • Analytics.xml 参数 – 查看 analytics.xml 配置参数的完整列表。