自定义用户属性日志
段是从 Hive SDK 收集的信息,可以通过自由定义属性值(除了预定义属性)进行传输和选择。
发送属性¶
您可以使用Hive SDK客户端日志传输来发送用户定义的属性值。
日志传输的示例代码可以通过日志定义功能中的客户端源生成特性进行检查。
属性传输规范¶
字段采用驼峰命名法(例如,dateTime),并区分大小写。在以下情况下,值将不会被保存。
- 如果字段名称未按规定定义(例如,“time”)
- 如果字段名称与字段名称不完全匹配(例如,“app_id”)
- 如果值不是为每个字段定义的类型(例如,“474392047”用于“playerid”字段)
注意事项
- 字符串:字符串数据最大为 1 MB
- 整数:有符号 64 位(-9,223,372,036,854,775,808 到 9,223,372,036,854,775,807)数据
- 如果发送的数据与每个字段的类型不匹配,则相应的字段可能无法正确保存,因此您必须发送与类型匹配的值。
字段名称 | 描述 | 类型 | 必需 |
---|---|---|---|
playerId | 唯一标识用户在 Hive 认证中的密钥 使用 [Hive SDK 客户端日志传输功能] 时,会自动发送 | 整数 | 是 |
uid | Hive 会员中的用户密钥。UID 大于 90000000000 表示访客用户密钥 使用 Hive SDK 客户端日志传输功能 时,会自动发送 | 整数 | |
appId | 由应用中心发出的appId 使用Hive SDK客户端日志传输功能时,会自动发送 | STRING | Y |
guid | 属性行的唯一键值 推荐使用类似uuid的随机字符串格式 使用Hive SDK客户端日志传输功能时,会自动发送 | STRING | Y |
datatime | 属性发生时间,格式为“YYYY-MM-DD hh:mm:ss” (例如,“2022-11-15 10:20:10”) 使用Hive SDK客户端日志传输功能时,会自动发送 | STRING | Y |
timezone | “dateTime”的时区 可以通过时区验证使用客户端IP获取 如果为空或没有值,则根据KST确定 (例如,“GMT+09:00”) 使用Hive SDK客户端日志传输功能时,会自动发送 | STRING | Y |
category | 固定为“pub_user_property_log” | STRING | Y |
propertyDataType | 可以设置为游戏内用户属性值的数据类型的值为以下4种之一(例如,“string”)。 * “string“:当属性值需要被区分为字符串时 * “integer“:当属性值需要被区分为整数时。如果属性需要聚合,则聚合结果应为整数 * “float“:当属性值需要被区分为浮点数时。如果属性需要聚合,则聚合结果应为浮点数 * “timestamp“:当属性值需要被区分为时间值时。格式应为yyyy-mm-dd hh:mm:ss 用于在创建段时提供选择属性值的数据类型的能力 | STRING | Y |
propertyName | 用户在游戏中拥有的属性值的名称(例如,“成功状态”) 如果属性值为英文,则不区分大小写 如果传输的属性值超过28个字节(包括空格),则在段页面上显示时可能会出现换行。 用于在创建段时选择属性 | STRING | Y |
propertyValue | 游戏内用户的属性值(例如,“失败”) 用于在创建段时选择与属性名称对应的值 | STRING | Y |
检查发送的属性¶
- 您可以在发送用户属性后在日志定义功能中检查。
- 如果用户属性定义中的所有必填字段都已成功输入值,则在创建细分时可以选择用户。