Google Analytics基本參數配置

Google Analytics基本參數配置

官方Guide文檔中Parameters這一節講述了可以在xml中配置的選項，配置方法與範圍稍微有些區別，坑爹的Guide文檔中並沒有描述它們的區別，具體的配置方法我們可以從API文檔中獲取。

官方Guide文檔中的xml配置項

全局配置項：GoogleAnalytics

• 配置res/xml/global_tracker.xml

 <?xml version="1.0" encoding="utf-8" ?>
 <resources>
     <string name="ga_appName">My App</string>
     <string name="ga_appVersion">1.0</string>
     <!-- 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>

• 在AndroidManifest.xml中加入meta-data，並設置爲上述xml

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

• 當然我們也可以在編碼中動態配置，如：

GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
analytics .setLocalDispatchPeriod(1800);
analytics .setDryRun(false);

• 注意官方文檔中ga_logLevel已經被標記爲Deprecated ，使用以下adb指令可打開debug log輸出

adb shell setprop log.tag.GAv4 DEBUG

跟蹤器配置：Tracker

• 配置res/xml/ga_tracker.xml

 <?xml version="1.0" encoding="utf-8" ?>
 <resources>
     <string name="ga_trackingId">UA-0000-1</string>
     <string name="ga_sampleFrequency">100.0</string>
     <integer name="ga_sessionTimeout">1800</integer>
     <bool name="ga_autoActivityTracking">true</bool>
     <bool name="ga_anonymizeIp">false</bool>
     <bool name="ga_reportUncaughtExceptions">true</bool>
     <screenName name="com.example.MainActivity">Home Screen</screenName>
     <screenName name="com.example.SecondActivity">Second Screen</screenName>
 </resources>

• 調用GoogleAnalytics對象的newTracker方法並傳入上述xml，即可完成對單獨tracker的初始化

GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
Tracker tracker = analytics.newTracker(R.xml.ga_tracker);

• 注意：若ga_autoActivityTracking開啓，tracker將實現自動頁面跟蹤，此時我們可以指定頁面與其對應的映射名字，可通過xml配置文件中的<screenName>元素來描述其映射關係。

參考：

https://developers.google.com/android/reference/com/google/android/gms/analytics/GoogleAnalytics
https://developers.google.com/android/reference/com/google/android/gms/analytics/Tracker