广告创意相关API

7 自动合成标版创意绑定

接口:adcreative/binddeal

请求字段:

名称类型描述
data数组类型最多10个

data内容详细:

名称类型必填描述
dsp_order_idstringY广告创意素材id
deal_idintY程序化下单资源dealid

注意

  1. dsp_order_id和deal_id为多对多关系。
  2. 绑定的前提dsp_order_id需要审核通过且dealid需要存在有效订单
  3. 如果dsp_order_id有更新且触发了审核,则需要在审核通过之后重新发起绑定
  4. 当前支持的自动合成标版广告形式有ID:200362, 200363, 200364, 200365, 200366, 200367

接口返回:

名称类型描述
ret_codeint返回码
ret_msg数组类型返回内容
error_codeint错误补充码

ret_msg内容详细:

名称类型描述
dsp_order_idstring广告创意素材id
deal_idint程序化下单资源dealid
err_codeint需要时返回,成功时不返回,失败返回具体错误码。
err_msgstring需要时返回,成功时不返回,错误具体描述

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"
                }
            ]
}