适用于 Android 的 Google Analytics(分析)SDK v3(旧版)- 使用入门

本文档将介绍如何开始使用 Android 版 Google Analytics(分析)SDK v3。

准备工作

在实现 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 方法添加到每个 ActivitiesonStart()onStop() 方法中,如以下示例所示:

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

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

3. 创建 analytics.xml 文件

当您使用 EasyTracker 时,可以使用 XML 中定义的资源管理全局配置设置。在项目的 res/values 目录中创建一个名为 analytics.xml 的文件,并添加以下资源:

<?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 参数参考。根据您的应用要求,您可能希望更改调度周期,以验证是否正确发送命中。例如,如果您想要查看实时数据,则可能需要将其设置为较低的值(例如 5s)。

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

后续步骤

您还可以将 Google Analytics(分析)用于其他众多用途,包括衡量广告系列、应用内付款和交易,以及用户互动事件。

以下开发者指南进一步详述了如何在您的应用中实现 Google Analytics(分析)的各项功能:

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