# 无埋点事件字段

## **无埋点事件**

{% tabs %}
{% tab title="visit" %}

| 名称 | 类型（长度） | 说明 |
| -- | ------ | -- |

| userId | string（36） | <p>用户ID。</p><p>正对单个用户生成的唯一ID。</p><p>示例：Web网站生成一个有效期3年的cookie值，App则为机器唯一标识码。</p> |
| ------ | ---------- | ------------------------------------------------------------------------------- |

| sessionId | string（36） | <p>访问ID</p><p>示例：6b5099c7-6006-422d-92ac-4f3bf4ddd37c</p><p>Web端：首次访问时生成 session，当用户30分钟内无操作行为，之后有操作行为，刷新 session。<br>移动端：冷启动时生成 session，当App进入后台30秒后再次启动，刷新session。<br>小程序：冷启动时生成 session，当小程序进入后台5分钟后再次启动，刷新session。<br></p> |
| --------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

| sendTime | bigint | 发送时间。 |
| -------- | ------ | ----- |

| eventTime | bigint | 事件发生事件 |
| --------- | ------ | -----: |

| eventType | string（10） | 事件类型 |
| --------- | ---------- | ---: |

| ip | string（64） |   |
| -- | ---------- | - |

| countryName | string（30） | <p>国家名称。</p><p>用户所在的国家。</p> |
| ----------- | ---------- | --------------------------: |

| region | string（30） | <p>省份。</p><p>用户所在的省份。</p> |
| ------ | ---------- | ------------------------: |

| city | string（30） | <p>城市。</p><p>用户所在的城市。</p> |
| ---- | ---------- | ------------------------: |

| domain | string（100） | <p>域名。</p><p>用户访问的网站域名。</p> |
| ------ | ----------- | --------------------------: |

| path | string（512） | <p>路径。</p><p>网站路径。</p> |
| ---- | ----------- | ---------------------: |

| refer | string（1024） | 来源链接 |
| ----- | ------------ | ---: |

| userAgent | string（1024） |   |
| --------- | ------------ | - |

| appVersion | string（10） | 客户的产品版本，仅限App端。 |
| ---------- | ---------- | --------------: |

| model | string（50） | 用户的设备型号 |
| ----- | ---------- | ------: |

| manufacturer | string（50） | <p>用户的设备生产产商。</p><p>示例：小米</p> |
| ------------ | ---------- | ----------------------------: |

| channel | string（40） | <p>下载渠道。</p><p>App的下载渠道，仅限移动端。</p> |
| ------- | ---------- | ---------------------------------: |

| language | string（10） | <p>语言。</p><p>用户使用的设备系统语言。</p> |
| -------- | ---------- | ----------------------------- |

| osVersion | string（50） | <p>系统版本。</p><p>用户使用的设备系统版本。</p> |
| --------- | ---------- | ------------------------------- |

| resolution | string（20） | <p>设备分辨率</p><p>用户使用的设备分辨率。</p> |
| ---------- | ---------- | ------------------------------ |

| platform | string（10） | <p>数据来源</p><p>平台区分该数据属于哪个平台。</p><p>示例：Web Android iOS</p> |
| -------- | ---------- | --------------------------------------------------------- |

| id | string（16） | <p>访问事件ID</p><p>即visit\_id，用于与page数据聚合，唯一标记visit事件。</p> |
| -- | ---------- | ------------------------------------------------------- |

| query | string（512） | <p>访问事件的query信息</p><p>访问时的连接中的query，与掐年的domain，path一起构建完整的链接。</p> |
| ----- | ----------- | ----------------------------------------------------------------- |

| lat | double | <p>gps纬度</p><p>mobile平台，需要gps权限。？？？</p> |
| --- | ------ | --------------------------------------- |

| lng          | double | gps经度mobile平台独有的子弹，紧缺到小数点后5位。 |
| ------------ | ------ | ----------------------------- |
| {% endtab %} |        |                               |

{% tab title="page" %}

| 名称 | 类型（长度） | 说明 |
| -- | ------ | -- |

| userId | string(36) | <p>用户ID</p><p>针对单个用户生成的唯一id</p><p>例如，web网站生成一个有效期三年的cookie值，App 则为机器唯一标识码</p> |
| ------ | ---------- | ----------------------------------------------------------------------------- |

| sessionId | string(36) |   |
| --------- | ---------- | - |

| sendTime | bigint | 数据发送过来的时间 |
| -------- | ------ | --------- |

| eventTime | bigint | 事件实际发生的时间 |
| --------- | ------ | --------- |

| eventType | string(15) | <p>该消息的类型</p><p>page表内类型为page</p> |
| --------- | ---------- | --------------------------------- |

| domain | string(100) | 用户访问的网站域名 |
| ------ | ----------- | --------- |

| path | string(512) | 网站路径 |
| ---- | ----------- | ---- |

| query | string(512) | <p>request请求中的查询参数</p><p>k1=v1\&k2=v2</p> |
| ----- | ----------- | ----------------------------------------- |

| refer | string(1024) | 该用户从refer所在地址跳转过来 |
| ----- | ------------ | ----------------- |

| title | string(1024) | <p>页面名称</p><p>该网页名称，page title</p> |
| ----- | ------------ | ---------------------------------- |

| platform | string(10) | 区分该数据属于哪个平台：web, android, ios |
| -------- | ---------- | ----------------------------- |

| cs1 | string(200) | <p>用户信息字段1</p><p>客户平台的登陆用户id：cs1，如果客户安装sdk时设置过cs1字段（上传用户属性字段集cs，cs1用于设置用户id）</p> |
| --- | ----------- | -------------------------------------------------------------------------------- |

| cs2 | string(200) | 客户平台的项目id：cs2 |
| --- | ----------- | ------------- |

| cs3 | string(200) | ​ |
| --- | ----------- | - |

| cs4 | string(200) | ​ |
| --- | ----------- | - |

| cs5 | string(200) | ​ |
| --- | ----------- | - |

| cs6 | string(200) | ​ |
| --- | ----------- | - |

| cs7 | string(200) | ​ |
| --- | ----------- | - |

| cs8 | string(200) | ​ |
| --- | ----------- | - |

| cs9 | string(200) | ​ |
| --- | ----------- | - |

| cs10 | string(200) | ​ |
| ---- | ----------- | - |

| id | string(23) | <p>页面事件id</p><p>即page\_id，用于与action数据聚合</p><p>唯一标记page事件</p> |
| -- | ---------- | ------------------------------------------------------------ |

| visit\_id | string(16) | <p>访问事件ID</p><p>即visit\_id，用于与visit表数据聚合</p><p>。visit表内id</p> |
| --------- | ---------- | ------------------------------------------------------------- |

| pagegroup | string(100) | <p>页面组名称</p><p>需要在sdk集成时配置</p><p>用于标记设置的一组ps字段信息</p> |
| --------- | ----------- | ---------------------------------------------------- |

| ps1 | string(200) | sdk配置的页面信息字段1 |
| --- | ----------- | ------------- |

| ps2 | string(200) | ​ |
| --- | ----------- | - |

| ps3 | string(200) | ​ |
| --- | ----------- | - |

| ps4 | string(200) | ​ |
| --- | ----------- | - |

| ps5 | string(200) | ​ |
| --- | ----------- | - |

| ps6 | string(200) | ​ |
| --- | ----------- | - |

| ps7 | string(200) | ​ |
| --- | ----------- | - |

| ps8 | string(200) | ​ |
| --- | ----------- | - |

| ps9 | string(200) | ​ |
| --- | ----------- | - |

| ps10         | string(200) | ​ |
| ------------ | ----------- | - |
| {% endtab %} |             |   |

{% tab title="action" %}

| 列名 | 字段名称 | 字段格式 | 字段说明 |
| -- | ---- | ---- | ---- |

| userId | 用户ID | string(36) | ​ |
| ------ | ---- | ---------- | - |

| sessionId | 会话ID | string(36) | "web: 30分钟过期的session值，代表一次会话,。mobile: app退出30秒后再进入，刷新session值" |
| --------- | ---- | ---------- | -------------------------------------------------------------- |

| sendTime | 发送时间 | bigint | 数据发送过来的时间 |
| -------- | ---- | ------ | --------- |

| eventTime | 事件发生时间 | bigint | 事件实际发生的时间 |
| --------- | ------ | ------ | --------- |

| eventType | 事件类型 | string(10) | <p>该消息的类型</p><p>可能值为clck(click), chng(change)，sbmt(submit)以及imp(impression)，change的含义</p> |
| --------- | ---- | ---------- | ----------------------------------------------------------------------------------------- |

| eventValue | 事件值 | string(1024) | <p>该消息的值，例如标签的value</p><p>示例：确定</p> |
| ---------- | --- | ------------ | ----------------------------------- |

| domain | 域名 | string(100) | <p>域名</p><p>用户访问的网站域名</p> |
| ------ | -- | ----------- | ------------------------- |

| path | 路径 | string(512) | <p>路径：</p><p>网站路径</p> |
| ---- | -- | ----------- | --------------------- |

| href | 链接 | string(1024) | <p>链接</p><p>标签内的跳转链接（如果没有则为null）</p> |
| ---- | -- | ------------ | ------------------------------------ |

| page\_id | 页面ID | string(23) | <p>页面ID</p><p>页面唯一的id，用于与page数据join</p> |
| -------- | ---- | ---------- | --------------------------------------- |

| action\_id | 事件ID | string(30) | <p>事件ID</p><p>标签事件的唯一id</p><p>web的action\_id以wa开头，mobile以ma开头</p> |
| ---------- | ---- | ---------- | ----------------------------------------------------------------- |

| index | 列表序号 | bigint | <p>列表序号</p><p>列表类型标签的序号</p><p>用于标记列表内的第几项，分析列表中最常被点击的内容或者首项推广效果等等</p> |
| ----- | ---- | ------ | --------------------------------------------------------------------- |

| info          | 事件附加信息 | string(200) | <p>事件附加信息</p><p>用户自定义事件信息</p><p>对应growingAttributesInfo设置的字段信息。</p> |
| ------------- | ------ | ----------- | ------------------------------------------------------------------- |
| {% endtab %}  |        |             |                                                                     |
| {% endtabs %} |        |             |                                                                     |

1. 三张数据表分别代表GIO定义的三种数据级别，访问级别（visit），页面级别（page）与标签级别（action）。visit代表访问级别的数据，按照session定义访问，page代表页面级别数据，打开的浏览页面就是一条记录，一条访问级别数据对应多条页面级别，action级别数据代表标签数据，定义页面元素标签的显示，点击，提交等事件，三者形成整个用户行为数据层级。目前导出的数据类型除了action下的imp(impression)类型因为数据量过大不可导出，其它数据都已经导出。
2. sendTime与eventTime的区别在于前者相当于是GIO平台接收到的时间，而eventTime是事件在客户端真正发生的时间，客户可以根据eventTime重现用户操作时间线。
3. 在refer中可以提取utm（广告链接关键字）或者搜索关键字等信息，用于分析访问来源。也可在visit表的query字段中提取utm信息。
4. appVersion，model，manufacturer，channel，osVersion仅在mobile端提供，更多信息可以从userAgent中提取。
5. 三张数据表可以根据“外键”join，分别是page\_id与page表的id，visit\_id与visit表的id，action\_id单独提供。因为标签事件并不导出impression（显示级别）的数据（数据量太大的缘故），所以建议通过action full outer join page，visit与page基本保持对应，若是在小时级别page数据无法join到对应的visit记录，visit记录可能存在于之前的小时单位中。
6. 所有数据已经根据userId, sessionId, sendTime进行排序，基本能够做到具体用户行为跟踪。
7. mobile端浏览器打开页面访问，默认platform类型为Web，若是需要区分则建议根据osVersion。
8. action数据中index，info为补充字段，参考changelog说明。

## 圈选数据映射关系

{% tabs %}
{% tab title="action\_tag" %}

| 名称 | 类型 | 说明 |
| -- | -- | -- |

| sendTime | bigint | <p>发送时间</p><p>数据发送过来的时间</p> |
| -------- | ------ | --------------------------- |

| action\_id | string(30) | <p>事件ID。</p><p>标签事件的唯一id web的action\_id以wa开头，mobile以ma开头</p> |
| ---------- | ---------- | ------------------------------------------------------------ |

| rule\_id     | string(8) | <p>规则ID。</p><p>匹配事件的规则id，该id为growingio平台圈选的标签的唯一id.</p><p>该值由字母与数字组成，例如‘1ba052a9’.</p> |
| ------------ | --------- | -------------------------------------------------------------------------------------- |
| {% endtab %} |           |                                                                                        |

{% tab title="rules" %}

| 名称 | 类型 | 字段说明 |
| -- | -- | ---- |

| rule\_id | string(8) | <p>规则ID，匹配事件的规则ID，该ID为growingio平台圈选的标签的唯一ID。</p><p>该值由字母与数字组成，例如‘1ba052a9’。</p> |
| -------- | --------- | ------------------------------------------------------------------------------- |

| name | string(200) | <p>规则名称，圈选的标签名称。</p><p>该名称不可以作为唯一主键，只是便于使用区分。</p> |
| ---- | ----------- | ------------------------------------------------- |

| ruleType      | string(10) | <p>规则类型，规则在定义时可能有不同的类型，例如按钮的imp或者clck。</p><p>值包括 page, imp, clck, chng, sbmt。</p> |
| ------------- | ---------- | --------------------------------------------------------------------------------- |
| {% endtab %}  |            |                                                                                   |
| {% endtabs %} |            |                                                                                   |

1. 在基础部分数据导出（visit, page, action)之外，提供圈选数据与action级别数据的映射部分。
2. 通过action数据中的action\_id与action\_tag中的action\_id聚合，绑定对应的rule\_id（映射的规则名称）到action数据上。
3. rules代表了客户在GrowingIO平台上圈选的标签，rule\_id即其唯一标识符。
4. 通过rules表将名称绑定到上述的action\_tag表中，便于通过名称进行数据分析，识别导出数据中圈选部分的数据情况。
5. action\_tag与rules表均是关联信息表，用于更进一步分析导出的部分数据，在导出数据中定位圈选数据。建议规则建立时保持名称的唯一性，GrowingIO平台不保证规则名称唯一性。
6. 相同的规则名称下可能有多个规则类型，规则名称＋规则类型才能区分，此处的规则类型与基础数据action中的事件类型保持一致。


---

# 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://growingio.gitbook.io/v3/developer-manual/api-reference/originaldata-export-v1/characters/auto-character.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.
