可视化全埋点

可视化全埋点为神策分析 1.14 版本新增功能

1. 接入说明

1.1 iOS 接入说明

iOS SDk 版本 v1.11.0+ 支持可视化全埋点

1.1.1 获取scheme

使用 admin 账号，登录到神策分析相应的项目，点击右上角的账号，从「数据接入」页面获取 scheme 的值。

1.1.2 配置 scheme

点击项目 target 选择选项卡Info，添加 URL Types，将第一步获取到的 scheme 配置到 URL Scheme 中。

1.1.3 开启可视化全埋点

在初始化 SDK 之后调用 enableVisualizedAutoTrack 方法开启可视化全埋点:

 //初始化 SDK 之后，开启可视化全埋点
 [[SensorsAnalyticsSDK sharedInstance] enableVisualizedAutoTrack];

并在 AppDelegate.m 中的 - (BOOL)application:(UIApplication )app openURL:(NSURL )url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options 方法中 调用 handleSchemeUrl: 函数接收 URL

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    if ([[SensorsAnalyticsSDK sharedInstance] handleSchemeUrl:url]) {
        return YES;
    }
    return NO;
}

注意：只有开启了可视化全埋点功能，在采集 $AppClick 事件时才会记录 View 的 ViewPath。

4. 开启部分页面的可视化全埋点

如果只想查看部分页面的可视化全埋点，可以通过 addVisualizedAutoTrackViewControllers: 方法开启。

例如，开启 MainController 页面的可视化全埋点：

//开启 MainController 页面的可视化全埋点
[[SensorsAnalyticsSDK sharedInstance] addVisualizedAutoTrackViewControllers:[NSArray arrayWithObject:@"MainController"]];

设置后，只会采集 MainController 上的 View 的 ViewPath（$AppClick 事件）。

1.2 Android 接入说明

Android SDk 版本 v 3.1.0 + 支持可视化全埋点

1.2.1 获取 scheme

使用 admin 账号，登录到神策分析相应的项目，从【数据接入】页面获取 scheme 的值。

1.2.2 配置 scheme

在 AndroidManifest.xml 中 MainActivity 的标签内，配置 scheme ：

       <activityandroid:name=".SplashActivity">
           <intent-filter>
               <actionandroid:name="android.intent.action.MAIN"/>
               <categoryandroid:name="android.intent.category.LAUNCHER"/>
           </intent-filter>
       </activity>
​
​
       <activityandroid:name=".MainActivity">
           <!-- 在主 Activity 中配置 scheme-->
           <intent-filter>
               <actionandroid:name="android.intent.action.VIEW"/>
               <categoryandroid:name="android.intent.category.BROWSABLE"/>
               <categoryandroid:name="android.intent.category.DEFAULT"/>
               <data
                   android:host="visualized"
                   android:scheme="您项目的 scheme 值"/>
           </intent-filter>
       </activity>

1.2.3 开启可视化全埋点

在初始化 SDK 之后调用 enableVisualizedAutoTrack 方法开启可视化全埋点:

//初始化 SDK 之后，开启可视化全埋点, 在采集 $AppClick 事件时会记录 View 的 ViewPath
SensorsDataAPI.sharedInstance().enableVisualizedAutoTrack();

1.2.4 开启部分页面的可视化全埋点

如果只想开启部分页面的可视化全埋点，可以通过 addVisualizedAutoTrackActivities 或 addVisualizedAutoTrackActivity 方法开启。

例如，开启 MainActivity 页面的可视化全埋点：

//开启 MainActivity 页面的可视化全埋点<br>
SensorsDataAPI.sharedInstance().addVisualizedAutoTrackActivity(MainActivity.class);

注意：开启了可视化全埋点功能后，扫描二维码打开 App 时（使用手机自带浏览器扫描），默认情况下会弹出 AlertDialog 提示框，来提示用户是否继续连接进行可视化全埋点。

如果想关闭此提示框，可以调用 enableVisualizedAutoTrackConfirmDialog 关闭，关闭提示后，扫描二维码打开 App 时，会自动连接进行可视化全埋点。

//关闭点击可视化全埋点的提示框
SensorsDataAPI.sharedInstance().enableVisualizedAutoTrackConfirmDialog(false);

2. 功能使用说明

• 数据的查看

• 元素组件的操作

  • 新增

  • 删除

  • 编辑

• 数据的使用

2.1 可视化全埋点数据的查看

在该页面展示全部已埋点的数据，包含：

• 事件名：自定义埋点的事件名

• 显示名：自定义埋点的事件中文名

• 操作系统：Android、iOS

• 最后修改版本：最后一次进行埋点修改所在的 App 版本

在该页面可以进行埋点数据的编辑和修改

• 编辑：可以修改事件的显示名

• 删除：点击可以删除已进行埋点的点位

2.2 操作可视化全埋点组件元素

• 添加可视化全埋点点位数据

  红色表示该元素未被定义，绿色表示该元素已被定义。

  

  • 点击元素组件，可以设定元素组件的显示名、事件名；

  • 需要保证显示名和事件名与其他事件不重复；

  • 设置完成后点击保存，进行埋点点位设置的保存。

• 删除自定义元素组件

  

  • 鼠标移动到元素组件位置;

  • 点击元素组件后的删除按钮，即可进行配置的删除

  • 配置删除后，包含该点位事件的查询等会出现报错，请谨慎操作删除

• 编辑自定义元素组件

  

  • 点击已经配置过的元素组件，可以查看元素组件的配置信息；

  • 最初创建版本为该点位的最早进行配置的 App 版本；

  • 用户可以修改元素组件的显示名。

2.3 埋点数据的使用

• 分析模型中使用

  • 在分析中，通过可视化全埋点选中的事件，使用方法与虚拟事件一致。

2.4 可视化埋点的原理

可视化埋点的实现原理与创建虚拟事件基本类似，使用 $appclick 与该事件的 $viewpath 属性进行虚拟事件的创建；若该事件删除后再次被添加，则历史数据也会生效。