设置用户属性 API

在运营增长平台中，用户属性可用于记录用户基本特征，如年龄、性别，注册时间等信息。
用户属性以用户表的形式进行存储记录，根据用户属性本身的规则（仅一次、覆盖、累计、追加）来确定设置的用户属性采取什么样的受理规则。通过下面的API您可以设置用户属性。
设置用户属性必须基于 CUID 进行设置，且该用户属性已存在于运营增长平台的数据中心。

请求方式

PUT

请求地址

PUT https://growth.jiguang.cn/smartop/api/v1/user/attribute

          PUT  https://growth.jiguang.cn/smartop/api/v1/user/attribute

此代码块在浮窗中显示

请求头

> Content-Type: application/json > Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

          > Content-Type: application/json
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

此代码块在浮窗中显示

QPS限制

QPS≤100

请求体参数

接口支持单条设置。

真实业务场景下，请不要携带注释，下方示例的注释仅为帮助开发者理解参数意义

{ "cuid":10362473, "data":{ "user_number_once":46.2, //用户属性名称和属性值 "user_string_once":"refef", "user_datetime_once": "2023-12-12 00:56:23" } }

          {
    "cuid":10362473,
    "data":{
        "user_number_once":46.2, //用户属性名称和属性值
        "user_string_once":"refef",
        "user_datetime_once": "2023-12-12 00:56:23"
    }
}

此代码块在浮窗中显示

字段	类型	必填	描述
cuid	Long	是	运营增长平台用户唯一ID
data	JSON Object	是	用户属性列表，key是属性名，value是属性值。属性值类型为bool，仅支持0/1的整数(0表示false,1标识true)。属性值类型为datetime，仅支持yyyy-MM-dd HH:mm:ss的字符串

用户属性名称需要提前在平台中创建，建议开发人员先行查看用户属性列表，再配置相应的用户属性值。

响应参数

字段	类型	必填	描述
code	Int	是	接口调用是否成功，0表示成功，其他值代表出错
msg	String	是	接口调用结果描述，对错误码的文字说明

成功响应

{ "code": 0, "msg": "ok" }

          {
    "code": 0,
    "msg": "ok"
}

此代码块在浮窗中显示

失败响应

{ "code": 40010, "msg": "用户属性[user_number_once1]不存在" }

          {
    "code": 40010,
    "msg": "用户属性[user_number_once1]不存在"
}

此代码块在浮窗中显示

错误码

错误码	错误码说明	解决措施
4009	接口鉴权失败	确认项目ID和项目密钥是否正确
40002	业务参数不合法	请检查data字段是否正确
40003	无效的CUID	确认该项目中是否有该CUID
40007	CUID为空	确认请求体中cuid是否为空
40009	用户属性值不能为空	确认请求体中用户属性的值是否为空
40010	用户属性不存在	确认是否在运营增长平台中创建了用户属性
-1	服务器内部错误	请联系极光技术支持