以下是 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 static void trackState(String state, Map<String, Object> contextData);
以下是此方法的代码示例:
Analytics.trackState("loginScreen", null);
trackAction
跟踪应用程序中的操作。
例如,您的应用程序中发生的要测量的操作,包括 logons
、banner taps
、feed 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);
trackLifetimeValueIncrease
向用户的生命周期值中添加 amount
。
以下是此方法的语法:
public static void trackLifetimeValueIncrease(BigDecimal amount, Map<String, Object> contextData);
以下是此方法的代码示例:
Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
trackTimedActionStart
启动名为 action
的定时操作。
如果对已启动的操作调用此方法,则将覆盖上一个定时操作。
这个调用不发送点击。
public static void trackTimedActionStart(String action, Map<String, Object> contextData);
以下是此方法的代码示例:
Analytics.trackTimedActionStart("cartToCheckout", null)
trackTimedActionUpdate
传入 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);
trackTimedActionEnd
结束定时操作。如果提供 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);