You need to enable JavaScript to run this app.
导航
Web预置事件及属性
最近更新时间:2025.06.17 11:08:32首次发布时间:2024.04.30 15:17:23
我的收藏
有用
有用
无用
无用

背景信息
  • 环境说明:当前DataFinder为您提供多种环境,各个环境支持的预置事件和预置属性列表略有差异,您可根据您当前的环境查看对应环境支持的预置事件和预置属性能力。如果您不确定您当前使用的是哪种环境,可参见SaaS云原生/非云原生&私有化环境
  • 事件/属性类型说明:当前为您介绍的是各个端支持的“预置事件”和“预置事件属性”,除此之外,DataFinder还支持预置事件公共属性、预置用户属性,各类型的属性介绍请参见预置属性总表
  • 上报机制:详情请参见产品逻辑:数据上报&缓存策略

SaaS-云原生环境

页面访问事件(predefine_page_)

事件名

事件显示名

事件开关

事件描述

事件属性名

属性说明

属性值类型

数据来源

是否自动上报

属性开关控制

predefine_pageview

页面访问

有。
在集成web端SDK时,初始化时配置 disable_auto_pv来控制开关,默认上报

pv事件,当sdk初始化完成后,即调用start事件,会发送一次pv,仅发送一次。会带上页面title、url、path、referrer等属性。
当你是SPA页面,页面发生改变,想重新上报PV时,可调用如下API,传入一些自定义参数,会和默认参数进行合并。( Tea.predefinePageView(params))

_ip_int

IP地址,属性取值为将client_ip属性取值转换为整数类型的数值。

int

Finder服务端生成

由事件开关控制,无单独的属性开关

referer_full_domain

上报页面访问(Page_view)事件时,上报的页面访问来源的域名信息。

string

Finder服务端生成

由事件开关控制,无单独的属性开关

referer_site_name

上报页面访问(Page_view)事件时,上报的页面访问来源的网站名称,属性取值由referrer、url(访问链接)属性的取值决定,详情请参见官网帮助文档页面访问来源判断逻辑

string

Finder服务端生成

由事件开关控制,无单独的属性开关

referer_type

上报页面访问(Page_view)事件时,上报的页面访问来源类型。枚举值:inner:站内跳转;direct:直接访问;referring_site:外部链接;社交网络social_network分类和搜索引擎search_engine分类。详情请参见官网帮助文档页面访问来源判断逻辑

string

Finder服务端生成

由事件开关控制,无单独的属性开关

url_full_domain

页面访问(PageView)事件上报的页面访问域名,通过页面url推导,将url字符串解析为java.net.URL对象,并调用getHost()方法获得。

string

Finder服务端生成

由事件开关控制,无单独的属性开关

event_index

默认所有的事件都会有,不用关心。

float

Finder服务端生成

由事件开关控制,无单独的属性开关

visit_from_outside

通过页面访问(PageView)事件上报的url和referrer推导,若url和referrer的顶级域名不相同则为true,否则为false(若url/referrer的其中一个因上报格式有问题无法解析出host,则恒为false)。

string

系统API

由事件开关控制,无单独的属性开关

title

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

predefine_page_alive

停留时长活跃


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,此事件会在页面活跃状态下,每分钟定时上报一次,或者在切换为非活跃状态时上报一次,用于检测页面是否活跃。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

predefine_page_close

停留时长关闭


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,会记录用户每次“进入页面、切换状态、离开页面”的时间戳,然后在离开或者关闭页面的时候上报此事件,将每一段“活跃状态”的时长相加作为整体的使用时长。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

active_time

active_time是每次切换活跃状态后+1

int

自动生成

由事件开关控制,无单独的属性开关

total_duration

用户访问页面,从开始到关闭的整个时长。单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

SaaS-非云原生环境

页面访问事件(predefine_page_)

事件名

事件显示名

事件开关

事件描述

事件属性名

属性说明

属性值类型

数据来源

是否自动上报

属性开关控制

predefine_pageview

页面访问

有。
在集成web端SDK时,初始化时配置 disable_auto_pv来控制开关,默认上报

pv事件,当sdk初始化完成后,即调用start事件,会发送一次pv,仅发送一次。会带上页面title、url、path、referrer等属性。
当你是SPA页面,页面发生改变,想重新上报PV时,可调用如下API,传入一些自定义参数,会和默认参数进行合并。( Tea.predefinePageView(params))

_ip_int

IP地址,属性取值为将client_ip属性取值转换为整数类型的数值。

int

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_full_domain

上报页面访问(Page_view)事件时,上报的页面访问来源的域名信息。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_site_name

上报页面访问(Page_view)事件时,上报的页面访问来源的网站名称,属性取值由referrer、url(访问链接)属性的取值决定,详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_type

上报页面访问(Page_view)事件时,上报的页面访问来源类型。枚举值:inner:站内跳转;direct:直接访问;referring_site:外部链接;社交网络social_network分类和搜索引擎search_engine分类。详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

url_full_domain

页面访问(PageView)事件上报的页面访问域名,通过页面url推导,将url字符串解析为java.net.URL对象,并调用getHost()方法获得。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

event_index

默认所有的事件都会有,不用关心。

float

自动生成

由事件开关控制,无单独的属性开关

title

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

predefine_page_alive

停留时长活跃


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,此事件会在页面活跃状态下,每分钟定时上报一次,或者在切换为非活跃状态时上报一次,用于检测页面是否活跃。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

predefine_page_close

停留时长关闭


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,会记录用户每次“进入页面、切换状态、离开页面”的时间戳,然后在离开或者关闭页面的时候上报此事件,将每一段“活跃状态”的时长相加作为整体的使用时长。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

active_time

active_time是每次切换活跃状态后+1

int

自动生成

由事件开关控制,无单独的属性开关

total_duration

用户访问页面,从开始到关闭的整个时长。单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

私有化

页面访问事件(predefine_page_)

事件名

事件显示名

事件开关

事件描述

事件属性名

属性说明

属性值类型

数据来源

是否自动上报

属性开关控制

predefine_pageview

页面访问

有。
在集成web端SDK时,初始化时配置 disable_auto_pv来控制开关,默认上报

pv事件,当sdk初始化完成后,即调用start事件,会发送一次pv,仅发送一次。会带上页面title、url、path、referrer等属性。
当你是SPA页面,页面发生改变,想重新上报PV时,可调用如下API,传入一些自定义参数,会和默认参数进行合并。( Tea.predefinePageView(params))

_ip_int

IP地址,属性取值为将client_ip属性取值转换为整数类型的数值。

int

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_full_domain

上报页面访问(Page_view)事件时,上报的页面访问来源的域名信息。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_site_name

上报页面访问(Page_view)事件时,上报的页面访问来源的网站名称,属性取值由referrer、url(访问链接)属性的取值决定,详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_type

上报页面访问(Page_view)事件时,上报的页面访问来源类型。枚举值:inner:站内跳转;direct:直接访问;referring_site:外部链接;社交网络social_network分类和搜索引擎search_engine分类。详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

url_full_domain

页面访问(PageView)事件上报的页面访问域名,通过页面url推导,将url字符串解析为java.net.URL对象,并调用getHost()方法获得。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

title

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

predefine_page_alive

停留时长活跃


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,此事件会在页面活跃状态下,每分钟定时上报一次,或者在切换为非活跃状态时上报一次,用于检测页面是否活跃。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

predefine_page_close

停留时长关闭


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,会记录用户每次“进入页面、切换状态、离开页面”的时间戳,然后在离开或者关闭页面的时候上报此事件,将每一段“活跃状态”的时长相加作为整体的使用时长。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

active_time

active_time是页面切换的活跃状态次数

int

自动生成

由事件开关控制,无单独的属性开关

total_duration

用户访问页面,从开始到关闭的整个时长。单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

BytePlus

页面访问事件(predefine_page_)

事件名

事件显示名

事件开关

事件描述

事件属性名

属性说明

属性值类型

数据来源

是否自动上报

属性开关控制

predefine_pageview

页面访问

有。
在集成web端SDK时,初始化时配置 disable_auto_pv来控制开关,默认上报

pv事件,当sdk初始化完成后,即调用start事件,会发送一次pv,仅发送一次。会带上页面title、url、path、referrer等属性。
当你是SPA页面,页面发生改变,想重新上报PV时,可调用如下API,传入一些自定义参数,会和默认参数进行合并。( Tea.predefinePageView(params))

_ip_int

IP地址,属性取值为将client_ip属性取值转换为整数类型的数值。

int

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_full_domain

上报页面访问(Page_view)事件时,上报的页面访问来源的域名信息。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_site_name

上报页面访问(Page_view)事件时,上报的页面访问来源的网站名称,属性取值由referrer、url(访问链接)属性的取值决定,详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

referer_type

上报页面访问(Page_view)事件时,上报的页面访问来源类型。枚举值:inner:站内跳转;direct:直接访问;referring_site:外部链接;社交网络social_network分类和搜索引擎search_engine分类。详情请参见官网帮助文档https://www.volcengine.com/docs/84129/1270815。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

url_full_domain

页面访问(PageView)事件上报的页面访问域名,通过页面url推导,将url字符串解析为java.net.URL对象,并调用getHost()方法获得。

string

DataFinder服务端生成

由事件开关控制,无单独的属性开关

title

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

predefine_page_alive

停留时长活跃


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,此事件会在页面活跃状态下,每分钟定时上报一次,或者在切换为非活跃状态时上报一次,用于检测页面是否活跃。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

predefine_page_close

停留时长关闭


在初始化配置enable_stay_duration来控制是否开启停留时长功能(默认关),开启后上次此事件。

Web端开启停留时长功能后,会记录用户每次“进入页面、切换状态、离开页面”的时间戳,然后在离开或者关闭页面的时候上报此事件,将每一段“活跃状态”的时长相加作为整体的使用时长。

tiltle

sdk初始化完成后,pv会获取当前页面的document.title作为title。

string

系统API

由事件开关控制,无单独的属性开关

url

sdk初始化完成后,pv会获取当前页面的location.href作为url。

string

系统API

由事件开关控制,无单独的属性开关

url_path

sdk初始化完成后,pv会获取当前页面的location.pathname作为url_path。

string

系统API

由事件开关控制,无单独的属性开关

duration

duration是活跃时长,简单的说就是用户在实际使用的时长;单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关

active_time

active_time是页面切换活跃状态的次数

int

自动生成

由事件开关控制,无单独的属性开关

total_duration

用户访问页面,从开始到关闭的整个时长。单位毫秒。

int

自动生成

由事件开关控制,无单独的属性开关