> For the complete documentation index, see [llms.txt](https://growingio.gitbook.io/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://growingio.gitbook.io/v3/product-manual/data-center/data-management/auto/app.md).

# App端数据定义（App圈选）

SDK安卓大于等于 0.9.96，iOS 大于等于 0.9.37 为新版。新版 与旧版在圈选的操作上有所区别，旧版操作将在文末进行介绍 。

## 1.准备工作 <a href="#id-1-zhun-bei-gong-zuo" id="id-1-zhun-bei-gong-zuo"></a>

请接入SDK，并把集成SDK的App安装到您的手机。 请确保使用已发布的最新版App进行圈选，以防因为版本不同，出现数据量偏差。

注意：安卓移动端圈选在小米开发者版本和 MIUI8稳定版下调不起小红点，是因为这两个版本系统禁止了悬浮框权限，您可以先尝试信任下。步骤：安全中心-授权管理-应用权限管理-找到您要设置权限的app-找到悬浮框权限-进行授权信任。当然也可以换用其他安卓手机进行圈选。

## 2.开始圈选 <a href="#id-2-kai-shi-quan-xuan" id="id-2-kai-shi-quan-xuan"></a>

### **2.1 登录状态下进入圈选，选择嵌有SDK的目标应用（安卓/iOS）， 开始圈选。** <a href="#id-21-deng-lu-zhuang-tai-xia-jin-ru-quan-xuan-xuan-ze-qian-you-sdk-de-mu-biao-ying-yong-an-zhuo-ios-kai" id="id-21-deng-lu-zhuang-tai-xia-jin-ru-quan-xuan-xuan-ze-qian-you-sdk-de-mu-biao-ying-yong-an-zhuo-ios-kai"></a>

![](https://docs.growingio.com/.gitbook/assets/quan-xuan-1.png)

### **2.2 手机扫码（确保安装了嵌有SDK的目标应用）， 微信扫码需要在浏览器中打开，浏览器扫码后打开以下页面，点击在手机上圈选可直接唤起应用。** <a href="#id-22-shou-ji-sao-ma-que-bao-an-zhuang-le-qian-you-sdk-de-mu-biao-ying-yong-wei-xin-sao-ma-xu-yao-zai-l" id="id-22-shou-ji-sao-ma-que-bao-an-zhuang-le-qian-you-sdk-de-mu-biao-ying-yong-wei-xin-sao-ma-xu-yao-zai-l"></a>

![](https://docs.growingio.com/.gitbook/assets/app-quan-app-qi-dong-jie-mian-1.png)

### **2.3 初始界面 ：启动圈选后，会看到如下界面，将红点拖动到任一界面元素， 松开即对该元素进行圈选。** <a href="#id-23-chu-shi-jie-mian-qi-dong-quan-xuan-hou-hui-kan-dao-ru-xia-jie-mian-jiang-hong-dian-tuo-dong-dao-r" id="id-23-chu-shi-jie-mian-qi-dong-quan-xuan-hou-hui-kan-dao-ru-xia-jie-mian-jiang-hong-dian-tuo-dong-dao-r"></a>

![](https://docs.growingio.com/.gitbook/assets/yi-dong-xin-quan-xuan-di-yi-bu.png)

### **2.4 把页面定义为指标** <a href="#id-24-ba-ye-mian-ding-yi-wei-zhi-biao" id="id-24-ba-ye-mian-ding-yi-wei-zhi-biao"></a>

拖动红点到指定位置并松开后，进入”选择内容”界面 。中间的蓝色区域，上方代表当前整个页面，下方是刚才红点儿覆盖的元素， 被标记为“按钮”。他们都带有对应内容的截图。

![](https://docs.growingio.com/.gitbook/assets/yi-dong-duan-quan-xuan-di-san-bu.png)

点击代表”页面”的蓝色区域，就进入了页面指标定义界面。

![](https://docs.growingio.com/.gitbook/assets/yi-dong-xin-quan-xuan-di-4-bu.png)

（1）请在最上方的“名称”区域，给当前的页面指标命名。默认的名称是当前页面的标题。输入框下方的“原始名称”，是个当前页面的技术标识。

（2）对于安卓应用，页面技术标识是Activity或者Fragment的名称；对于iOS应用，页面技术标识是UIViewController的名称。

（3）中间的图片区域是当前页面的截图。

（4）最下方的图表代表了当前页面的近期浏览数据。

（5）点击“保存”按钮，就会把当前页面保存成指标，然后您可以在GrowingIO网站中创建图表时引用它。

### **2.5 把界面元素定义为指标（整个按钮/按钮中的文字）** <a href="#id-25-ba-jie-mian-yuan-su-ding-yi-wei-zhi-biao-zheng-ge-an-niu-an-niu-zhong-de-wen-zi" id="id-25-ba-jie-mian-yuan-su-ding-yi-wei-zhi-biao-zheng-ge-an-niu-an-niu-zhong-de-wen-zi"></a>

在圈选调出的蓝色区域中，下方代表按钮的部分，也包含了按钮中所有文字。点击下拉箭头可以看到如下界面。

![](https://docs.growingio.com/.gitbook/assets/yi-dong-xin-quan-xuan-di-san-bu.png)

（1）选择“按钮”部分，表示选中整个按钮。当您对于按钮内可能的文字变化不关心时，请选择此项，定义的指标将只统计按钮的数据，忽略内部文字变化。选择后进入按钮定义界面：

![](https://docs.growingio.com/.gitbook/assets/yi-dong-xin-quan-xuan-di-wu-bu.png)

在这个界面中，除了通用的指标命名之外，下方紧挨着的是这个元素所在页面的描述。“Coding”是我们在程序中为页面定义的标题，"ProjectOtherFragment”则是这个页面的技术标识。

界面下方分为两个Tab，分别是“当前位置”和“同类元素”。出现这样的Tab时，意味着这个按钮在一个按顺序排列的列表中。

a.选择“当前位置”，这样定义的指标，将只统计刚才红点儿覆盖的位置，而不把整个列表中其他元素算进来。运营人员查看不同位置对于点击量的影响时，可以使用这个Tab来定义指标。

b.选择“同类元素”，则表示，定义的指标会把整个列表中每个位置都统计进来，包括所有用户看到的所有内容。

（2）选择“所有文字项”中的任意一个文字，意味着您关心文字的内容。不管是只显示当前的文字时候才统计，还是想把这个文字项所有可能的值都拿来做横向柱图，都请选择此项。

![](https://docs.growingio.com/.gitbook/assets/yi-dong-duan-xin-quan-xuan-di-liu-bu.png)

a.如果选择“当前元素”的Tab，定义了指标。那么只有选中的文字不改变时，才进行统计。

b.如果选择“当前位置”的Tab，定义了指标。那么只有红点覆盖的那个按钮里的文字才统计，不管选的文字有没有发生变化。

c.如果选择“同类元素”，定义了指标。那么整个列表中每个按钮里那个文字都会被统计下来。这样的指标在横向柱状图中使用，会自动把每个文字作为一项列出来。如果运营人员要查看发布的内容哪个最受欢迎，可以选择按钮中的标题文字，然后使用“同类元素”定义指标。这样，就能做出每个标题对应点击量的横向柱状图。

### **2.6 旧版SDK圈选操作** <a href="#id-26-jiu-ban-sdk-quan-xuan-cao-zuo" id="id-26-jiu-ban-sdk-quan-xuan-cao-zuo"></a>

![](https://docs.growingio.com/.gitbook/assets/yi-dong-quan-xuan-jiu-ban-1.png)

（1）把页面定义为指标：“点击红圈”即进入页面定义页 ；

（2）把界面元素定义为指标： “拖拽红圈”至想要定义的元素位置 即可进入指标定义页面 。

![](https://docs.growingio.com/.gitbook/assets/yi-dong-duan-quan-xuan-jiu-ban-2.png)

## ​ <a href="#undefined" id="undefined"></a>
