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

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

2:下载Google Play 服务 SDK

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

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

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

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

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

三、 更新 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（分析）发送数据了。

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

下面的示例使用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平台这样做的目的就是让你在收入上面收入步步高升。