支持的数据格式（自定义事件/属性）

DataTester支持多种语言的SDK，这些SDK接口上报的数据，在底层数据模型中需要使用统一的数据格式，系统为您提供的预置事件/属性已遵循此统一的数据格式，如果您需要自定义事件/属性，需严格按照支持的数据格式来定义自定义事件/属性的数据格式。本文为您介绍详细的数据格式要求。

使用各类型SDK采集上报数据时：

• 需要先在各端中集成对应的SDK。
• 后续SDK会将采集的数据通过JSON格式进行上报。
• 收到上报数据后，系统会对JSON数据进行处理并落库，落库后的数据类型与上报的JSON中的数据类型有对应关系。

其中：

• 各端集成SDK时，部分系统预置事件/属性支持在代码中配置是否需要采集上报，也支持定义自定义事件/属性。
• 支持采集上报的JSON数据类型，以及与落库后的数据库数据类型的对应关系详情请参见下文的属性数据类型章节；上报的JSON示例可参见下文的日志结构章节。
• 数据采集上报后，系统对上报数据进行处理落库时，不同类型的数据可进行计算生成不同的指标数据，便于后续的分析使用，支持的计算应用详情请参见下文的不同数据类型应用章节。
• 数据采集上报时，采集上报的限制条件详情请参见下文的上报数据的限制章节。

根据增长分析的业务数据分析场景，Finder为您将事件和属性进行了以下业务层面的定义分类，后续您在SDK集成与埋点配置时，可根据业务需要配置对应的事件/属性。

注意事项

• 自定义事件/属性时，取值不要包含转义字符。
  创建自定义事件或属性时，需保障对应事件及属性的格式符合本文的格式要求，且自定义属性的取值不要包含例如转义字符类的特殊字符，例如“\n”。如果包含这类特殊字符，可能会导致后续数据能上报成功，但是查询分析时会导致查询结果不正确，您需要删除其中的特殊字符或使用虚拟属性。
• 一个属性的数据类型由首次落库时的数据类型决定。
  例如，您在控制台界面新增了一个事件属性，此事件属性的数据类型为string。新建完成后此属性即已落库，后续在进行数据上报时，如果上报的属性数据类型又变为number，则不影响已落库的属性数据类型，只会导致上报的属性数据类型与已落库的属性数据类型不一致而导致可能出现上报错误等问题。
• 您可以在产品界面应用管理-数据管理中，可查看现有环境中属性的数据类型。
  

属性数据类型对应关系

数据类型有以下几种：

• 不同属性数据类型，可计算的指标

• 不同属性数据类型，作为筛选条件可用的操作符

• 字符串类型可以选择“为空”和“不为空”用于匹配 null 或非 null。
• 日期类型属性有一个单独的筛选规则（如下表）：

3.1 一般限制

• 单个应用的上报的事件数总量不限制；
• 单个应用支持元事件种类不超过1000个（不同应用之间互不影响，不含虚拟事件）；
• 单个事件的属性数量推荐300个以内，最多不超过500个（不同事件之间互不影响）；
• 用户属性的属性数量最多不超过 500个；
• 单个应用自定义事件公共属性数量不超过100个；
• 事件名建议不超过64个字符，最长不超过255个字符；
• 事件属性名和用户属性名称最长不超过64个字符；
• 属性值长度建议不超过255字符，特殊情况如url等最大支持1024字符；
• 事件属性名称禁止命名为user_unique_id、ssid、event_id；
• 属性名不允许和预置属性名称相同；预置属性文档可查看预置属性。

3.2 事件时间限制

使用客户端 SDK （iOS、Android）导入的数据，服务端默认只接收事件发生时间在接收时间向前 7 天内和向后24小时内数据。

3.3 命名限制

1. events表中，同一个属性名，不允许存在多个属性类型，只有一种属性类型。
2. users表中，同一个属性名，不允许存在多个属性类型，只有一种属性类型。
3. 同一个属性名，如果在events和users表中同时存在，在两表中数据类型可以相同，也可以不同。

3.4 属性长度和范围的限制

入库后可看到的数据格式分别如下：

• 私有化

{
    "time": 1606301031,
    "server_time": 1606249381,
    "local_time_ms": 1606301031000,
    "device_id": "6912716898461553676",
    "os": "ios",
    "params": {
        "package": "package",
        "app_version": "1.0.6",
        "device_model": "iphone 6s plus",
        "timezone": "8.0",
        "os_version": "10.3.2",
        "session_depth_range": "5",
        "session_id": "762891435873043",
        "network_carrier": "TELCEL",
        "language": "zh",
        "exit_page": "http://datarangers.com.cn/pages/index/3",
        "product_name": "default_to_b",
        "resolution": "375x667",
        "platform": "ios",
        "loc_country_id": "1814991",
        "app_channel": "线下扫码下载",
        "device_brand": "苹果",
        "browser": "chrome",
        "os_name": "ios",
        "loc_province_id": "1280239",
        "session_duration_range": "100-200",
        "client_ip": "118.213.201.135",
        "loc_city_id": "1279540",
        "browser_version": "68.0.3440",
        "network_type": "mobile",
        "duration": 117,
        "session_depth": 5,
        "screen_width": 375,
        "localtime_ms": 1606301031000,
        "screen_height": 667,
        "session_duration": 117,
        "is_login": 1
    }
}

• SaaS

{
        "user": {
            "ssid": "",                // SSID
            "user_unique_id": "",      // user_unique_id，存储于 string_profiles{'uuid'}
            "web_id": 0,               // 网页端的匿名ID，存储于 string_profiles{'web_id'}
            "device_id": 0,            // 移动端,小程序端的匿名ID
            "user_register_time": ""   // 用户首次事件触发时间
        },
        "params": {
            "language": "zh-CN",
            "region": "",
            "app_version": "unknown",
            "app_region": "",
            "app_channel": "",
            "app_language": "",
            "os_version": "10",
            "os_name": "10",
            "device_model": "Windows NT 10.0",
            "device_brand": "",
            "network_type": "",
            "network_carrier": ""
        },
        "items":{
            "sku": [{
                "id": "",
                "property_1": "",     // 当前item定义的属性1
                "property_1": "",     // 当前item定义的属性2
            }]
        },
        "event_name": "predefine_pageview",
        "app_id": "2174",             // string, rangers 中的应用id
        "app_name": "数据发现者",       // string, rangers 中的应用名
        "server_time": 1606783082,    // int(timestamp), 服务端收到事件的时间, 精确到 ms
        "time": 1606783080,           // int(timestamp), time = local_time_ms/1000，单位为秒。
        "event_date": 1606783080      // date, 基于 time 计算，但只精确到天
}

Q1： 各端数据类型传输不一致，系统如何处理？如何修改？

描述：例如IOS端先传入A属性的格式为数值类型，安卓端后传入A属性的格式为字符串类型，此时系统如何处理，结果会如何？
A2：一个属性的类型由首次导入的数据类型决定，如果后续传入不同数据类型的数据，系统会尝试做转换，如果转换成功，则入库。如果转换失败，则属性信息值为‘0’入库，相当于属性信息丢失，但事件正常上报。
具体转换成功信息如下表：

注意
需要在数据校验侧规避这一问题，如果发生，请错误端及时调整数据格式，否则会引发数据丢失。

Q2： 是否接受时间戳string的上报，会自动解析成datetime格式吗？

A3：时间戳不支持，只支持日期时间的格式。

Q3：datetime是否接受按天级别格式的数据，"yyyy-MM-dd"

A4：支持。（上报格式："yyyy-MM-dd"）

Q4： 埋点设计时，如何选择正确的数据类型？

Q5：为什么会一段的版本值？不是版本格式要求至少两段么？

默认情况下，系统在遇到被“.”切割为至少两段的数据时（例如 2.0），会自动判断其为版本类型。而对于已知的版本类型的字段，我们会将这个限制放开，允许没有“.”，例如：2 这样的值上报。因为在一些情况下，版本号只有一段。当然对于这种情况，你也可以选择将版本号作为 int 类型上报。