You need to enable JavaScript to run this app.
导航
增长分析 DataFinder
  • 文档首页
    • /增长分析 DataFinder/开发者指南/重要基础知识（必读）/支持的预置事件和属性/预置用户属性/预置事件公共属性
预置用户属性/预置事件公共属性
最近更新时间：2025.01.02 20:12:54首次发布时间：2024.04.30 15:17:23
我的收藏

系统为您提供了大量预置用户属性，也为您提供了自定义绑定用户属性的预置事件，便于您通过此事件自定义用户属性。

预置用户属性/预置事件公共属性

说明

DataFinder的默认用户属性的统计口径为ssid，预置用户属性的统计口径也为ssid。

属性名

SaaS-非云原生

SaaS-云原生

私有化

属性值类型

数据来源

属性描述

web_id

支持，是预置事件公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

device_id

不支持

支持，是预置事件公共属性

支持，是预置事件公共属性

String

用户传入

region

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

系统地区

loc_country_id

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

国家（数据构建时根据client_ip生成）

sdk_version

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

固定值

SDK版本

utm_term

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

广告推广字词

app_version

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

软件版本

注意

在SaaS-非云原生和海外环境中，app_version的格式必须为x.x.x的格式，如果格式不符合要求，系统会自动为您转变为该格式。例如上报的为12.1，实际入库时会被转变为1.2.1。

app_language

支持，是预置用户公共属性

不支持

不支持

String

用户传入

软件语言

client_ip

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

resolution

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

分辨率

continent

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

国家所属大洲（数据构建时根据client_ip生成）

app_channel

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

渠道

loc_province_id

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

省份（数据构建时根据client_ip生成）

language

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

系统语言

age

支持，是预置用户公共属性

不支持

不支持

String

browser_version

支持，是预置用户公共属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

浏览器版本

sdk_lib

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

固定值

SDK类型

user_is_new

支持，是预置用户属性

支持，是预置用户属性

支持，是预置用户属性

Number

服务端生成

新老用户（user_is_new）和是否首日访问（$is_first_day）两者都是根据用户属性激活时间（first_event_time，SaaS-云原生和私有化环境）/注册时间（$user_register_time，SaaS-非云原生环境）来进行计算的，最主要的区别在于前者受所选时间周期的影响，而后者不受影响，因此后者在不同的图表类型中得到的计算结果有更好的一致性。

  • 是否首日访问（$is_first_day）：目标事件和首个事件发生在同一天。
  • 新老用户（user_is_new）：目标事件和首个事件发生在同一周期。比如在柱形图中，周期就是用户所选的时间范围。

更多两者的逻辑对比和介绍请参见下文的逻辑说明：新老用户/首日访问的逻辑说明章节。

注意

  • **建议使用是否首日访问（$is_first_day）**来判断新老用户。
  • 仅在DataFinder的高级分析内可使用新老用户（user_is_new），其它场景尽量不要直接使用新老用户（user_is_new），数据可能会不符合用户预期。
  • 如果需要灵活设置时间范围时，也可以使用用户属性激活时间（first_event_time，SaaS-云原生、私有化环境）/注册时间（$user_register_time，SaaS-非云原生环境）。

os_version

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

系统版本

platform

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

固定值

数据上报的的平台属性。

说明

较早版本的DataFinder曾使用过app_platform预置属性，此属性值不存储在元数据中，可在分析工具中使用。这个属性是来自DataFinder数据流系统的识别补充，即，app_platform的取值并不是来自真实属性的上报，是DataFinder数据流系统根据逻辑推导出来的。

custom_mp_platform_app_version

支持，是预置用户属性

不支持

不支持

String

平台版本号

custom_mp_platform

支持，是预置用户属性

不支持

不支持

String

小程序平台

utm_source

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

广告推广渠道

os_name

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

操作系统

network_type

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

网络类型

ab_version

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

  • SaaS-云原生/非云原生：int
  • 私有化：list

AB实验VID

origin_ab_version

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

  • SaaS-非云原生：int
  • SaaS-云原生/私有化：list

宽口径的AB实验VID，关联A/B测试的ablog表进行筛选。用户首次入组后始终统计在当前组，即后续用户分组变化后仍然会被统计在首次的分组。实验统计使用该口径。

custom_mp_platform_basic_version

支持，是预置用户属性

不支持

不支持

String

小程序基础库版本号

utm_medium

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

广告推广媒介

device_model

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

设备型号

browser

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

浏览器

custom_rangers_mp_from_uid

支持，是预置用户属性

不支持

不支持

String

network_carrier

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

运营商（数据构建时会有清洗逻辑到设备库进行映射，如果映射不到就使用上报的值）
iOS端不支持收集运营商相关属性数据。

utm_campaign

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

广告推广活动

utm_content

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

广告推广内容

brand（SaaS-非云原生）
device_brand（
Saas-云原生/私有化）

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

系统 API

手机品牌

app_region

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

软件地区

loc_city_id

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

服务端生成

城市（数据构建时根据client_ip生成）

user_id

支持，是预置用户属性

支持，是预置事件公共属性

支持，是预置事件公共属性

String

用户ID

first_event_time

不支持

支持，是预置用户属性

支持，是预置用户属性

String

服务端生成

激活时间

last_active_date

不支持

支持，是预置用户属性

支持，是预置用户属性

String

服务端生成

最后活跃日期

toutiao_mid1

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量图片素材ID

toutiao_mid2

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量标题素材ID

toutiao_mid3

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量视频素材ID

toutiao_mid4

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量搭配试玩素材ID

toutiao_mid5

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量落地页素材ID

toutiao_mid6

不支持

支持，是预置用户属性

不支持

String

广告监测

巨量安卓下载详情页素材ID

toutiao_union_site

支持，是预置用户属性

支持，是预置用户属性

不支持

String

广告监测

巨量广告对外广告位编码

asa_keyword_id

支持，是预置用户属性

支持，是预置用户属性

不支持

String

广告监测

苹果搜索广告关键字ID

activation_channel

支持，是预置用户属性

支持，是预置用户属性

不支持

String

服务端生成

激活的app渠道包

用户属性绑定

事件名

事件显示名

属性

__profile_set

用户属性

属性为自定义的用户属性

__profile_set_once

用户属性

属性为自定义的用户属性

__profile_unset

取消用户属性

属性为自定义的用户属性

__profile_increment

增量用户属性

属性为自定义的用户属性

__profile_append

增加用户属性

属性为自定义的用户属性

逻辑说明：首日访问/新老用户的逻辑说明

逻辑说明

**是否首日访问（$is_first_day）和新老用户（user_is_new）**两者都是根据用户属性激活时间（first_event_time，SaaS-云原生和私有化环境）/注册时间（$user_register_time，SaaS-非云原生环境）来进行计算的。

是否首日访问（$is_first_day）的计算逻辑

新老用户（user_is_new）的计算逻辑（不推荐使用）

首日访问的数据计算结果 = 指标事件激活/注册的时间与指标事件发生的事件是同一天的数据结果。
以SaaS-云原生/私有化环境为例，以下的两个指标的配置结果等同。
Image

一定时间范围内新用户的数据计算结果 = 在这个时间范围内，指标事件激活，且指标发生的数据。
以SaaS-云原生/私有化环境为例，以下的两个指标的配置结果等同。
Image
注意：由于新老用户（user_is_new）的数据结果受所选时间周期的影响，不同的图表对于时间周期的计算逻辑不一致，因此**新老用户（user_is_new）**的数据在不同的图表中可能会与会在指标事件激活/注册的时间的计算结果不一致。
例如，在折线图中，每一天的数据为指标事件当天的数据，而非时间范围内的总计数据，因此上述等同的两个指标结果会出现差异。
Image

使用示例：最近N天的新用户数

例如筛选最近7天（不含今天）的新用户数时，配置示例如下：

高级分析工具中

其他场景

以事件分析为例：
Image
可以使用是否首日访问、是否新用户、激活时间/注册时间来过滤指标事件。

说明

如上文逻辑说明所示，使用是否新用户时，可能不同的图表类型的结果与其他指标的结果会出现不一致。

以用户分群的分群规则配置为例：

  • 使用是否首日访问过滤圈选：
    Image
  • 使用激活时间/注册时间过滤圈选：
    Image