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平臺這樣作的目的就是讓你在收入上面收入步步高昇。