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 dashboardapp settingscart 等等。这些状态与网站中的页面类似,而且 trackState 调用会使页面查看次数递增。

    如果 state 为空,则会在报表中显示 app name app version (build)。如果您在报表中看到此值,请确保在每个 trackState 调用中设置 state

    小贴士

    只有此跟踪调用会递增页面查看次数。

    • 以下是此方法的语法:

      public static void trackState(String state, Map<String, Object> contextData);
      
    • 以下是此方法的代码示例:

      Analytics.trackState("loginScreen", null);
      
  • trackAction
    跟踪应用程序中的操作。

    例如,您的应用程序中发生的要测量的操作,包括 logonsbanner tapsfeed subscriptions 及其他量度。

    • 以下是此方法的语法:

      public static void trackAction(String state, 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

    • 以下是此方法的语法:

      public static void trackLifetimeValueIncrease(BigDecimal amount, Map<String, Object> contextData);
      
    • 以下是此方法的代码示例:

      Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
      
  • trackTimed​ActionStart

    启动名为 action 的定时操作。

    如果对已启动的操作调用此方法,则将覆盖上一个定时操作。

    小贴士

    这个调用不发送点击。

    • 以下是此方法的语法:
    public static void trackTimedActionStart(String action, Map<String, Object> contextData);
    
    • 以下是此方法的代码示例:

      Analytics.trackTimedActionStart("cartToCheckout", null)
      
  • trackTimed​ActionUpdate

    传入 contextData,以更新与 action 关联的上下文数据。传入的 data 将附加到操作的现有数据中,如果已经为 action 定义相同的键,则会覆盖数据。

    小贴士

    这个调用不发送点击。

    • 以下是此方法的语法:

      public static void trackTimedActionUpdate(String action, 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(String action, TimedActionBlock<Boolean> logic);
      
    • 以下是此方法的代码示例:

      Analytics.trackTimedActionEnd("cartToCheckout",new
      Analytics.TimedActionBlock<Boolean>(){
          @Override
          public Boolean call(long inAppDuration, long totalDuration, Map<String, Object> contextData) {
              contextData.put("price", 49.95);
              return true;
          }
      });
      
  • sendQueuedHits

    需要 SDK 4.1。

    无论有多少点击已排入队列,此方法都强制库发送离线队列中的所有点击。

    • 以下是此方法的语法:

      public static void sendQueuedHits();
      
    • 以下是此方法的代码示例:

      Analytics.sendQueuedHits();
      
  • getQueueSize

    返回离线队列中存储的跟踪调用的数量。

    • 以下是此方法的语法:

      public static long getQueueSize();
      
    • 以下是此方法的代码示例:

      long queueSize = Analytics.getQueueSize();
      
  • clearQueue

    清除离线队列中的所有点击。

    • 以下是此方法的语法:

      public static void clearQueue();
      
    • 以下是此方法的代码示例:

      Analytics.clearQueue();
      
      警告

      手动清除队列时务必谨慎。此过程无法撤消。

  • processReferrer

    处理来自 Google Play 商店的反向链接营销活动数据以供以后将来使用。

    • 以下是此方法的语法:

      public static void processReferrer(final Context context, final Intent intent);
      
    • 以下是此方法的代码示例:

      Analytics.processReferrer(getApplicationContext(), intent);
      
  • processGooglePlayInstallReferrerUrl

    重要

    此 API 在 SDK 版本 4.18.0 中开始提供

    从提供的 Google Play Install Referrer URL 检索客户获取数据。

    从此 API 收集的数据将在发送安装点击时发送到 Analytics,并将在 Adobe Data Callback 中提供。

    如果 SDK 已收集反向链接数据,调用此方法将导致不执行任何操作。

    有关如何检索反向链接 URL 的信息,请参阅 Google 文档:https://developer.android.com/google/play/installreferrer/library

    • 以下是此方法的语法:

      public static void processGooglePlayInstallReferrerUrl(final String referrerUrl);
      
    • 以下是此方法的代码示例:

      Analytics.processGooglePlayInstallReferrerUrl(referrerUrl);
      

在此页面上