借助 Android 版 Google Analytics（分析）SDK，开发者可以轻松从应用中收集用户互动度数据。本文档将概括介绍 SDK 的价值，并介绍如何开始使用单个媒体资源 ID 和 EasyTracker 来衡量您的应用。
简介
借助 Android 版 Google Analytics（分析）SDK，开发者可以轻松从其应用中收集用户互动度数据。然后，开发者可以使用 Google Analytics（分析）报告来衡量：
- 使用其应用的活跃用户数量。
- 使用其应用的用户来自世界上的哪些地方。
- 特定功能的使用率。
- 应用内购买和交易。
- 应用崩溃的次数和类型。
- 以及其他许多实用指标。
此外，Android 版 Google Analytics（分析）SDK 提供了各种工具来帮助您端到端地了解您的营销渠道（从 Google Play 安装到应用内购买和交易）的效果，从而监控移动营销广告系列的效果。
准备工作
在开始实现 SDK 之前，请确保您已做好以下准备：
- Android 开发者 SDK（适用于 Windows、Mac OS X 和 Linux）
- Android 版 Google Analytics（分析）SDK v2（项目的
/libs目录和构建路径中包含libGoogleAnalyticsV2.jar） - 可用于实现 Android 版 Google Analytics（分析）SDK v2 的 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() 方法中，如以下示例所示：
/**
* 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（分析）执行更多操作，包括衡量广告系列、应用内付款和交易以及用户互动事件。请参阅以下开发者指南，了解如何将这些功能添加到您的实现中：