本文档介绍了如何开始使用 Android 版 Google Analytics（分析）SDK v3。
准备工作
在实现 SDK 之前，请确保已做好以下准备工作：
- Android 开发者 SDK（适用于 Windows、Mac OS X 和 Linux）
- Android 版 Google Analytics（分析）SDK v3（项目的
/libs目录和 build 路径中包含libGoogleAnalyticsServices.jar） - 一种可用于实现 Google Analytics（分析）的 Android 应用
- 至少一个 Google Analytics（分析）媒体资源和应用数据视图（配置文件），以便从应用中向其发送数据
开始使用
开始使用SDK有三个步骤：
完成上述步骤后，您将可以使用 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 方法
将发送方法添加到每个 Activities 的 onStart() 和 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>
您的跟踪检查工具可能会针对在跟踪 ID 中使用数字短划线 ('-') 而向您发出警告。您可以通过向 <resources> 标记添加其他属性来抑制该警告：
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
有关可用于配置实现的参数的完整列表，请参阅 analytics.xml 参数参考。根据您的应用要求，您可能需要更改调度期，以验证是否正确发送了命中。例如，如果您想查看实时数据，可能需要将此值设为一个较低的值，例如 5s。
恭喜！您的应用已设置完毕，可以向 Google Analytics（分析）发送数据了。
后续步骤
您还可以将 Google Analytics（分析）用于其他众多用途，包括衡量广告系列、应用内付款和交易，以及用户互动事件。
以下开发者指南进一步详述了如何在您的应用中实现 Google Analytics（分析）的各项功能：