Android 版 Google Analytics (分析) SDK 可讓開發人員輕鬆收集應用程式的使用者參與度資料。本文件將概略介紹 SDK 的值,並提供使用單一資源 ID 和 EasyTracker 評估應用程式的指南。
簡介
Android 專用的 Google Analytics (分析) SDK 可讓開發人員輕鬆從自家應用程式收集使用者參與度資料。這樣一來,開發人員就可以使用 Google Analytics (分析) 報表評估以下項目:
- 應用程式的活躍使用者人數。
- 使用這個應用程式到世界各地何處。
- 特定功能的採用和使用情形。
- 應用程式內購和交易。
- 應用程式當機的數量和類型。
- 還有許多其他實用指標
此外,Android 專用的 Google Analytics (分析) SDK 也提供多項工具,讓您透過端對端狀態掌握行銷管道 (從 Google Play 安裝到應用程式內購買及交易) 的行銷管道成效,藉此監控行動行銷廣告活動的成效。
事前準備
開始導入 SDK 之前,請確認您具備:
- Android 開發人員 SDK (適用於 Windows、Mac OS X 和 Linux)
- Android 第 2 版 Google Analytics (分析) SDK (
libGoogleAnalyticsV2.jar
包含在專案的/libs
目錄和建構路徑中) - 可導入 Android 第 2 版 Google Analytics (分析) SDK 的 Android 應用程式。
- 新的 Google Analytics (分析) 應用程式資源和資料檢視 (設定檔)。
入門課程
開始使用 SDK 有三個步驟:
完成這些步驟後,您就能使用 Google Analytics (分析) 評估以下項目:
- 應用程式安裝情形
- 活躍使用者和受眾特徵
- 畫面和使用者參與度
- 當機與例外狀況
1. 更新 AndroidManifest.xml
新增下列權限以更新您的 AndroidManifest.xml 檔案:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. 新增 EasyTracker 方法
將傳送方法新增至每個 Activities
的 onStart()
和 onStop()
方法,如以下範例所示:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
請注意,EasyTracker 需要 Context
才能呼叫其方法。在上述範例中,這一行程式碼會:
EasyTracker.getInstance.activityStart(this);
內容會負責設定上下文不過,如果您需要在其他類別或方法中發出 EasyTracker 呼叫,就必須先呼叫 EasyTracker 的 setContext(Context ctx)
方法:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. 建立 analytics.xml 檔案
在 Android 專用的 Google Analytics (分析) SDK 2 版中,設定選項是透過本指南中名為 analytics.xml
的 XML 資源檔案管理。您需要在專案的 res/values
目錄中建立這個檔案,然後加入追蹤 ID。以下範例說明如何新增追蹤 ID,並啟用 Activity
和例外狀況評估功能:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Lint 檢查工具可能會警告您在追蹤 ID 中使用數字破折號 (「-」)。您可在 <resources>
標記中加入其他屬性,藉此隱藏該警告:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
如需可用來設定導入作業的完整參數清單,請參閱 analytics.xml 參數參考資料。
恭喜!您的應用程式現已設定將資料傳送至 Google Analytics (分析)。
後續步驟
您可以使用 Google Analytics (分析) 執行更多功能,包括評估廣告活動、應用程式內付款和交易,以及使用者互動事件。請參閱下列開發人員指南,瞭解如何將這些功能新增至實作項目:
- 「Advanced Configuration」:進一步瞭解進階設定選項,包括使用多個追蹤器。
- 評估廣告活動:瞭解如何執行廣告活動評估,瞭解哪些管道和廣告活動能夠提高應用程式安裝量。
- 評估事件:瞭解如何使用「事件」功能評估互動式內容 (例如按鈕、影片和其他媒體) 的使用者參與度。
- 評估應用程式應用程式內付款:瞭解如何評估應用程式內付款和交易。
- 使用者時間:瞭解如何評估應用程式中的使用者時間,以評估載入時間、與媒體互動等。
- Analytics.xml 參數:查看
analytics.xml
設定參數的完整清單。