2.修改
接口:adcreative/update
请求字段:
名称 | 类型 | 描述 |
---|---|---|
data | 数组类型 | 最多10个 |
说明:已下线的创意不可再修改
data内容详细:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
dsp_order_id | string | Y | 广告创意素材id,dsp需保证该id在dsp测的唯一性 |
advertiser_id | int | Y | 广告主id 和 name 二选一,都传的话优先使用id |
advertiser_name | string | Y | 同上 |
display_id | int | Y | 广告形式id |
targeting_url | string | Y | 落地页,支持302 |
monitor_url | 数组类型 | N | 曝光监测地址,最多5个 |
monitor_position | 数组类型 | N | 在设置了monitor_url的情况下配合使用。仅针对视频素材,监测请求位置 |
monitor_settle_bill | 数组类型 | N | 在设置了monitor_url的情况下配合使用。(仅支持PDB) |
click_monitor_url | 数组类型 | N | 点击监测地址,最多3个 |
ad_content | 数组类型 | Y | 创意素材内容,包括视频、图片、文本等。需严格按照广告形式的定义顺序来指定上传。 |
ad_ext | 对象类型 | N | 高级扩展参数。详见下面请求示例 |
ad_content内容详细:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
file_text | string | Y | file_text,file_url 必须指定其中一个,按照广告形式id的定义校验,文件大小,类型,尺寸 |
file_url | string | Y | 同上 |
file_md5 | string | N | 仅针对视频文件,如果指定了md5值,其它两项就不再需要传了。 |
说明:
file_md5 字段仅针对视频文件,如果传入了该参数,则先查找该md5值的素材以前是否传入过adx系统,如果已经传入过则直接使用该文件,不在拉取素材,节省了网络传输流量和时间。
ad_ext内容详细:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
app_info | 对象类型 | N | 同adcreative/add |
share_info | 对象类型 | N | 同adcreative/add |
接口返回:
名称 | 类型 | 描述 |
---|---|---|
ret_code | int | 返回码 |
ret_msg | 数组类型 | 返回内容 |
error_code | int | 错误补充码 |
ret_msg内容详细:
名称 | 类型 | 描述 |
---|---|---|
dsp_order_id | string | dsp唯一订单号 |
err_code | int | 需要时返回,成功时不返回,失败返回具体错误码。 |
err_msg | string | 需要时返回,成功时不返回,错误具体描述 |
注:
广告主id/名称(advertiser_id/advertiser_name)和广告形式(display_id)不允许修改。
请求示例:
{
"data":[
{
"dsp_order_id":"6001",
"advertiser_id":100,
"display_id":10389,
"deal_id":1234567,
"targeting_url":"http://xinwen.qq.com/adtargetpage?a=1",
"monitor_url":[
"http://monitor.qq.com/monitor1",
"http://monitor.qq.com/monitor2"
],
"monitor_position":[
2,
5
],
"monitor_settle_bill":[
1,
0
],
"click_monitor_url":[
"http://click.qq.com/click1"
],
"visible_monitor_url":[
"http://visible.qq.com/cgi?compaign="
],
"ad_content":[
{
"file_text":"广告标题 new"
},
{
"file_url":"http://cdn.qq.com/pic640x246.jpg"
},
{
"file_url":"http://cdn.qq.com/pic114x114.jpg"
},
{
"file_text":"摘要 new"
},
{
"file_text":"广告主名称 new"
}
],
"ad_ext":{
"app_info":{
"product_type": 3,
"app_id": 989673964
}
},
"mini_program_id": "gh_abcdef",
"mini_program_path": "abcdef"
}
]
}
返回示例(成功):
{
"ret_code":0,
"ret_msg":[
{
"dsp_order_id":"6001",
}
]
}
返回示例(失败):
{
"ret_code":1,
"ret_msg":[
{
"dsp_order_id":"6001",
"err_code":503,
"err_msg":"advertiser_id/advertiser_name can not be modified for update."
}
]
}