核心實作與生命週期。

此資訊可協助您實作 Android 資料庫並收集生命週期量度 (例如:啟動、升級、工作階段、參與的使用者等等)。

下載 SDK

重要

若要下載 SDK,您必須使用 Android 2.2 或更新版本。

  1. 請完成下列章節所述的步驟,以設定開發報表套裝,並下載預先填入的設定檔案版本:

  2. 下載並解壓縮 [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip 檔案,然後確認您有下列軟體元件:

    • adobeMobileLibrary.jar,此元件為搭配 Android 裝置和模擬器使用的資料庫。

    • ADBMobileConfig.json,此元件為根據您應用程式自訂的 SDK 設定檔案。

    重要

    如果您在 Adobe Mobile Services 使用者介面以外的地方下載 SDK,則必須手動設定 ADBMobileConfig.json 檔案。如果您是初次使用 Analytics 和 Mobile SDK,並且想設定開發報表套裝和下載預先填入版本的設定檔案,請參閱開始之前

新增 SDK 和設定檔案至您的 IntelliJ IDEA 或 Eclipse 專案

IntelliJ IDEA 專案

新增 SDK 和設定檔案至您的專案:

  1. ADBMobileConfig.json 檔案新增至專案中的 assets 資料夾。

  2. 在專案導覽面板中,以滑鼠右鍵按一下您的專案。

  3. 選取​開啟模組設定

  4. 在​「專案設定」​下,選取​「資料庫」

  5. 按一下 ]****[!UICONTROL + 圖示即可新增資料庫。

  6. 選取​「Java」 並導覽至 adobeMobileLibrary.jar 檔案。

  7. 選取您計劃使用行動資料庫所在的模組。

  8. 按一下​「套用」​與​「確定」,以關閉「模組設定」視窗。

Eclipse 專案

新增 SDK 和設定檔案至您的專案:

  1. ADBMobileConfig.json 檔案新增至專案中的 assets 資料夾。
  2. Eclipse IDE 中,以滑鼠右鍵按一下專案名稱。
  3. 按一下​「組建路徑****> 新增外部封存檔」
  4. 選擇 adobeMobileLibrary.jar
  5. 按一下​「開啟」
  6. 再次以滑鼠右鍵按一下專案,然後選取​「組建路徑****> 設定組建路徑」
  7. 在​「排序和匯出」​標籤上,確認已選取 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());
   }

實作生命週期量度

啟用生命週期後,每當您的應用程式啟動時,就會傳送一次點擊以測量啟動數、升級數、工作階段數、參與使用者數,以及許多其他量度。如需詳細資訊,請參閱生命週期量度

在應用程式的各個活動中完成下列步驟:

  1. 匯入資料庫:

    import com.adobe.mobile.*;
    
  2. onResume 函式中,啟動生命週期資料集合:

    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
        // -or- Config.collectLifecycleData(this, contextData); 
    }
    
  3. 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 中的自訂變數:

系統會自動收集其他生命週期量度。如需詳細資訊,請參閱生命週期量度

後續步驟

完成下列作業:

本頁內容