跳到主要内容

数据源添加


请求地址​

https://api.e.qq.com/v1.3/user_action_sets/add


请求方法​

POST


所属权限​

数据上报（User Actions）


请求参数​

参数名描述
access_token密钥信息，可在 DataNexus 的 数据源 - 【查看密钥】获取
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
typeenumY
数据源类型，见 枚举值
mobile_app_idinteger
应用 id，IOS：App Store id ； ANDROID：应用宝 id，type=ANDROID 或 IOS 时必填
wechat_app_idstring
微信 AppID，当 type = WECHAT 或 WECHAT_MINI_PROGRAM 或 WECHAT_MINI_GAME 时必填字段长度最小 2 字节，长度最大 64 字节
namestringC
数据源源名称，当 type=WEB 时必填，当 type=ANDROID 或 IOS 或 WECHAT 或 WECHAT_MINI_PROGRAM 或 WECHAT_MINI_GAME时，若未填写该字段，则默认通过 mobile_app_id/wechat_app_id 获取名称字段长度最小 1 字节，长度最大 32 字节
descriptionstring
用户行为源描述，字段长度最小 1 字节，长度最大 128 字节
usagesenum[]
接入用途，如需分发给 pKAM,填写 DEEP_DATA_COOPERATION
enable_conversion_claimboolean
是否开启转化归因，true：开启；false：不开启，不传则默认开启

请求体示例​

curl 'https://api.e.qq.com/v1.1/user_action_sets/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "type": "WEB",
    "name": "webuser_action_set",
    "description": "",
    "usages": []
}'

应答体结构​

名称类型描述
user_action_set_idinteger
用户行为源 id，通过 user_action_sets 接口 创建用户行为源时分配的唯一 id。请注意，当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时，必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id。

应答示例​

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "user_action_set_id": 1111111111
    }
}



该内容是否有帮助？