开发指南

# 行为轨迹

# 页面行为轨迹

在 7.12.0 版本中，默认关闭行为轨迹。

在 4.0 版本中，SDK 支持记录用户在 App 内的访问轨迹，并在联系客服时上报给客服。

使用 App 访问轨迹功能，需要企业开通 访问轨迹 功能。

配置 App 访问轨迹有两种方案，请选择适合自己的方案：

  1. 自动配置

在初始化时将 YSFOptions 的 autoTrackUser 赋值为 true（默认即 false），为 AndroidManifest.xml 中所有 activity 标签的 label 赋值，该字段将作为访问轨迹页面标题。

在客服端查看行为轨迹，则须先上报CRM信息。

该配置仅能记录 Activity 的访问轨迹，如果需要记录 Fragment 的访问轨迹，请参考方案 2

  1. 手动配置

在初始化时将 YSFOptions 的 autoTrackUser 赋值为 false，在需要记录的 Activity（或 Fragment）的 onResume 和 onPause 方法中添加如下代码

@Override
public void onResume() {
    super.onResume();

    // ...
    QiyuTracker.onResume(this, "页面标题");
    // ...
}

@Override
public void onPause() {
    super.onPause();

    // ...
    QiyuTracker.onPause(this, "页面标题");
    // ...
}

注：以上两种方案请选择一种，不要混合使用，否则可能出现轨迹错乱的问题。

# 自定义行为轨迹

在 V4.4.0 版本中，SDK 支持用户在 App 内的行为轨迹，并在联系客服时上报给客服。

使用 App 访问轨迹功能，需要企业开通 行为轨迹 功能。行为轨迹是建立在访问轨迹之上的，如果需要使用行为轨迹，请先开启访问轨迹

行为轨迹类似于用户的点击事件，App 可以在用户任何操作的时候调用 SDK 的 API，这样就可以记录用户的行为，下面代码展示了如何上报用户的访问轨迹：

/**
 * 记录用户行为的方法
 * @param title  用户操作的类目是什么，可以是点击了收藏，可以是点击了查看，这个完全由客户端自己定义
 * @param jsonObject 用户操作的内容是什么，如果是商品，那么里面就是商品信息，如果是课程里面就是课程信息
 *                   如果不想传也是可以的
 */
QiyuTracker.onBehavior(this,"操作名称",jsonObject);

该方法可以在任何地方进行调用，当调用的时候 SDK 会根据情况选择上传到服务器

← 高级功能 →