Android版Google Analytics（分析）SDK v4 - 使用入门

本文档将介绍如何开始使用Android版Google Analytics（分析）SDK v4。

开始之前

在实现SDK之前，请确保您已经有：

• 安装Android SDK
• 下载Google Play服务SDK
• 至少一个Google Analytics（分析）媒体资源和应用数据视图（配置文件），以便从应用中向其发送数据。

请注意：SDK可用于没有Google Play服务的设备并正常工作。在这种情况下，SDK将会自动回退为使用本地数据发送。

使用入门

开始使用SDK有三个步骤：

1. 更新AndroidManifest.xml
2. 初始化跟踪器
3. 创建配置XML文件

本指南将会使用来自Google Play服务SDK中附带的Mobile Playground样本应用的代码段。此项目的完整源代码可在以下位置获得：<android-sdk-directory>/extras/google/google_play_services/analytics/mobileplayground。

完成上述步骤后，您将可以使用Google Analytics（分析）衡量以下内容：

• 应用安装
• 活跃用户和受众特征
• 屏幕和用户互动度
• 崩溃和异常

1. 更新AndroidManifest.xml

更新您的AndroidManifest.xml文件，向其中添加以下权限：

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. 初始化跟踪器

使用新版SDK时，开发者需要自行管理跟踪器。为避免过度计量指标，强烈建议您在Application类中创建和管理跟踪器。

在下例中，我们创建了三个跟踪器，分别是APP_TRACKER、GLOBAL_TRACKER、ECOMMERCE_TRACKER。它们在整个应用范围内的用途各不相同。

  /**
   * Enum used to identify the tracker that needs to be used for tracking.
   *
   * A single tracker is usually enough for most purposes. In case you do need multiple trackers,
   * storing them all in Application object helps ensure that they are created only once per
   * application instance.
   */
  public enum TrackerName {
    APP_TRACKER, // Tracker used only in this app.
    GLOBAL_TRACKER, // Tracker used by all the apps from a company. eg: roll-up tracking.
    ECOMMERCE_TRACKER, // Tracker used by all ecommerce transactions from a company.
  }

  HashMap<TrackerName, Tracker> mTrackers = new HashMap<TrackerName, Tracker>();

接下来，Application类提供了一个方法来获取所请求的跟踪器，并在需要时创建跟踪器。请注意，您可以使用analytics.newTracker(PROPERTY_ID)来根据PROPERTY_ID创建跟踪器，也可以使用analytics.newTracker(R.xml.global_tracker)来根据XML资源文件创建跟踪器。

  synchronized Tracker getTracker(TrackerName trackerId) {
    if (!mTrackers.containsKey(trackerId)) {

      GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
      Tracker t = (trackerId == TrackerName.APP_TRACKER) ? analytics.newTracker(PROPERTY_ID)
          : (trackerId == TrackerName.GLOBAL_TRACKER) ? analytics.newTracker(R.xml.global_tracker)
              : analytics.newTracker(R.xml.ecommerce_tracker);
      mTrackers.put(trackerId, t);

    }
    return mTrackers.get(trackerId);
  }

3. 创建配置XML文件

您可以使用XML文件中定义的资源来管理配置设置。例如，如果您有一个全局跟踪器，则可以在项目的res/xml目录中创建一个名为global_tracker.xml的文件，并在其中添加以下资源：

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <integer name="ga_sessionTimeout">300</integer>

    <!-- Enable automatic Activity measurement -->
    <bool name="ga_autoActivityTracking">true</bool>

    <!-- The screen names that will appear in reports -->
    <screenName name="com.google.android.gms.analytics.samples.mobileplayground.ScreenviewFragment">
        AnalyticsSampleApp ScreenView
    </screenName>
    <screenName name="com.google.android.gms.analytics.samples.mobileplayground.EcommerceFragment">
        AnalyticsSampleApp EcommerceView
    </screenName>
    <!--  The following value should be replaced with correct property id. -->
    <string name="ga_trackingId">UA-XXXXXXX-Y</string>
</resources>

您的lint检查工具可能会针对在跟踪ID中使用短划线符号('-')的情况向您发出警告。为此，您可以向<resources>标记添加额外属性来消除此类警告：

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

重要提示：不要对 ga_trackingId字符串中的短划线进行编码。这样做会造成数据无法在报告中显示。

请参阅配置参数参考，以了解可用于对实现方案进行配置的参数的完整列表。

您的应用已设置完毕，可以向Google Analytics（分析）发送数据了。

4. 发送屏幕浏览

要发送屏幕浏览数据，请在跟踪器上设置屏幕字段值，然后发送匹配：

        // Get tracker.
        Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
            TrackerName.APP_TRACKER);

        // Set screen name.
        // Where path is a String representing the screen name.
        t.setScreenName(path);

        // Send a screen view.
        t.send(new HitBuilders.AppViewBuilder().build());

后续步骤

您还可以将Google Analytics（分析）用于其他众多用途，包括衡量广告系列、应用内付款和交易，以及用户互动事件。请参阅以下开发者指南，了解如何在您的实现方案中添加这些功能：

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

本页面中的内容已获得知识共享署名3.0许可，并且代码示例已获得Apache 2.0许可；另有说明的情况除外。有关详情，请参阅我们的网站政策。