此資訊可協助您實作 Android 資料庫並收集生命週期量度 (例如:啟動、升級、工作階段、參與的使用者等等)。
若要下載 SDK,您必須使用 Android 2.2 或更新版本。
請完成下列章節所述的步驟,以設定開發報表套裝,並下載預先填入的設定檔案版本:
下載並解壓縮 [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip
檔案,然後確認您有下列軟體元件:
adobeMobileLibrary.jar
,此元件為搭配 Android 裝置和模擬器使用的資料庫。
ADBMobileConfig.json
,此元件為根據您應用程式自訂的 SDK 設定檔案。
如果您在 Adobe Mobile Services 使用者介面以外的地方下載 SDK,則必須手動設定 ADBMobileConfig.json
檔案。如果您是初次使用 Analytics 和 Mobile SDK,並且想設定開發報表套裝和下載預先填入版本的設定檔案,請參閱開始之前。
IntelliJ IDEA 專案
新增 SDK 和設定檔案至您的專案:
將 ADBMobileConfig.json
檔案新增至專案中的 assets
資料夾。
在專案導覽面板中,以滑鼠右鍵按一下您的專案。
選取開啟模組設定。
在「專案設定」下,選取「資料庫」。
按一下 ]****[!UICONTROL + 圖示即可新增資料庫。
選取「Java」 並導覽至 adobeMobileLibrary.jar
檔案。
選取您計劃使用行動資料庫所在的模組。
按一下「套用」與「確定」,以關閉「模組設定」視窗。
Eclipse 專案
新增 SDK 和設定檔案至您的專案:
ADBMobileConfig.json
檔案新增至專案中的 assets
資料夾。adobeMobileLibrary.jar
。adobeMobileLibrary.jar
。AppMeasurement 資料庫需要下列權限,才能傳送資料及記錄離線追蹤呼叫:
INTERNET
ACCESS_NETWORK_STATE
若要新增這些權限,請在位於應用程式專案目錄的 AndroidManifest.xml
檔案中新增下列行:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
您應在主要活動的 onCreate
方法中新增下列程式碼:
@Override
public void onCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState)
setContentView(R.layout.main);
Config.setContext(this.getApplicationContext());
}
啟用生命週期後,每當您的應用程式啟動時,就會傳送一次點擊以測量啟動數、升級數、工作階段數、參與使用者數,以及許多其他量度。如需詳細資訊,請參閱生命週期量度。
在應用程式的各個活動中完成下列步驟:
匯入資料庫:
import com.adobe.mobile.*;
在 onResume
函式中,啟動生命週期資料集合:
@Override
public void onResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}
在 onPause
函式中,暫停生命週期資料集合:
@Override
public void onPause() {
Config.pauseCollectingLifecycleData();
}
您必須新增此類呼叫至所有活動,以確保當機報告準確。如需詳細資訊,請參閱追蹤應用程式當機。
若要納入其他資料與生命週期量度呼叫,請將其他參數傳遞至包含內容資料的 collectLifecycleData
:
@Override
public void onResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}
與 collectLifecycleData
一併傳送的其他內容資料值,必須對應至 Adobe Mobile Services 中的自訂變數:
系統會自動收集其他生命週期量度。如需詳細資訊,請參閱生命週期量度。
完成下列作業: