移轉至 Android 4.x 資料庫

本資訊可協助您從 Android 資料庫 3.x 或 2.x 版移轉至 4.x 版。

在 4.x 版 資料庫中，公用方法已整合為一個標題。同時，所有功能現已可透過類別層級方法存取，因此您無須持續追蹤指標、例項或單一項目。

事件、Prop 以及 eVar

在第 4 版中，您無法再將事件、eVar、Prop、繼承和清單等變數指派到應用程式中。SDK 會改為使用內容資料和處理規則，將應用程式資料對應至 Analytics 變數以便報告。

處理規則具備以下優點：

• 您可以直接變更資料對應，而無須將更新提交至 App Store。

• 您可以用有意義的資料名稱，取代設定報表套裝專用的變數。

• 對傳送額外資料的影響極小。

  這些值在透過處理規則對應前，都不會出現在報表中。

移除未使用的屬性

新的 ADBMobileConfig.json 檔案包含應用程式專屬的全域設定，並會取代先前版本中使用的大部分設定變數。以下是 ADBMobileConfig.json 檔案的範例:

{
    "version" : "1.0",
    "analytics" : {
        "rsids" : "coolApp",
        "server" : "my.CoolApp.com",
        "charset" : "UTF-8",
        "ssl" : true,
        "offlineEnabled" : true,
        "lifecycleTimeout" : 5,
        "privacyDefault" : "optedin",
        "poi" : [
                    ["san francisco",37.757144,-122.44812,7000],
                    ["santa cruz",36.972935,-122.01725,600]
                ]
    },
 "target" : {
  "clientCode" : "myTargetClientCode",
  "timeout" : 5
 },
 "audienceManager" : {
  "server" : "myServer.demdex.com"
 }
}

移動設定檔案並移轉至第 4 版

以下表格列出您需要移至設定檔案的設定變數。

移動設定檔案

1. 將第一欄中為變數設定的值移至第二欄中的變數。
2. 從您的程式碼移除舊的設定變數。

從第 3.x 版移轉

若要從第 3.x 版移轉到第 4 版，請將設定變數/方法值移至 ADBMobileConfig.json 變數。

從第 2.x 版移轉

若要從第 2.x 版移轉到第 4 版，請將值從第一欄移至第二欄中的變數。

更新追蹤呼叫和追蹤變數

第 4 版 SDK 使用以下方法，取代使用以 Web 為中心的 track 和 trackLink 呼叫:

• trackState，即應用程式中可用的檢視，例如 home dashboard、app settings、cart 等。

  這些狀態類似於網站上的頁面，且 trackState 呼叫會遞增頁面檢視。

• trackAction 動作，例如logons、banner taps、feed subscriptions，以及您想要測量、在應用程式中發生的動作。

這兩種方法的 contextData 參數都是 HashMap<String, Object>，包含以內容資料傳送的名稱值組。

事件、Prop 以及 eVar

在第 4 版中，您已無法在應用程式中直接指派事件、eVar、prop、heir 及清單等變數。SDK 現在會使用內容資料和處理規則，將應用程式資料對應至 Analytics 變數以便報告。

處理規則具備以下優點：

• 您可以直接變更資料對應，而無須將更新提交至 App Store。

• 您可以用有意義的資料名稱，取代設定報表套裝專用的變數。

• 對傳送額外資料的影響極小。

  這些值在透過處理規則對應前，都不會出現在報表中。如需詳細資訊，請參閱處理規則和內容資料。

您直接指派給變數的值，應已改為新增至 data HashMap。這代表對 setProp、setEvar 的呼叫以及指派給永久內容資料的內容應已移除，且值應已新增至 data 參數。

AppSection/伺服器、GeoZip、交易 ID、促銷活動以及其他標準變數

您在測量物件上設定的資料，包括以上列出的變數，應已新增至 data HashMap。與 trackState 或 trackAction 呼叫一併傳送的唯一資料是 data 參數中的裝載。

取代追蹤呼叫

以呼叫 trackState 或 trackAction 取代以下方法:

• 從第 3.x 版移轉

  • trackAppState (trackState)
  • trackEvents (trackAction)
  • track (trackAction)
  • trackLinkURL (trackAction)

• 從第 2.x 版移轉

  • track (trackState)
  • trackLink (trackAction)

自訂訪客 ID

以呼叫 visitorID: 取代setUserIdentifier 變數。

離線追蹤

會在 ADBMobileConfig.json 檔案中啟用離線追蹤，且所有其他離線設定會自動完成。

移除對下列方法的呼叫：

第 3.x 版

• setOnline
• setOffline

第 2.x 版

• forceOffline
• forceOnline

產品變數

如需產品變數的詳細資訊，請參閱產品變數。