7 自动合成标版创意绑定
接口:adcreative/binddeal
请求字段:
名称 | 类型 | 描述 |
---|---|---|
data | 数组类型 | 最多10个 |
data内容详细:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
dsp_order_id | string | Y | 广告创意素材id |
deal_id | int | Y | 程序化下单资源dealid |
注意:
- dsp_order_id和deal_id为多对多关系。
- 绑定的前提dsp_order_id需要审核通过且dealid需要存在有效订单;
- 如果dsp_order_id有更新且触发了审核,则需要在审核通过之后重新发起绑定。
- 当前支持的自动合成标版广告形式有ID:200362, 200363, 200364, 200365, 200366, 200367
接口返回:
名称 | 类型 | 描述 |
---|---|---|
ret_code | int | 返回码 |
ret_msg | 数组类型 | 返回内容 |
error_code | int | 错误补充码 |
ret_msg内容详细:
名称 | 类型 | 描述 |
---|---|---|
dsp_order_id | string | 广告创意素材id |
deal_id | int | 程序化下单资源dealid |
err_code | int | 需要时返回,成功时不返回,失败返回具体错误码。 |
err_msg | string | 需要时返回,成功时不返回,错误具体描述 |
sample:
req:
{
"dsp_id":100242,
"token":"1111111111111",
"sig": "111111111111111111111",
"time": 1650017461,
"data":[
{
"dsp_order_id": "78921112",
"deal_id": 123,
}
]
}
resp:if success
{
"ret_code":0,
"ret_msg":[
{
"dsp_order_id":"78921112",
"deal_id":123,
}
]
}
resp:if fail
{
"ret_code":1,
"ret_msg":[
{
"dsp_order_id":"6001",
"deal_id":123,
"err_code":1107,
"err_msg":"bind failed"
}
]
}
注意: 动漫标版场景在送审接口(adcreative/add)的data.ad_content结构体传参时,语音文件创意元素项请设置为空(仅作为占位符)
例如(display_id=200362):
{
.......
"display_id": "200362",
"ad_content": [
{
"file_url": "https://xxx.mp4"
},
{
"file_url": "https://xxxx.png"
},
{
"file_url": ""
},
{
"file_text": "这是个好的语音文案这是个好的语音文案"
},
{
"file_text": "timo-pro"
},
{
"file_text": "yunlong-pro"
}
]
}