Show Menu
主題×

Analytics 方法

以下為 Android 資料庫所提供的 Adobe Analytics 方法清單。
SDK 目前可支援多個 Adobe Experience Cloud 解決方案,包括 Analytics、Target、Audience Manager 以及 Adobe Experience Platform Identity Service。各方法會根據解決方案加上前置詞,例如 Experience Cloud ID 方法會加上前置詞 analytics
下列各方法將用來傳送資料至您的 Adobe Analytics 報表套裝:
  • trackState
    使用可選內容資料來追蹤應用程式。狀態為應用程式中可用的檢視,例如 home dashboard app settings cart 等。這些狀態類似於網站上的頁面,且 trackState 呼叫會遞增頁面檢視。
    如果 state 空白,在報表中會顯示 app name app version (build) 。如果在報表中看到這個值,請務必在每個 state 呼叫中設定 trackState
    這是唯一會遞增頁面檢視的追蹤呼叫。
    • 以下是此方法的語法:
      public staticvoidtrackState(Stringstate, Map<String,Object> contextData);
      
      
    • 以下是此方法的範例程式碼:
      Analytics.trackState("loginScreen",null);
      
      
  • trackAction 追蹤應用程式中的動作。
    您要測量的動作,例如 logons banner taps feed subscriptions ,以及在應用程式中發生的其他量度。
    • 以下是此方法的語法:
      publicstaticvoidtrackAction(Stringstate,Map<String,Object> contextData);
      
      
    • 以下是此方法的範例程式碼:
      Analytics.trackAction("heroBannerTouched",null);
      
      
  • getTrackingIdentifier 傳回自動產生的 Analytics 訪客識別碼。
    這是應用程式專屬的唯一訪客 ID,會在初次啟動時產生,並會儲存以供後續使用。ID 會在應用程式升級時保留,並於應用程式解除安裝時移除。
    • 以下是此方法的語法:
      public static String getTrackingIdentifier(); 
      
      
    • 以下是此方法的範例程式碼:
      String trackingId = Analytics.getTrackingIdentifier(); 
      
      
  • trackLocation
    傳送目前的經緯度,以及已定義地標中的位置。如需詳細資訊,請參閱 地理位置與地標
    • 以下是此方法的語法:
      public static void trackLocation(Location location, Map<String,Object> contextData); 
      
      
    • 以下是此方法的範例程式碼:
      Analytics.trackLocation(userLocation, null);
      
      
  • trackLifetime​ValueIncrease
    增加使用者期限值的 amount
    • 以下是此方法的語法:
      publicstaticvoidtrackLifetimeValueIncrease(BigDecimalamount,Map<String,Object>contextData);
      
      
    • 以下是此方法的範例程式碼:
      Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
      
      
  • trackTimed​ActionStart
    以名稱 action 啟動計時動作。
    如果您對已啟動的動作呼叫此方法,則會覆寫先前的計時動作。
    此呼叫不會傳送點擊。
    • 以下是此方法的語法:
    publicstaticvoidtrackTimedActionStart(Stringaction,Map<String,Object>contextData);
    
    
    • 以下是此方法的範例程式碼:
      Analytics.trackTimedActionStart("cartToCheckout",null)
      
      
  • trackTimed​ActionUpdate
    傳遞 contextData 以更新與 action 關聯的內容資料。傳遞的 data 會附加至該動作的現有資料,如果已為 action 定義了相同鍵值,則會覆寫資料。
    此呼叫不會傳送點擊。
    • 以下是此方法的語法:
      public static void trackTimedActionUpdate(Stringaction,Map <String,Object> contextData); 
      
      
    • 以下是此方法的範例程式碼:
      HashMap cdata = new HashMap<String Object> (); 
      cdata.put("quantity",3); 
      Analytics.trackTimedActionUpdate("cartToCheckout", cdata);
      
      
  • trackTimed​ActionEnd
    結束計時動作。如果您提供 block ,則可在傳送最後一次點擊前存取最後時間值並處理 data
    如果您提供 block ,則必須傳回 true 以傳送點擊。針對 block 傳遞 null 會傳送最後一次點擊。
    • 以下是此方法的語法:
      public static void trackTimedActionEnd(Stringaction,TimedActionBlock<Boolean> logic); 
      
      
    • 以下是此方法的範例程式碼:
      Analytics.trackTimedActionEnd("cartToCheckout",new
      Analytics.TimedActionBlock<Boolean>(){
        @Override
        public Booleancall(long inAppDuration,long totalDuration, Map<String,
      Object> contextData) {
              contextData.put("price", 49.95);
              return true;
         }
      });
      
      
  • sendQueuedHits
    須使用 SDK 4.1 版.
    無論排入佇列的點擊數量多寡,此方法會強制資料庫傳送離線佇列中的所有點擊。
    • 以下是此方法的語法:
      voidsendQueuedHits()
      
      
    • 以下是此方法的範例程式碼:
      Analytics.sendQueuedHits();
      
      
  • getQueueSize
    傳回在離線佇列中儲存的追蹤呼叫數目。
    • 以下是此方法的語法:
      long getQueueSize()
      
      
    • 以下是此方法的範例程式碼:
      long queueSize = Analytics.getQueueSize(); 
      
      
  • clearQueue
    清除離線佇列中的所有點擊。
    • 以下是此方法的語法:
      voidclearQueue()
      
      
    • 以下是此方法的範例程式碼:
      Analytics.clearQueue();
      
      
      手動清除佇列時請小心。此程序無法回復。