跳到主要内容

数据源分发关系更新


请求地址

https://api.e.qq.com/v3.0/data_source_dispatch/update


请求方法

POST


所属权限

数据上报(User Actions)


请求参数

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

请求体类型

application/json


请求体参数

阅读说明:Y - 必填;C - 条件选填(conditional),请关注“描述”信息;空 - 非必填

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
data_source_scenesarrayY
数据源分发列表,不能大于 50KB,数组最小长度 1,最大长度 50
user_action_set_idintegerY
数据源 id,通过DataNexus创建数据源时分配的唯一 id,请注意,当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时,必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id
scenesarrayY
应用场景信息
sceneenumY
应用场景类型,见 枚举值
asset_idsstring
资产列表
data_set_idintegerC
数据集ID,更新商品应用场景时必填
catalog_idintegerC
商品库ID,更新动态商品广告应用场景时必填
switch_typeenum
数据源分发开关,见 枚举值

请求体示例

curl 'https://api.e.qq.com/v1.1/data_source_dispatch/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": 111111,
"switch_type": "SWITCH_ON",
"data_source_scenes":[
{
"data_source_id": 1111111111,
"scenes": [
{
"scene": "DMP",
"asset_ids": [
{
}
]
}
]
}
]
}'

应答体结构

名称类型描述
success_countinteger
成功个数
fail_listarray
文件分发失败信息
user_action_set_idinteger
数据源 id
scenesarray
应用场景信息
scenestring
应用场景id,见 枚举值
asset_idsarray
资产列表
data_set_idstring
数据集id,更新商品应用场景时必填
catalog_idstring
商品库ID,更新动态商品广告应用场景时必填
fail_reasonstring
失败原因
fail_reasonstring
失败原因
fail_reasonstring
失败原因

应答体示例

{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"fail_list": [],
"success_count": 1
}
}



该内容是否有帮助?