# 可视化全埋点

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

## 1. 接入说明

### 1.1 iOS 接入说明

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

#### 1.1.1 获取scheme

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

![](/files/-Leyde1DYx1bdq83guRj)

#### 1.1.2 配置 scheme

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

![](/files/-Leyde1FbvOBj_brij8-)

#### 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 ：

```markup
       <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` 方法开启可视化全埋点:<br>

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

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

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

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

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

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

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

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

## 2. 功能使用说明

* 数据的查看
* 元素组件的操作
  * 新增
  * 删除
  * 编辑
* 数据的使用

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

![](https://www.sensorsdata.cn/attachment/jpg/39aw/6e027b103bbaf5e6b9235965721a3ede29d8ab14.jpg)

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

* 事件名：自定义埋点的事件名
* 显示名：自定义埋点的事件中文名
* 操作系统：Android、iOS
* 最后修改版本：最后一次进行埋点修改所在的 App 版本

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

* 编辑：可以修改事件的显示名
* 删除：点击可以删除已进行埋点的点位

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

![](https://www.sensorsdata.cn/attachment/jpg/13rg/9b125c3544a1f5abb584a8a83d059d804e1a3ac9.jpg)

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

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

  ![](https://www.sensorsdata.cn/attachment/jpg/10wd/90ceb5a0cb899ff17f82b2cf87890c7e3fbb000b.jpg)

  * 点击元素组件，可以设定元素组件的显示名、事件名；
  * 需要保证显示名和事件名与其他事件不重复；
  * 设置完成后点击保存，进行埋点点位设置的保存。
* 删除自定义元素组件

  ![](https://www.sensorsdata.cn/attachment/jpg/q7k/52a6c86db60d8ae9dd3db1f4b6e3c0f35b30822d.jpg)

  * 鼠标移动到元素组件位置;
  * 点击元素组件后的删除按钮，即可进行配置的删除
  * 配置删除后，包含该点位事件的查询等会出现报错，请谨慎操作删除
* 编辑自定义元素组件

  ![](https://www.sensorsdata.cn/attachment/jpg/ty9/030275faafa6dde51ccb1522883d6b4bd59fce32.jpg)

  * 点击已经配置过的元素组件，可以查看元素组件的配置信息；
  * 最初创建版本为该点位的最早进行配置的 App 版本；
  * 用户可以修改元素组件的显示名。

#### 2.3 埋点数据的使用

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

#### 2.4 可视化埋点的原理

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://54td.gitbook.io/shence/use_steps/features/accessibility/visualized.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.