广告创意相关API

3.查询(包括审核状态)

接口:adcreative/list

注意:

系统同步有延迟,素材审核状态通过界面查询与API同步可能不同,敬请谅解。必须API同步到审核通过的素材,才可用于投放。

请求字段:

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

data内容详细:

名称类型必填描述
dsp_order_idstringY广告创意素材id,dsp需保证该id在dsp测的唯一性

接口返回:

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

ret_msg内容详细:

名称类型描述
dsp_order_idstring同新增/修改
advertiser_idint同新增/修改
advertiser_namestring同新增/修改
display_idint同新增/修改
is_only_pdint同新增/修改
targeting_urlstring同新增/修改
monitor_url数组类型同新增/修改
monitor_position数组类型同新增/修改
monitor_settle_bill数组类型同新增/修改
click_monitor_url数组类型同新增/修改
statusint审核状态(1:审核通过 2:审核未通过,3:待审核)
ott_black_channel数组类型ott素材审核未通过的牌照方id:
1. 其中443和1016为默认拒审ID,可以忽略;
2.如出现其他id,该牌照方流量将出现368告警,请修改素材后重新送审
vinfostring审核意见
ad_content数组类型同新增/修改
ad_ext对象类型高级扩展参数。详见下面请求示例

ad_content内容详细:

名称类型描述
file_textstring同新增/修改
file_urlstring同新增/修改
file_md5string同新增/修改

ad_ext内容详细:

名称类型描述
app_info对象类型 app下载唤起特性

app_info内容详细 :

名称类型描述
product_typeint 枚举说明: 1-普通链接(默认) 2-android应用下载 3-ios应用下载
app_idint下载类的app id
deep_linkstring应用直达URL

请求示例:

    {
        "data":[
            {
                "dsp_order_id":"6001"            
            }
        ]
    }

返回示例:

    {
        "ret_code":0,
        "ret_msg":[
            {
                "dsp_order_id":"6001",
                "advertiser_id":100,
                "display_id":10389,
                "is_only_pd":1,
                "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="
                ],
                "status":1,
                "vinfo":"",
                "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
                    }
                }
            }
        ]
    }