快速找到所需文档，高效完成接入与排障

字段名称

字段类型

描述

特殊说明

app_key

STRING

APP唯一标识

umid

STRING

友盟设备ID

is_new_install

STRING

是否新增用户(1是0否)

install_datetime

STRING

首次安装时间

首次安装时间怎么理解？

在设备安装APP后第一次的上报时间，就是首次安装时间，可以根据首次安装的日期判断是否新增设备和新增留存。

新增留存：可以用首次安装日期和ds分区字段计算新增留存，比如7.1的新增是100，在7.2的数据中首次安装时间是7.1的是20，即7.1的次日新增留存是20%

app_channel

STRING

APP当前渠道

与install_channel区别是？

当前渠道和首次安装渠道，当前渠道指这条上报日志对应的渠道，首次安装渠道指第一次上报日志的渠道。

比如设备第一次在应用宝安装APP并上报日志，该设备的首次安装渠道就是应用宝，当前渠道也是应用宝。后续卸载APP再从OPPO应用商店安装APP，这次首次安装渠道是应用宝，当前渠道是OPPO应用商店。

注：版本同理，UAPP业务的渠道默认指首次安装渠道，而非当前渠道，即渠道归因到首次安装渠道

install_channel

STRING

APP首次安装渠道

app_version

STRING

APP当前版本

install_app_version

STRING

APP首次安装版本

carrier

STRING

设备运营商

os

STRING

操作系统：Android/iOS

os_version

STRING

操作系统版本

resolution

STRING

设备分辨率

network_access

STRING

入网类型

device_ip

STRING

设备IP

country

STRING

国家

province

STRING

省

city

STRING

城市

session_start

BIGINT

会话开始标识(1是0否)

session_end

BIGINT

会话结束标识(1是0否)

session_id

STRING

会话ID

session_duration

BIGINT

会话时长(毫秒)

activity_cnt

BIGINT

会话访问页面数

is_new_upgrd

STRING

是否版本升级

pre_channel

STRING

上一次渠道

pre_app_version

STRING

上一次版本

is_new_device

STRING

是否新发布机型

是否新发布机型怎么定义？

上市日期是近两个月的设备机型，使用频率低

imei

STRING

国际移动设备识别码

idfa

STRING

IOS广告标示符

mac

STRING

MAC地址

android_id

STRING

Android ID

idfv

STRING

Vendor标识符

open_udid

STRING

Open UDID

reg_app_name

STRING

APP名称(注册填写)

device_model

STRING

设备型号

std_device_model

STRING

标准设备型号

device_brand

STRING

设备品牌

std_device_brand

STRING

标准设备品牌

provider

STRING

APP用户账号第三方的标识符

puid

STRING

用户账号ID

is_new_reg

STRING

APP账户是否新注册(1是0否)

reg_channel

STRING

账户注册渠道

sdk_version

STRING

SDK版本

umid_from

STRING

小程序标识(0和null是uapp、1支付宝小程序、2阿里云微信小程序、3阿里云支付宝小程序)

cli_timestamp

BIGINT

客户端时间戳

svr_timestamp

BIGINT

服务器时间戳

log_date_time

STRING

日志时间(yyyy-mm-dd hh:mi:ss)

newoaid

STRING

匿名设备标识符

ds

STRING

分区(yyyymmdd)

字段名称

字段类型

描述

特殊说明

app_key

STRING

APP唯一标识

umid

STRING

友盟设备ID

install_channel

STRING

首次安装渠道

app_channel

STRING

APP当前渠道

sdk_version

STRING

SDK版本

app_version

STRING

APP当前版本

event_name

STRING

自定义事件名字

svr_timestamp

BIGINT

服务器时间戳

服务器时间戳具体怎么理解？与客户端时间戳怎么区分？

服务器时间是服务器收到日志的时间，客户端时间是在设备发生的时间且取的设备的时间。服务器时间准确率和填充率有保障，客户端时间受设备影响可能有少量异常。

比如在漏斗的场景，事件上报是批量的，还原发生时间的顺序就需要用到客户端时间；其他情况优先用服务器时间或分区日期即可

pre_app_version

STRING

升级前版本

screen_width

BIGINT

分辨率宽度

screen_height

BIGINT

分辨率高度

os_version

STRING

操作系统版本

device_brand

STRING

设备品牌

device_model

STRING

设备机型

std_device_model

STRING

标准设备机型

country

STRING

国家

province

STRING

省

city

STRING

城市

is_wifi

STRING

是否使用wifi(1是0否)

imei

STRING

IMEI

idfa

STRING

IDFA

is_new_install

STRING

新老用户(1是0否)

新老用户怎么判断？

通过首次安装时间的日期判断，首次安装时间的日期即这一天的新增。

新增的流程：设备安装APP后第一次上报日志，服务器判断是新增会生成对应的umid，在友盟设备库保留该记录，后续即可通过设备库判断是否新增。

cli_timestamp

STRING

客户端时间戳

客户端时间戳具体怎么理解？与服务端时间戳怎么区分？

同上

event_kv_json

STRING

参数和参数值数据，JSON结构

newsession_id

STRING

会话ID

session是怎么定义的？

涉及会话的切割逻辑，这块需要sdk同学完善，Android和ios也有差异

newprovider

STRING

用户通过第三方账号登陆时的标识符

newpuid

STRING

APP用户账号ID

newandroid_id

STRING

Android ID

newoaid

STRING

OAID(匿名设备标识符)

newsystem_properties

STRING

系统属性(扩展字段)

newevent_type

STRING

事件类型(0自定义事件,1预制事件)

ds

STRING

分区字段：yyyymmdd