Android版Google Analytics（分析）SDK v4应用添加KeyMob广告管理库教

1、开始以前在实现 SDK 以前，请确保已作好如下准备工做：
1:安装Android SDK

2:下载Google Play 服务 SDK

3:至少有一个Google Analytics（分析）媒体资源和应用数据视图（配置文件），以便从应用中向其发送数据。

请注意：Google Analytics（分析）可在不带Google Play服务的设备上使用并正常工做。在这种状况下，您仍需下载并使用Google Play服务 SDK，而Google Analytics（分析）将会自动回退为使用本地调度。

2、开始使用 SDK 有三个步骤：

1:更新 AndroidManifest.xml 2:初始化跟踪器  3:建立配置 XML 文件
本指南使用的是来自Hello World Android app示例应用的代码段。GitHub 上的hello-world-android-app存储区中提供了此项目的完整源代码。

2:完成上述步骤后，您将可使用 Google Analytics（分析）衡量如下内容：
1:应用安装  2:活跃用户和受众特征  3:屏幕和用户互动度  4:崩溃和异常

3、 更新 AndroidManifest.xml
Google Analytics（分析）须要INTERNET和ACCESS_NETWORK_STATE权限。您还能够选择请求WAKE_LOCK权限来提升非 Google Play 设备上调度工做的效率。要使用自定义应用类（如MyApp），则须要在 AndroidManifest 中将其设置为应用名称属性。下面的示例是针对 ApplicationManifest.xml 中常见的 GoogleAnalytics 配置的代码段：

<manifest>

<!-- Google Analytics required permissions -->

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

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

<!-- Optional permission for reliable local dispatching on non-Google Play devices -->

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

<application name="com.example.MyApp">

<!-- Replace with the custom app class when applicable -->

<!-- Add the following meta-data for devices running Google Play service. -->

<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />

<!-- Optionally, register AnalyticsReceiver and AnalyticsService to support background dispatching on non-Google Play devices -->
    
<receiver android:name="com.google.android.gms.analytics.AnalyticsReceiver"
android:enabled="true">

<intent-filter>
<action android:name="com.google.android.gms.analytics.ANALYTICS_DISPATCH" />

</intent-filter>

</receiver>

<service android:name="com.google.android.gms.analytics.AnalyticsService"
android:enabled="true"  android:exported="false"/>

<!-- Optionally, register CampaignTrackingReceiver and CampaignTrackingService to enable installation campaign reporting -->

<receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver" android:exported="true">

<intent-filter>

<action android:name="com.android.vending.INSTALL_REFERRER" />

</intent-filter>

</receiver>

<service android:name="com.google.android.gms.analytics.CampaignTrackingService" />

<!-- ... -->

</application>

</manifest>

应用能够选择在 AndroidManifest.xml 的<application>元素中为全局配置 XML 资源文件提供元数据参考。例如：

<manifest>

<application>

<!-- ... -->

<meta-data android:name="com.google.android.gms.analytics.globalConfigResource"
android:resource="@xml/analytics_global_config" />

<!-- ... -->

</application>

</manifest>

2. 初始化跟踪器
GoogleAnalytics属于顶级的 Google Analytics（分析）单例，为配置 Google Analytics（分析）和建立跟踪器对象提供方法。经过调用getInstance(Context)，应用能够获取此类的实例。

getInstance(Context) 是线程安全的，能够从任何线程对其进行调用。建议在应用生命周期的早期对 Google Analytics（分析）进行初始化，以便正确地报告未处理的异常。咱们推荐在 Application.onCreate()这个位置配置 Google Analytics（分析）。

3:Google Analytics（分析）的基本配置以下所示：

package com.example;

class MyApp extends Application {
  public static GoogleAnalytics analytics;
  public static Tracker tracker;

  @Override
  public void onCreate() {
    analytics = GoogleAnalytics.getInstance(this);
    analytics.setLocalDispatchPeriod(1800);

    tracker = analytics.newTracker("UA-XXXXX-Y"); // Replace with actual tracker/property Id
    tracker.enableExceptionReporting(true);
    tracker.enableAdvertisingIdCollection(true);
    tracker.enableAutoActivityTracking(true);
  }

}

4:启用广告功能
在 Google Analytics（分析）中启用广告功能，便可利用再营销、“受众特征和兴趣”报告等诸多服务。

要启用广告功能，您须要在您的 Google Analytics（分析）跟踪代码中加入一段内容以收集广告 ID。若是您想为某跟踪器启用广告功能，请对该跟踪器调用 enableAdvertisingIdCollection 方法。例如：

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

// Enable Advertising Features.
t.enableAdvertisingIdCollection(true);

该功能会收集广告标识符。在使用该功能时，请务必仔细阅读并严格遵照全部适用的 SDK 政策。

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

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

<resources>

<!-- The application name. Defaults to name specified for the application label -->

<string name="ga_appName">My App</string>

<!-- The application version. Defaults to android:versionName specified in the AndroidManifest.xml -->

<string name="ga_appVersion">1.0</string>

<!-- The dispatching period in seconds when Google Play services is
unavailable. The default period is 1800 seconds or 30 minutes -->

<integer name="ga_dispatchPeriod">1800</integer>

<!-- Enable dry run mode. Default is false -->

<bool name="ga_dryRun">false</bool>

</resources>

请参阅配置参数参考，以了解可用于对实现方案进行配置的参数的完整列表。
您的应用已设置完毕，能够向 Google Analytics（分析）发送数据了。

3、发送事件
要发送事件，请在跟踪器上设置屏幕字段值，而后发送匹配。

下面的示例使用HitBuilders.EventBuilder辅助工具类来建立一个参数映射以传递到send(Map)方法：
GoogleAnalytics analytics = GoogleAnalytics.getInstance(context);

Tracker tracker = analytics.newTracker("UA-XXXX-Y"); // Send hits to tracker id UA-XXXX-Y

// All subsequent hits will be send with screen name = "main screen"
tracker.setScreenName("main screen");

tracker.send(new HitBuilders.EventBuilder()
       .setCategory("UX")
       .setAction("click")
       .setLabel("submit")
       .build());

// Builder parameters can overwrite the screen name set on the tracker.

tracker.send(new HitBuilders.EventBuilder()
       .setCategory("UX")
       .setAction("click")
       .setLabel("help popup")
       .setScreenName("help popup dialog")
       .build());

您 还能够将 Google Analytics（分析）用于其余众多用途，包括衡量广告系列、应用内付款和交易，不只能够处理用户互动事件。还能够用Google Analytics集成KeyMob移动平台，使用KeyMob能够顺利经过应用市场审核；经过KeyMob能够方便的应用交叉推广，设定各个广告平台的 比例和优先顺序，这样就会大大提升综合填充率，再也不浪费任何一次请求；平台随意切。使用Google Analytics 集成KeyMob平台这样作的目的就是让你在收入上面收入步步高升。