Google 分析 SDK 之渠道统计

前言

这篇文章是一个老司机写的，并不是我写的，老司机工作经验丰富，为人也比较污。我是授权发布的。

本次博客介绍了如何将 Google Analytics（渠道统计）添加到您的 Android 应用中去统计我们广告投放或渠道合作带来的效果，简单的理解就是了解哪些广告系列和流量来源将用户引荐到 Google Play 商店下载您的应用。如果您仅仅想了解一下 Google Analytics（分析）的工作原理，请参阅官方的示例应用。

SDK版本

Google Analytics SDK v4 (必需:最新版Android Studio和Google Play服务)

配置项目

1.更新您的AndroidManifest.xml文件 使其包括以下内容

权限(必选)

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

注册组件（渠道统计必选）

<!-- Used for Google Play Store Campaign Measurement--><service android:name="com.google.android.gms.analytics.CampaignTrackingService" /><receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"android:exported="true"   android:permission="android.permission.INSTALL_PACKAGES">  <intent-filter>    <action android:name="com.android.vending.INSTALL_REFERRER" />  </intent-filter></receiver>

2.添加配置文件及google 服务插件

Google 服务插件会解析 google-services.json 文件中的配置信息。通过更新您的项目一级 build.gradle 和应用一级 build.gradle 文件来将该插件添加到您的项目中，具体操作如下所示：

将下面的依赖关系添加到您的项目一级 build.gradle 中：

classpath 'com.google.gms:google-services:1.5.0-beta2'

将下面的插件添加到您的应用一级 build.gradle 中：

apply plugin: 'com.google.gms.google-services'

在您的应用一级或公共库的build.gradle文件中添加谷歌分析SDK

compile 'com.google.android.gms:play-services-analytics:8.4.0'

此外您还需要去获取配置文件获取配置文件（google-services.json）放到您应用的根目录下 (可向运营同事去申请获取)。

代码实现

您应该将 Application 纳入子类并提供一个可返回应用跟踪器的辅助方法。可参考下面代码

  private Tracker mTracker;  /**   * Gets the default {@link Tracker} for this {@link Application}.   * @return tracker   */  synchronized public Tracker getDefaultTracker() {    if (mTracker == null) {      GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);      // To enable debug logging use: adb shell setprop log.tag.GAv4 DEBUG      mTracker = analytics.newTracker(R.xml.global_tracker);     //以下选填      mTracker.enableAdvertisingIdCollection(true); //自动收集广告用户信息      mTracker.enableAutoActivityTracking(true);//开启页面访问    }    return mTracker;  }

实现渠道统计的大致原理

当您的应用在 Google Play 商店中被下载时，Play 商店应用会在您的应用安装期间向其广播一条 INSTALL_REFERRER Intent。此 Intent 中包含 referrer 参数的值（如果有），此参数来自将用户引荐到您应用的 Google Play 商店页面的链接。为了将某次应用下载归因到某个广告系列，您需要在指向 Google Play 商店的所有链接中添加 referrer 参数，并在您的应用中添加一个 BroadcastReceiver，以便使用您的 Google Analytics（分析）跟踪器来接收并设置 Intent 中所包含的广告系列信息。我们建议大多数开发者使用 SDK 中提供的 BroadcastReceiver。要使用此内置接收器实现 Google Play 商店广告系列衡量功能，因此需要 AndroidManifest.xml 文件中添加接收器（阅读上面的注册组件）。所以运营推广的地址是需要生成的。请参考参考资料中的《Google Play 网址生成工具》。

测试

adb shell am broadcast -a com.android.vending.INSTALL_REFERRER -n “您的包名/com.google.android.gms.analytics.CampaignTrackingReceiver" --es referrer "'utm_source=testSource&utm_medium=testMedium&utm_term=testTerm&utm_content=testContent&utm_campaign=testCampaign'"

参考资料

将 Google Analytics（分析）添加到 Android 应用中

Google Play 广告系列归因

测试 Google Play 广告系列归因解决方案指南

Google Play 网址生成工具