本文档介绍了旧版 Android SDK。如果您是刚接触 Analytics(分析)的新手,请使用最新的 SDK。了解详情

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 方法

将发送方法添加到每个 ActivitiesonStart()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 中,配置选项通过 XML 资源文件(在本指南中称为 analytics.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>

您的跟踪检查工具可能会针对在跟踪 ID 中使用数字短划线 ('-') 而向您发出警告。您可以通过向 <resources> 标记添加其他属性来抑制该警告:

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

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

恭喜!您的应用已设置完毕,可以向 Google Analytics(分析)发送数据了。

后续步骤

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

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