广告创意相关API

2.修改

接口:adcreative/update
请求字段:

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

说明:已下线的创意不可再修改

data内容详细:

名称类型必填描述
dsp_order_idstringY广告创意素材id,dsp需保证该id在dsp测的唯一性
advertiser_idintY广告主id 和 name 二选一,都传的话优先使用id
advertiser_namestringY同上
display_idintY广告形式id
targeting_urlstringY落地页,支持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_textstringYfile_text,file_url 必须指定其中一个,按照广告形式id的定义校验,文件大小,类型,尺寸
file_urlstringY同上
file_md5stringN仅针对视频文件,如果指定了md5值,其它两项就不再需要传了。

说明:
file_md5 字段仅针对视频文件,如果传入了该参数,则先查找该md5值的素材以前是否传入过adx系统,如果已经传入过则直接使用该文件,不在拉取素材,节省了网络传输流量和时间。

ad_ext内容详细:

名称类型必填描述
app_info 对象类型N同adcreative/add
share_info 对象类型N 同adcreative/add

接口返回:

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

ret_msg内容详细:

名称类型描述
dsp_order_idstringdsp唯一订单号
err_codeint需要时返回,成功时不返回,失败返回具体错误码。
err_msgstring需要时返回,成功时不返回,错误具体描述

注:

广告主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."
            }
        ]
    }