# 点击图(HeatMap)

[1. 获取 scheme ](#1-获取-scheme)

[2. 配置 scheme ](#2-配置-scheme)

[3. 开启点击图](#3-开启点击图)

[4. 开启部分页面的点击图](#4-开启部分页面的点击图)

## [1.9.0](https://github.com/sensorsdata/sa-sdk-android/releases/tag/v1.9.0) 支持全埋点中 `$AppClick` 事件的点击图。

### 1. 获取 scheme

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

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leyde1DYx1bdq83guRj%2Fapp_debug_mode_data_0.jpg?generation=1557976759765611\&alt=media)

### 2. 配置 scheme

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

```markup
        <activity android:name=".SplashActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>


        <activity android:name=".MainActivity">
            <!-- 在主 Activity 中配置 scheme-->
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.BROWSABLE" />
                <category android:name="android.intent.category.DEFAULT" />
                <data
                    android:host="heatmap"
                    android:scheme="您项目的 scheme 值" />
            </intent-filter>
        </activity>
```

### 3. 开启点击图

在初始化 SDK 之后调用 `enableHeatMap` 方法开启点击图:

```java
 //初始化 SDK 之后，开启点击图
 SensorsDataAPI.sharedInstance().enableHeatMap();
```

注意：只有开启了点击图功能，在采集 `$AppClick` 事件时才会记录 `View` 的 `ViewPath`。

### 4. 开启部分页面的点击图

如果只想查看部分页面的点击图，可以通过 `addHeatMapActivity` 或 `addHeatMapActivities` 方法开启。

例如，开启 `MainActivity` 页面的点击图：

```java
//开启 MainActivity 页面的点击图
SensorsDataAPI.sharedInstance().addHeatMapActivity(MainActivity.class);
```

**注意**：开启了点击图功能后，扫描二维码打开 App 时（使用手机自带浏览器扫描），默认情况下会弹出 `AlertDialog` 提示框，来提示用户是否继续连接点击分析。 从[1.9.6](https://github.com/sensorsdata/sa-sdk-android/releases/tag/v1.9.16) 开始，如果想关闭此提示框，可以调用 `enableAppHeatMapConfirmDialog` 关闭，关闭提示后，扫描二维码打开 App 时，会自动连接点击分析。

```java
 //关闭点击分析的提示框
SensorsDataAPI.sharedInstance().enableAppHeatMapConfirmDialog(false);
```