該文檔討論瞭如何開始使用Google Analytics SDK for Android v3。html
Before you Begin - 在開始以前android
在開始實現SDK以前,請確保有下面的東東:網絡
1. 安裝了Android developer SDK 。app
2. Google Analytics SDK for Android v3(把它裏面的libGoogleAnalyticsServices.jar放置到項目根目錄的libs目錄下,並把它放入build path)。ide
3. 用來實現Google Analytics的Android應用項目。ui
Getting Started - 開始this
使用SDK有三個步驟:google
1. 更新AndroidMainfest.xml文件:在你應用的Mainfest文件裏添加以下權限:編碼
<uses-permission android:name="android.permission.INTERNET" /><!-- 使用網絡的權限 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 獲取網絡狀態的權限 -->
2. 添加EasyTracker方法:在你應用的每一個Activity的onStart()和onStop()方法裏添加以下所示的方法:spa
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * 使用Google Analytics 和 EasyTracker的示例Activity */
public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // 你的其它代碼
EasyTracker.getInstance(this).activityStart(this); // 添加此方法
} @Override public void onStop() { super.onStop(); ... // 你的其它代碼
EasyTracker.getInstance(this).activityStop(this); // 添加此方法
} }
3. 建立你的analytics.xml文件:當你使用EasyTracker類時,使用定義在XML文件裏的資源來管理全局的配置設置。在你項目的res/values目錄下建立一個名爲analytics.xml文件,並在文件裏添加以下內容:
<?xml version="1.0" encoding="utf-8" ?>
<resources>
<!--使用你的跟蹤ID替換掉佔位符ID-->
<string name="ga_trackingId">UA-XXXX-Y</string>
<!--啓用activity自動跟蹤-->
<bool name="ga_autoActivityTracking">true</bool>
<!--啓用異常自動跟蹤-->
<bool name="ga_reportUncaughtExceptions">true</bool>
</resources>
在使用和分隔符-的跟蹤ID時,你的XML裏或許會發現警告信息。若是有警告信息,你能夠經過在<resource>標籤裏添加以下屬性來消除警告:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
警告:不要對ga_trackingId裏的-進行編碼。這會致使你報告裏不會生成任何數據的。
在analytics.xml parameters reference 裏有你能夠用來配置你應用實現的完整參數清單。
祝賀你,給過上述的步驟,你的應用如今能夠把數據發送給Google Analytics了。
Next steps - 接下來的步驟
使用Google Analytics能夠作更多的事情,包括檢測活動、應用裏的支付和交易、用戶交互事件等。下面的開發者指引會告訴你若是在你應用的實現裏添加這些元素:
Advanced Configuration - 高級配置選項,包括使用多個跟蹤。
Measuring Campaigns - 實現活動的檢測,這樣作能夠了解是哪些渠道和活動促使着應用的安裝。
Measuring Events - 使用按鈕、視頻、其它媒體等的事件來檢測用戶與應用發生的交互內容。
Measuring In-App Payments - 在應用裏使用支付和交易的檢測。
User timings - 在你應用裏定時檢測用戶的加載時間,參與的媒體等內容。
Analytics.xml parameters - analytics.xml裏配置參數的完整清單。