Google Analytics Overview

该文档讨论了如何开始使用Google Analytics SDK for Android v3。

Before you Begin - 在开始之前

         在开始实现SDK之前，请确保有下面的东东：

          1.  安装了Android developer SDK 。

          2.  Google Analytics SDK for Android v3（把它里面的libGoogleAnalyticsServices.jar放置到项目根目录的libs目录下，并把它放入build path）。

          3.  用来实现Google Analytics的Android应用项目。

Getting Started - 开始

         使用SDK有三个步骤：

          1.  更新AndroidMainfest.xml文件：在你应用的Mainfest文件里添加如下权限：

<uses-permission android:name="android.permission.INTERNET" /><!-- 使用网络的权限 -->

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 获取网络状态的权限 -->

          2.  添加EasyTracker方法：在你应用的每个Activity的onStart()和onStop()方法里添加如下所示的方法：

package com.example.app;
import android.app.Activity;
import com.google.analytics.tracking.android.EasyTracker;

/**
 * 使用Google Analytics 和 EasyTracker的示例Activity
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // 你的其它代码
    EasyTracker.getInstance(this).activityStart(this);  // 添加此方法
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // 你的其它代码
    EasyTracker.getInstance(this).activityStop(this);  // 添加此方法
  }
}

         3.  创建你的analytics.xml文件：当你使用EasyTracker类时，使用定义在XML文件里的资源来管理全局的配置设置。在你项目的res/values目录下创建一个名为analytics.xml文件，并在文件里添加如下内容：

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

<resources>

  <!--使用你的跟踪ID替换掉占位符ID-->

  <string name="ga_trackingId">UA-XXXX-Y</string> 

  <!--启用activity自动跟踪-->

  <bool name="ga_autoActivityTracking">true</bool> 

  <!--启用异常自动跟踪-->

  <bool name="ga_reportUncaughtExceptions">true</bool>

</resources>

         在使用和分隔符-的跟踪ID时，你的XML里或许会发现警告信息。如果有警告信息，你可以通过在<resource>标签里添加如下属性来消除警告：

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

         警告：不要对ga_trackingId里的-进行编码。这会导致你报告里不会生成任何数据的。

         在analytics.xml parameters reference 里有你可以用来配置你应用实现的完整参数清单。

         祝贺你，给过上述的步骤，你的应用现在可以把数据发送给Google Analytics了。

Next steps - 接下来的步骤

         使用Google Analytics可以做更多的事情，包括检测活动、应用里的支付和交易、用户交互事件等。下面的开发者指引会告诉你如果在你应用的实现里添加这些元素：

         Advanced Configuration  - 高级配置选项，包括使用多个跟踪。

         Measuring Campaigns  - 实现活动的检测，这样做可以了解是哪些渠道和活动促使着应用的安装。

         Measuring Events - 使用按钮、视频、其它媒体等的事件来检测用户与应用发生的交互内容。

         Measuring In-App Payments  - 在应用里使用支付和交易的检测。

         User timings - 在你应用里定时检测用户的加载时间，参与的媒体等内容。

         Analytics.xml parameters - analytics.xml里配置参数的完整清单。