事件与属性字典
检索事件与属性
查询客户端与服务端的事件、操作记录、上下文及其参数约束。
| 标识符 | 说明 | 参数 | 敏感度与授权 | 适用平台 | |
|---|---|---|---|---|---|
$sdk_lifecycle页面与应用活动状态 | 尽力观察 Web 文档可见状态或原生应用活动状态；不代表 SDK 实例的创建或销毁。 | 事件属性 (2)： $lifecycle_state*string$lifecycle_scope*string | 目录标注非敏感 | Web iOS Android | |
$app_start应用启动与前台 | Android 生命周期集成或 iOS 显式 UIKit/Host 集成报告的启动和前台观测；不单独证明用户正在使用应用。 | 事件属性 (5)： $is_first_timeboolean$is_first_dayboolean$resume_from_backgroundboolean$is_passive_startboolean$start_sourcestring | 目录标注非敏感 | iOS Android | |
$app_end应用退后台 | 适配器或宿主报告的退后台观测，不代表进程终止，也不等待分析会话超时。 | 事件属性 (3)： $event_durationnumber$resume_from_backgroundboolean$screen_namestring | 目录标注非敏感 | iOS Android | |
$identity_login识别业务用户 | 记录 identify 或 switchUser 产生的业务用户绑定；服务端 trackSignup 的身份要求另见服务端条目。 | 操作载荷参数 (1)： userId*string | 受限 | Web iOS Android | |
$identity_user_cleared清除用户 | 清除业务用户，保留匿名上下文；需要轮转匿名边界时使用 signOut。 | 无专属参数 | 受限 | Web iOS Android | |
$identity_sign_out退出用户 | 清除业务用户并轮转匿名身份，隔离后续使用者。 | 无专属参数 | 受限 | Web iOS Android | |
$identity_bind绑定身份命名空间 | 显式绑定受控业务命名空间，不由 Provider 修改主身份。 | 操作载荷参数 (1)： namespace*string | 受限 | Web iOS Android | |
$alias身份别名 | 显式记录别名关系，不能据此覆盖历史事件快照。 | 操作载荷参数 (1)： aliasId*string | 受限 | Web iOS Android | |
$group组织上下文 | 设置 groupId；组织上下文不自动成为 tenantId 或认证凭据。 | 操作载荷参数 (2)： groupId*stringtraitsobject | 受限 | Web iOS Android | |
$reset重置匿名上下文 | 清除业务身份和组织状态，建立新的匿名与会话边界。 | 无专属参数 | 目录标注非敏感 | Web iOS Android | |
$profile_set设置画像属性 | 提交设置指定画像属性的意图；实际写入由接收端处理。 | 操作载荷参数 (1)： properties*object | 受限 | Web iOS Android | |
$profile_set_once首次设置画像属性 | 提交首次设置画像属性的意图；实际写入由接收端依据已有状态处理。 | 操作载荷参数 (1)： properties*object | 受限 | Web iOS Android | |
$profile_unset移除画像属性 | 提交移除指定画像属性键的意图；实际结果由接收端决定。 | 操作载荷参数 (1)： keys*array | 目录标注非敏感 | Web iOS Android | |
$profile_increment累加画像数值 | 提交对指定画像数值属性进行增量更新的意图；实际结果由接收端决定。 | 操作载荷参数 (1)： properties*object | 受限 | Web iOS Android | |
$profile_append追加画像数组 | 提交向画像数组追加受限类型值的意图；实际结果由接收端决定。 | 操作载荷参数 (1)： properties*object | 受限 | Web iOS Android | |
$item_set设置实体属性 | 按 itemType 与 itemId 提交实体属性更新意图；实际结果由接收端决定。 | 操作载荷参数 (3)： itemType*stringitemId*stringproperties*object | 受限 | Web iOS Android | |
$item_delete删除实体 | 按 itemType 与 itemId 记录实体删除操作。 | 操作载荷参数 (2)： itemType*stringitemId*string | 受限 | Web iOS Android | |
$pageview页面浏览 | 手工页面 API、Web 页面插件/路由集成或原生桥接记录的页面访问。 | 事件属性 (11)： $urlstring$titlestring$referrerstring$page_view_idstring$route_templatestring$route_namestring$frameworkstring$is_first_visitboolean$is_first_dayboolean$first_observed_atnumber$first_observed_timezone_offset_minutesnumber | 目录标注非敏感 | Web iOS Android | |
$screen屏幕浏览 | 宿主声明逻辑屏幕名称；三端都可调用，自动路径依赖集成。 | 事件属性 (2)： $screen_name*string$previous_screen_namestring | 目录标注非敏感 | Web iOS Android | |
$application_install首次安装观测 | SDK 本地安装标记范围内的首次符合条件观测；标记清除或不可持久时可能再次出现，不等同应用商店下载或操作系统安装时间。 | 无专属参数 | 目录标注非敏感 | iOS Android | |
$application_update应用版本与构建变化 | 比较已知 version/build；旧快照缺失或不可解析时按基线处理，同版本补齐未知 build 不产生变化事件，降级也可能作为变化记录。 | 事件属性 (5)： $previous_version*string$current_version*string$previous_buildstring$current_buildstring$change_typestring | 目录标注非敏感 | iOS Android | |
$push_received推送接收 | 宿主报告的推送接收观测；SDK 不核验送达，也不主动读取完整推送正文。 | 事件属性 (3)： $message_idstring$campaign_idstring$push_servicestring | 受限 | iOS Android | |
$push_click推送点击 | 记录宿主报告的推送点击观测，不代表推送送达率或业务转化。 | 事件属性 (3)： $message_idstring$campaign_idstring$push_servicestring | 受限 | iOS Android | |
$deep_link_open深链打开 | 记录宿主报告或显式集成的受控深链观测，不保证目标页面或业务处理成功。 | 事件属性 (4)： $url*string$link_typestring$resolutionstring$match_methodstring | 受限 | iOS Android | |
$page_leave页面与屏幕离开 | 由 Web 插件或原生宿主记录离开及有界时长；不是最终上传保证。 | 事件属性 (6)： $urlstring$page_view_idstring$screen_namestring$event_duration*number$reason*string$is_finalboolean | 目录标注非敏感 | Web iOS Android | |
$web_stayWeb 可见停留 | 由 Web 停留插件记录页面可见时长片段；不等同页面打开后的总墙钟时间。 | 事件属性 (6)： $url*string$page_view_id*string$event_duration*number$interval_duration*number$reason*string$is_finalboolean | 目录标注非敏感 | Web | |
$page_load页面加载度量 | Web 插件或原生宿主提供的加载观测，原生时长由宿主度量。 | 事件属性 (8)： $urlstring$page_view_id*string$screen_namestring$titlestring$referrerstring$event_durationnumber$navigation_typestring$navigation_idstring | 目录标注非敏感 | Web iOS Android | |
$scrollWeb 滚动 | 由显式启用的 Web 插件记录深度与视口，不读取输入内容。 | 事件属性 (6)： $url*string$page_view_id*string$depth_percent*number$viewport_position*number$viewport_height*number$page_height*number | 目录标注非敏感 | Web | |
$element_clickWeb 元素点击 | 显式允许范围内的 DOM 点击观测，不等同业务操作成功；无障碍标签仅在显式启用时采集。 | 事件属性 (8)： $url*string$element_type*string$element_selector*string$element_idstring$track_idstring$test_idstring$rolestring$aria_labelstring | 受限 | Web | |
$web_rage_clickWeb 连续点击 | 插件观察到窗口内多次点击，不能据此判断用户情绪。 | 事件属性 (7)： $url*string$element_type*string$element_selector*string$click_count*number$time_window_ms*number$element_idstring$track_idstring | 受限 | Web | |
$sdk_exception异常观测 | 记录受支持路径观察到的有限异常信息；采样、去重及限流可能减少记录，不代表完整崩溃监控或异常总数。 | 事件属性 (7)： $exception_name*string$exception_message*string$fingerprint*string$source*string$stackstring$component_stackstring$frameworkstring | 受限 | Web iOS Android | |
$sdk_performance页面与启动性能观测 | Web 文档导航性能或原生宿主报告的应用启动耗时；不同平台的测量范围不同。 | 事件属性 (13)： $metric*string$event_durationnumber$source*string$navigation_typestring$response_msnumber$dom_content_loaded_msnumber$load_event_msnumber$first_paint_msnumber$first_contentful_paint_msnumber$resource_countnumber$resource_duration_msnumber$resource_transfer_bytesnumber$navigation_idstring | 目录标注非敏感 | Web iOS Android | |
$sdk_network_performance网络性能汇总 | 平台插件或宿主提供的聚合网络度量，不采集请求正文。 | 事件属性 (4)： $event_duration*number$resource_count*number$resource_transfer_bytes*number$failed_count*number | 目录标注非敏感 | Web iOS Android | |
$sdk_web_vital网页体验指标（Web Vitals） | Web 插件提供的浏览器体验指标。 | 事件属性 (14)： $metric*string$value*number$ratingstring$source*string$metric_id条件必填string$document_id条件必填string$unit条件必填string$measurement_scope条件必填string$observation_id条件必填string$navigation_type条件必填string$report_versionstring$algorithm_version条件必填string$revision条件必填number$value_clamped条件必填boolean | 目录标注非敏感 | Web | |
$sdk_attribution渠道来源观测 | 记录获授权的来源信息；归因事件本身不证明每条转换事件均带来源。 | 事件属性 (10)： $utm_sourcestring$utm_mediumstring$utm_campaignstring$utm_contentstring$utm_termstring$gclidstring$fbclidstring$referrerstring$landing_urlstring$attribution_model*string | 受限 | Web iOS Android | |
$app_click原生点击 | Android 自动采集集成或原生宿主桥接报告的点击观测，不代表业务操作成功。 | 事件属性 (6)： $action*string$element_type*string$track_idstring$element_class_namestring$indexnumber$screen_namestring | 受限 | iOS Android | |
$sdk_interaction语义交互 | Web 插件或宿主声明的语义交互，不推断业务结果。 | 事件属性 (6)： $action*string$element_type*string$track_idstring$element_class_namestring$indexnumber$screen_namestring | 受限 | Web iOS Android | |
$sdk_exposure元素曝光 | 宿主显式报告或插件按配置阈值确认的曝光，不代表完整可见生命周期。 | 事件属性 (3)： $exposure_id*string$event_duration*number$visible_ratio*number | 受限 | Web iOS Android | |
$web_form_submitWeb 表单提交 | 匹配允许范围的表单 submit 事件，不代表提交未被取消或业务数据已被接受。 | 事件属性 (3)： $url*string$element_type*string$form_id_hashstring | 受限 | Web | |
$web_downloadWeb 下载点击 | 对带 download 属性且匹配允许范围的链接点击进行观测，不代表文件下载完成。 | 事件属性 (3)： $url*string$element_type*string$file_name_hashstring | 受限 | Web |