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) 。如果您在报表中看到此值,请确保在每个 trackState 调用中设置 state
    只有此跟踪调用会递增页面查看次数。
    • 以下是此方法的语法:
      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 在首次启动时生成,之后会存储并使用该 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();
      
      
      手动清除队列时务必谨慎。此过程无法撤消。