网易NEX对接API

此文档主要是针对第三方的接口信息。针对DSP厂商与网易NEX业务接口的对接信息。

目录

• 一.摘要

  • 1.0版本

  • 1.1总体流程

  • 1.2编码设置

  • 1.3请求格式

• 二.信息同步和送审接口

  • 1.同步资源位接口

  • 2.同步PDB资源位接口

  • 3.广告主送审接口

  • 4.获取广告主审核结果接口

  • 5.获取资质过期的广告主接口

  • 6.创意送审接口

  • 7.获取创意审核结果接口

  • 8.数据报表获取接口

  • 9.创意资质送审接口

• 三.实时竞价接口

  • 接口前提说明

  • 1.Bid Request 竞价请求

  • 2.Bid Response 竞价响应

  • 3.WINNOTICE 竞标成功通知

  • 4.PVM曝光监测

  • 5.价格加解密

  • 竞价规则说明

• 四.参数列表

  • A-创意素材格式要求

  • B-资质标识列表-cid

  • C-行业标识码

  • D-业标识码与资质cid的对应关系

  • E-API错误参数编码

  • F-点击坐标回传宏

  • G-第三方监测数据回传

一.摘要

1.0版本

1.1 总体流程

目前提供以下几种接口信息。

1.1.1 信息同步和送审接口

• 1.同步RTB资源位接口

• 2.同步PDB资源位接口

• 3.广告主送审接口

• 4.获取广告主审核结果接口

• 5.获取资质过期的广告主接口

• 6.创意接送审口

• 7.获取创意审核结果接口

• 8.数据报表获取接口

1.1.2 实时竞价接口

• 1.Bid Request 竞价请求

• 2.Bid Response 竞价响应

• 3.WINNOTICE 竞标成功通知

流程说明

仅RTB或PDB方式

xxxxxxxxxx

第一步 通过 1.1.1 信息同步和送审接口 1.同步资源位接口，获取资源位信息列表、可投放的资源位标识、底价等信息

第二步 按照 1.1.1 信息同步和送审接口 2~7 ，按"顺序"完成送审素材，且保证素材审核通过，获取投放所需的创意标识（网易内部创意标识）

第三步 进行实时竞价，参考 :  
1.1.2 实时竞价接口
Bid Request 竞价请求(RTB 示例) 获取本次投放的资源位标识，及设备信息、底价等信息
Bid Response 竞价响应(RTB 示例) 选择本次投放的资源位标识，并竞价响应要投放的创意、网易内部创意标识、出价等信息

Bid Request 竞价请求(PDB 示例) 获取本次投放的资源位标识，及设备信息、合同id（dealid）、允许投放的创意展现形式等信息
Bid Response 竞价响应(PDB 示例) 选择本次投放的资源位标识，并竞价响应要投放的创意、DSP创意标识、指定合同id（dealid）等信息

第四步 DSP方获取 WINNOTICE 竞标成功通知(注:PDB无WINNOTICE)

RTB+PDB方式

xxxxxxxxxx

除进行实时竞价时特殊外，其他均与以上相同    
进行实时竞价，参考 :

Bid Request 竞价请求(RTB/PDB 示例) 获取本次投放的资源位标识，及设备等、PDB合同id（dealid）、PDB允许投放的创意展现形式、RTB底价等信息)

1.选择RTB方式
Bid Response 竞价响应(RTB 示例) 选择本次投放的资源位标识，并竞价响应要投放的创意、网易内部创意标识、出价等信息
2.选择PDB方式
Bid Response 竞价响应(PDB 示例) 选择本次投放的资源位标识，并竞价响应要投放的创意、DSP创意标识、指定合同id（dealid）等信息

DSP验证

以上信息同步和送审接口都需要传递dspId和token，如果token/dspId无效或者dspId与token不匹配，NEX会返回相应状态码。

1.2编码设置

针对摘要中所提及的所有接口的编码全部都是UTF-8编码

1.3请求格式

xxxxxxxxxx

信息同步和送审接口：

所有接口均通过HTTP POST发送，且支持HTTPS，请求头中必须设置"Content-Type: application/json"，所有请求的JSON Body中都需要包含安全参数，用于进行权限验证

xxxxxxxxxx

实时竞价接口：

Bid Request 竞价请求：协议采用HTTP POST，
开启keep-alive，消息格式为JSON，目前timeout设为150ms。请求头中需要设"Content-Type: application/json"。

Bid-Response 竞价响应：DSP正常出价响应包的返回状态码为200 OK，并在Body里填写JSON格式的BidResponse，如果决定不出价,则应该返回状态码204 No Content，Body置空。

WINNOTICE 竞标成功通知：协议采用HTTP GET，且回调以后无需响应

二.信息同步和送审接口

1 同步资源位接口

1.1功能描述

xxxxxxxxxx
DSP同步获取NEX中资源位的信息，资源位包括:广告位标识id、name、position、底价等信息

x
线上环境接口地址： POST http://api.nex.163.com/api/syncPositions
沙箱环境接口地址： POST http://tapi.nex.163.com/api/syncPositions

1.2交互协议

请求参数

响应参数

data 参数说明

blacklist 参数说明

1.3示例

协议请求

xxxxxxxxxx
{
    "token": "j87ujkmnjgy33llloxikepxmnv3n9v7b",
    "dspId":"990012"
}

响应返回结果

xxxxxxxxxx
    {
    "result": 0,
    "data": [
        {
            "id": 10002,
            "name": "pdb2",
            "category": "PDBFOCUS2",
            "blacklist": {
                "subIndustry": [
                    "1703",
                    "0203"
                ],
                "msg": [
                    "vivo",
                    "iphone"
                ]
            },
            "floorPrice": 1000,
            "appName": "新闻客户端",
            "app": "7A16FBB6",
            "position": 9,
            "location": "2",
            "type": 0
        },
        {
            "id": 615,
            "name": "头条文章页",
            "category": "testtest2",
            "blacklist": {
                "subIndustry": [],
                "msg": []
            },
            "floorPrice": 480,
            "appName": "新闻客户端",
            "app": "7A16FBB6",
            "position": 6,
            "location": "testtest2",
            "type": 1
        }
    ],
    "resultMsg": ""
}

2 同步PDB资源位接口

2.1功能描述

xxxxxxxxxx
DSP同步获取NEX中PDB资源位的信息，资源位包括:广告位标识id、name、position、底价等信息

x
线上环境接口地址： POST http://api.nex.163.com/api/syncPdbPositions
沙箱环境接口地址： POST http://tapi.nex.163.com/api/syncPdbPositions

2.2交互协议

请求参数

响应参数

data 参数说明

blacklist 参数说明

2.3示例

协议请求

xxxxxxxxxx
{
    "token": "j87ujkmnjgy33llloxikepxmnv3n9v7b",
    "dspId":"990012"
}

响应返回结果

xxxxxxxxxx
    {
    "result": 0,
    "data": [
        {
            "id": 10002,
            "name": "pdb2",
            "category": "PDBFOCUS2",
            "blacklist": {
                "subIndustry": [
                    "1703",
                    "0203"
                ],
                "msg": [
                    "vivo",
                    "iphone"
                ]
            },
            "appName": "新闻客户端",
            "app": "7A16FBB6",
            "position": 9,
            "location": "2",
            "type": 0
        },
        {
            "id": 615,
            "name": "头条文章页",
            "category": "testtest2",
            "blacklist": {
                "subIndustry": [],
                "msg": []
            },
            "appName": "新闻客户端",
            "app": "7A16FBB6",
            "position": 6,
            "location": "testtest2",
            "type": 1
        }
    ],
    "resultMsg": ""
}

3 广告主送审接口

3.1功能描述

xxxxxxxxxx

NEX需要对DSP下的广告主资质进行审核，如果审核不通过，将不会允许在NEX上进行交易。
DSP通过该接口向NEX提交需要审核的广告主信息，包括广告主id、行业、资质等信息。

注:
每次批量送审广告主数量不能超过5个
每个广告主最多一次上传30个资质

上传资质说明 ：
注意：初次上传广告主资质至少需要1.组织机构代码证2.事业单位法人登记证书3.营业执照中任何一种
建议：DSP使用ID进行匹配对应的必备资质送审。
1.当资质类型为其他资质时，cid或name任选一个，若两个参数同时带有，以cid对应的资质为准
2.当资质类型为必备资质时，cid（资质标识）必填
3.当资质类型为创意资质时，name（资质名称）必填
4.创意资质只有新增操作
5.若广告主资质信息数组中存在必备资质项，则 必备资质,参考以下：
    资质规范： 参数列表 B.资质标识列表-cid
    行业规范： 参数列表 C.行业标识码
    关联关系规范： 参数列表 D.行业标识码与资质标识的对应关系
6.资质文件格式支持：jpg(JPG)\jpeg(JPEG)\png(PNG)\zip\pdf五种格式。建议：DSP使用图片格式推送资质数据
7.若删除资质，仍需填写url字段，但和已上传url不做校验比对。

xxxxxxxxxx
线上环境接口地址： POST http://api.nex.163.com/api/subAdvertiser
沙箱环境接口地址： POST http://tapi.nex.163.com/api/subAdvertiser

3.2交互协议

请求参数

customers 参数说明

credentials 参数说明

响应参数

data 参数说明

3.3示例

协议请求

xxxxxxxxxx
{
    "token": "8a2544ce57f4a9ab0157f4a9ab8d0000",
    "dspId": "5",
    "customers": [
        {
            "dcId": 9876543,
            "name": "ljtest000000",
            "industry": "13",
            "subIndustry": "1302",
            "url": "http://www.163.com",
            "credentials": [
                {

                    "name": "test",
                    "cid": 31,
                    "type": 1,
                    "expireTime": "2017-11-01",
                    "urls": [
                        "http://p3.qhimg.com/t013cb89d0becb63c3a.jpg"
                    ],
                    "optType":3
                },
                {

                    "name": "test123",
                    "cid": 30,
                    "type": 1,
                    "expireTime": "2017-11-01",
                    "urls": [
                        "http://p3.qhimg.com/t013cb89d0becb63c3a.jpg"
                    ],
                    "optType":2
                },
                {

                    "name": "test123",
                    "cid": 33,
                    "type": 0,
                    "expireTime": "2017-11-01",
                    "urls": [
                        "http://p3.qhimg.com/t013cb89d0becb63c3a.jpg"
                    ],
                    "optType":1
                }
            ]
        }
    ]
}

响应返回结果

xxxxxxxxxx
{
    "result": 0,
    "data": [
        {
            "message": "送审成功",
            "dcId": 9876543,
            "code": 0 //执行成功
        },
        {
            "message": "没有找到对应资质，不能修改或者删除",
            "dcId": 9876544,
            "code": "20034"
        },
        {
            "message": "资质id超出限制",
            "dcId": 9876544,
            "code": "20023"
        }
    ],
    "resultMsg": ""
}

4 获取广告主审核结果接口

4.1功能描述

xxxxxxxxxx
DSP可以通过接口，获取指定（一个或者多个）广告主的审核结果

注：审核结果中若有审核人员填写的资质的失效时间，资质过期则广告主失效，无法送审创意

4.2交互协议

xxxxxxxxxx
线上环境接口地址： POST http://api.nex.163.com/api/getAdvertiserVerify
沙箱环境接口地址： POST http://tapi.nex.163.com/api/getAdvertiserVerify

请求参数

响应参数

customers 参数说明

credentials 参数说明

4.3示例

协议请求

xxxxxxxxxx
{
    "token": "8a6aa82f57f57d2a0157f57d2ae70000",
    "dspId": "2",
    "dcIds":[611,610]//DSP中的广告主标识ID  数组集合
}

响应返回结果

xxxxxxxxxx
{
    "result": 0,
    "customers": [
        {
            "reason": "",//基本信息拒绝原因
            "ncId": 50,//NEX中的广告主标识ID
            "status": 0,//状态 0待审 1通过 2拒绝 3失效
            "dcId": 611,//DSP中的广告主标识ID
            "credentials": [
                {
                    "expireTime": "",//资质的失效时间
                    "reason": "",//资质拒绝原因,如果通过则为空
                    "type": 0,//资质类型
                    "name": "自定义资质",//资质名称
                    "status": 0//状态 0待审 1通过 2拒绝 3失效
                }
            ]
        },
        {
            "reason": "",                   
            "ncId": 51,                     
            "status": 0,                    
            "dcId": 610,                    
            "credentials": [
                {
                    "expireTime": "",       
                    "reason": "",
                    "type": 0,
                    "name": "自定义资质",
                    "status": 0
                }
            ]
        }
    ],
    "resultMsg": ""
}

5 获取资质过期的广告主接口

5.1功能描述

xxxxxxxxxx
根据dspId,获得资质过期的广告主ID列表

5.2交互协议

xxxxxxxxxx
线上环境接口地址： POST http://api.nex.163.com/api/getExpireAdvertiser
沙箱环境接口地址： POST http://tapi.nex.163.com/api/getExpireAdvertiser

请求参数

响应参数

5.3示例

协议请求

xxxxxxxxxx
{
    "token": "j87ujkmnjgy33llloxikepxmnv3n9v7b",
    "dspId": "990012"
}

响应返回结果

xxxxxxxxxx
{
    "result": 0,
    "resultMsg":"",
    "dcIds": [//DSP中的广告主标识ID  数组集合
        25,
        13,
        46
    ]
}

6 创意送审接口

6.1功能描述

xxxxxxxxxx
DSP需要将待投放的素材送交NEX进行审核，审核不通过的素材将无法在NEX进行广告交易。送审接口会根据网易的要求，对素材的标题、尺寸、大小、类型进行初步机器校验，并返回素材的失败原因

注：
每次批量送审创意数量不能超过10个
送审创意中的广告主ID（dcId）一定要审核通过后的广告主,才能送审素材
若相同创意多次送审，则需要重新审核
创意格式规范： 参数列表  A.创意素材格式要求

6.2交互协议

线上环境接口地址： POST http://api.nex.163.com/api/subIdea 沙箱环境接口地址： POST http://tapi.nex.163.com/api/subIdea

请求参数

ideas 参数列表

materials 参数列表

以上创意格式均有要求参考： 参数列表 A.创意素材格式要求

响应参数

data 参数说明

customize参数列表

6.3示例

协议请求

xxxxxxxxxx
{
    "token": "8a6aa82f57f57d2a0157f57d2ae70000",
    "dspId": "2",
    "ideas": [
        {
            "dIdeaId": 6,//DSP中的创意标识ID
            "style": 3,//创意的展现形式标识
            "dcId": 611,//DSP中的广告主标识ID
            "title": "我是空格空格空格空格空格创意style 3",//标题 (创意名称)
            "clickUrl":"http://www.csdn.net",//点击的网址
            "andriodUrl":"http://www.sohu.com",//style 为其他情况会直接滤空 ,不做校验
            "iosUrl":"https://www.sina.com",//style 为其他情况会直接滤空 ,不做校验
            "materials":[//素材的url地址列表
                {
                    "type":0,
                    "url":"http://statics.juxia.com/uploadfile/shouyou/2016/9/2016091915053879.jpg"
                }
            ]
        }
    ]
}

xxxxxxxxxx
{
    "token": "8a6aa82f57f57d2a0157f57d2ae70000",
    "dspId": "2",
    "ideas": [
        {
            "dIdeaId": 6,//DSP中的创意标识ID
            "style": 15,//创意的展现形式标识
            "dcId": 6,//DSP中的广告主标识ID
            "title": "我是创意style 15",//标题 (创意名称)
            "clickUrl":"http://www.163.com",//点击的网址
            "androidUrl":"http://res9.d.cn/m/yxzx.apk",//安卓下载地址
            "iosUrl":"https://itunes.apple.com/cn/app/tian-xia/id1086981081?l=zh&mt=8&ls=1",//ios下载地址
            "materials":[//素材的url地址列表
                {
                    "type":0,
                    "url":"http://img5.cache.netease.com/3g/2015/7/7/20150707164045209fe.jpg"
                }
            ]
        }
    ]
}

响应返回结果

xxxxxxxxxx
{
  "result": 0,
  "data": [
    {
      "dIdeaId": 6,//DSP中的创意标识ID
      "code": 0,//执行成功码
      "message": "送审成功"
    }
  ],
  "resultMsg": ""
}

7 获取创意审核结果接口

7.1功能描述

xxxxxxxxxx
通过接口获得创意的审核结果

7.2交互协议

x
线上环境接口地址： POST http://api.nex.163.com/api/getIdeaVerify

沙箱环境接口地址： POST http://tapi.nex.163.com/api/getIdeaVerify

请求参数

响应参数

ideas 参数列表

7.3示例

协议请求

xxxxxxxxxx
{
    "token": "8a6aa82f57f57d2a0157f57d2ae70000",
    "dspId": "2",
    "dcId": 6,
    "dIdeaIds":[6]//DSP中的创意标识ID 数组集合
}

响应返回结果

xxxxxxxxxx
{
  "result": 0,
  "ideas": [
    {
      "status": 0,//状态 0待审 1通过 2拒绝 3失效
      "dIdeaId": 6,//DSP中的创意标识ID
      "nIdeaId": 66,//NEX中的创意标识ID
      "reason": ""//拒绝原因,如果通过则为空
    }
  ],
  "resultMsg": ""
}

8 数据报表获取接口

8.1功能描述

xxxxxxxxxx

DSP可以通过该接口向NEX请求下载报表，数据报表内容包括查询日期段内，DSP当天每个广告位上参与请求数、出价数、胜出数、展示数、点击数、消耗
注:
1.每日7点前，将DSP的前一天按照资源位（资源位id）的效果数据同步至接口，支持DSP查看过去45天（含前一天）以天为单位的资源位粒度的投放效果数据。
2.昨天的数据仅供参考，可能产生修正，请以之后一天查到的数据为准。
3.返回数据会加密

8.2交互协议

x
线上环境接口地址： POST http://api.nex.163.com/api/getDailyData

沙箱环境接口地址： POST http://tapi.nex.163.com/api/getDailyData

请求参数

响应参数

invdata 参数列表

8.3示例

协议请求

xxxxxxxxxx
{
    "token": "8a6aa82f57f57d2a0157f57d2ae70000",
    "dspId": "2",
    "startTime": "2017-06-01",
    "endTime": "2017-06-02"
}

响应返回结果

xxxxxxxxxx
{
  "result": 0,
  "total" : 2
  "invdata": [
    {
      "date": "2016-06-01",//数据产生日期
      "adid": 6,//资源位标识
      "cost": 66000,//消耗
      "requestCount": 111,//请求数
      "bidCount": 111,//出价数
      "winCount": 111,//胜出数
      "showCount": 111,//展示数
      "clickCount": 111//点击数
    },
    {
      "date": "2016-06-02",//数据产生日期
      "adid": 6,//资源位标识
      "cost": 66000,//消耗
      "requestCount": 111,//请求数
      "bidCount": 111,//出价数
      "winCount": 111,//胜出数
      "showCount": 111,//展示数
      "clickCount": 111//点击数
    }
  ],
  "resultMsg": ""
}

9. 创意资质送审接口

9.1功能描述

xxxxxxxxxx
对于需要创意资质的广告主，NEX需要对DSP下的创意资质进行审核，如果审核不通过，关联创意将不允许在NEX上进行交易。
DSP通过该接口向NEX提交需要审核的广告主相关的创意资质，包括广告主id和资质相关数据

注:
每次送审，一次最多上传30个创意资质

上传资质说明 ：
注意：初次上传广告主资质至少需要1.组织机构代码证2.事业单位法人登记证书3.营业执照中任何一种
建议：DSP使用ID进行匹配对应的必备资质送审。
1.当资质类型为创意资质时，name（资质名称）必填
2.创意资质只有新增操作
3.资质文件格式支持：jpg(JPG)\jpeg(JPEG)\png(PNG)\zip\pdf五种格式。建议：DSP使用图片格式推送资质数据

9.2交互协议

接口地址

x
线上环境接口地址： POST http://api.nex.163.com/api/subAdvIdeaCred

沙箱环境接口地址： POST http://tapi.nex.163.com/api/subAdvIdeaCred

请求参数

credentials 参数说明

响应参数

data 参数说明

9.3示例

协议请求

xxxxxxxxxx
{
    "token": "8afacc5e697f418f01697f418fd15fd7",
    "dspId": "16912",
    "dcId": 26,
    "credentials": [{
        "name": "某明星代言xxx-创意资质",
        "cid": "",
        "type": 2,
        "expireTime": "2023-10-23",
        "urls": [
            "https://v2sandbox.addnewer.com/media/2020/05/1589008548408.png"
        ]
    }]
}

响应返回结果

xxxxxxxxxx
{
    "result": 0,
    "data": [
        {
            "dcId": 26,
            "code": 0,
            "message": "送审成功"
        }
    ],
    "resultMsg": ""
}

三 实时竞价接口实时竞价接口

接口前提说明

参考协议 OpenRTB version 2.3.1 final协议实现, 取子集

目前NEX仅支持DSP对每一个曝光位置，仅能发送一个创意进行竞价

总体流程为：

1.Bid Request (Device,Imp) 竞价请求

2.Bid Response (SeatBid,Bid,Ext,Adm) 竞价响应

3.Win Notice (宏替换)

1 Bid-Request竞价请求

协议发送要求

协议采用HTTP POST，开启keep-alive，消息格式为JSON，目前timeout为150ms，请求头中需要设为 "Content-Type: application/json"

Bid Request Object

User Object

GEO Object

Device Object

Device.opt_device_info

Imp Object

Pmp Object

Deals Object

App Object

Bid Request示例

RTB 示例

xxxxxxxxxx

{
    "id": "F36BABA54B414D45A9D313AA1450073C",//竞价请求id
    "test": 1,//是否测试
    "wseat": [],//商家黑名单 扩展待定
    "bcat": [],//阻止的类别    扩展待定
    "imp": [//曝光对象，一次request可以包含多个imp
        {
            "tagid": "902",//广告位ID
            "bidfloorcur": "CNY",//广告位底价的货币币种    
            "allowstyle": [3,10,16,15,11,18],//rtb 曝光位接受创意展现形式的ID数组对象      
            "id": "902",//曝光ID
            "bidfloor": 1900,//底价,单位是分/千次曝光
            "interact_mode_supported":[0,1]
            
        }
    ],
    "cur": [//允许参与出价的货币币种
        "CNY"
    ],
    "user":{
        "id": "dbf63607295c40dda348ccf1871deacd"
    },
    "device": {//设备对象
        "carrier": "",//运营商
        "model": "Google Galaxy Nexus - 4.1.1 - API 16 - 720x1280",//型号
        "ua": "",//user agent(Browser user agent string)
        "ip": "127.0.0.1",//设备ip
        "imei": "000000000000000",//IMEI, 明文传输，默认为空字符串
        "mac": "08:00:27:10:89:ce",//MAC地址，明文传输，默认为空字符串
        "idfa": "",//IOS设备的唯一标识
        "android_id":"f1b7854bc9287200",
        "os": "android",//操作系统
        "connectiontype": "wifi",//链接类型，wifi/2G/3G/4G
        "geo": {//地域对象
            "lat" : "40.04326362458659", //纬度
            "lon" : "116.2759582746043", //经度
            "type" : 1,//定位坐标系 默认为0；（0为地球坐标系，1为火星坐标系，2为百度坐标系）
        },
        "screen_width":1080,
        "screen_height":1920,
        "hms_core_version": "60001306",
        "huawei_ag_version": "110302302",
        "manufacturer":"HUAWEI",
        "boot_mark": "1623815045.970028",
        "update_mark": "1581141691.570419583",
        "caid": "81828058c941552782a5cb29883bca27",
        "caid_version": "20230330",
        "pre_caid": "950a3f2b02020adad2656236b24d6510",
        "pre_caid_version": "20220111"
    },
    "app": {
      "ver": "80.1",
      "bundle": "com.netease.news",
      "name": "网易新闻",
      "id": "7A16FBB6"
    },
    "tmax": 250, //最长时间等待，最长时间以毫秒为单位提交,以避超时
    "coordinate_supported": true
}

PDB 示例

xxxxxxxxxx
{
    "id": "F36BABA54B414D45A9D313AA1450073C",//竞价请求id
    "test": 1,//是否测试
    "wseat": [],//商家黑名单 扩展待定
    "bcat": [],//阻止的类别    扩展待定
    "imp": [//曝光对象，一次request可以包含多个imp
        {
            "tagid": "902",//广告位ID
            "id": "902",
            "pmp": {
                "private_auction" : 1,//Deal规则是否生效
                "deals" : [//协议对象 (竞价规则对象)   
                    {
                        "id" : "1234",//deal id (可用定义合同号)
                        "at" : 0,//拍卖类型0:PDB
                        "allowstyle": [3]//deal 曝光位接受创意展现形式的ID数组对象
                    }
                ]
            },
            "interact_mode_supported":[0,1]
        }
    ],
    "cur": [//允许参与出价的货币币种
        "CNY"
    ],
    "device": {//设备对象
        "carrier": "",//运营商
        "model": "Google Galaxy Nexus - 4.1.1 - API 16 - 720x1280",//型号
        "ua": "",//user agent(Browser user agent string)
        "ip": "127.0.0.1",//设备ip
        "imei": "000000000000000",//IMEI, 明文传输，默认为空字符串
        "android_id":"f1b7854bc9287200",
        "mac": "08:00:27:10:89:ce",//MAC地址，明文传输，默认为空字符串
        "idfa": "",//IOS设备的唯一标识
        "os": "android",//操作系统
        "connectiontype": "wifi",//链接类型，wifi/2G/3G/4G
        "geo": {//地域对象
            "lat" : "40.04326362458659", //纬度
            "lon" : "116.2759582746043", //经度
            "type" : 1,//定位坐标系 默认为0；（0为地球坐标系，1为火星坐标系，2为百度坐标系）
        },
        "screen_width":1080,
        "screen_height":1920,
        "hms_core_version": "60001306",
        "huawei_ag_version": "110302302",
        "manufacturer":"HUAWEI",
        "boot_mark": "1623815045.970028",
        "update_mark": "1581141691.570419583"
    },
    "app": {
      "ver": "55.1",
      "bundle": "com.netease.news",
      "name": "网易新闻",
      "id": "7A16FBB6"
    },
    "tmax": 200, //最长时间等待，最长时间以毫秒为单位提交,以避免超时
    "coordinate_supported": true
}

RTB/PDB 示例

xxxxxxxxxx
{
    "id": "F36BABA54B414D45A9D313AA1450073C",//竞价请求id
    "test": 1,//是否测试
    "wseat": [],//商家黑名单 扩展待定
    "bcat": [],//阻止的类别    扩展待定
    "imp": [//曝光对象，一次request可以包含多个imp
        {
            "tagid": "902",//广告位ID
            "bidfloorcur": "CNY",//广告位底价的货币币种    
            "allowstyle": [3,10,16,15,11,18],//rtb 曝光位接受创意展现形式的ID数组对象      
            "id": "902",//曝光ID
            "bidfloor": 1900,//底价,单位是分/千次曝光
            "pmp": {
                "private_auction" : 1,//Deal规则是否生效
                "deals" : [//协议对象 (竞价规则对象)   
                    {
                        "id" : "1234",//deal id (可用定义合同号)
                        "at" : 0,//拍卖类型0:PDB
                        "allowstyle": [3]//deal 曝光位接受创意展现形式的ID数组对象
                    }
                ]
            },
            "interact_mode_supported":[0,1]
        }
    ],
    "cur": [//允许参与出价的货币币种
        "CNY"
    ],
    "device": {//设备对象
        "carrier": "",//运营商
        "model": "Google Galaxy Nexus - 4.1.1 - API 16 - 720x1280",//型号
        "ua": "",//user agent(Browser user agent string)
        "ip": "127.0.0.1",//设备ip
        "imei": "000000000000000",//IMEI, 明文传输，默认为空字符串
        "android_id":"f1b7854bc9287200",
        "mac": "08:00:27:10:89:ce",//MAC地址，明文传输，默认为空字符串
        "idfa": "",//IOS设备的唯一标识
        "os": "android",//操作系统
        "connectiontype": "wifi",//链接类型，wifi/2G/3G/4G
        "geo": {//地域对象
            "lat" : "40.04326362458659", //纬度
            "lon" : "116.2759582746043", //经度
            "type" : 1,//定位坐标系 默认为0；（0为地球坐标系，1为火星坐标系，2为百度坐标系）
        },
        "screen_width":1080,
        "screen_height":1920,
        "hms_core_version": "60001306",
        "huawei_ag_version": "110302302",
        "manufacturer":"HUAWEI",
        "boot_mark": "1623815045.970028",
        "update_mark": "1581141691.570419583"
    },
    "app": {
      "ver": "55.1",
      "bundle": "com.netease.news",
      "name": "网易新闻",
      "id": "7A16FBB6"
    },
    "tmax": 250, //最长时间等待，最长时间以毫秒为单位提交,以避免超时
    "coordinate_supported": true
}

2 Bid-Response竞价响应

协议发送要求

DSP正常出价响应包的返回状态码为200 OK，并在Body里填写JSON格式的BidResponse。

如果决定不出价,则应该返回状态码204 No Content，Body置空。

如果返回其他状态吗，如403 Forbidden或500 Internal Server Error，则NEX会当做错误处理.

Bid-Response Object

SeatBid Object

Bid Object

Ext Object

adm Object

advertiser Object

macros Object

eventTracker Object

customize参数列表

Bid Response示例

RTB 示例

xxxxxxxxxx

{
    "id": "F36BABA54B414D45A9D313AA1450073C",//竞价请求的id  既 bid request id
    "bidid": "100002_200004_1000014",//dsp自己的竞价id,   投标人响应生成ID协助日志/跟踪
    "cur": "CNY",//币种,ISO-4217 国际标准货币代码 注：现仅支持'CNY'
    "seatbid": [//竞价集合对象
        {
            "bid": [//针对单次曝光的出价
                {
                    "id": "100002_200004_1000014_0",//DSP对该次出价分配的ID
                    "impid": "902", //BidRequest中的impid
                    "nurl": "http://test.xxx.com?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&impid=${AUCTION_IMP_ID}&price=${AUCTION_PRICE}&cur=${AUCTION_CURRENCY}",//win notice url，竞价成功提醒url
                    "price": 600,//DSP出价，单位是分/千次曝光，即CPM
                    "crid": "1000014",//系统的创意ID ，以协助广告质量检查
                    "pvm": [//曝光监测URL
                        "http://g1.163.com/madfeedback1",
                        "http://g1.163.com/madfeedback2",
                        "http://g1.163.com/madfeedback3",
                        "http://g1.163.com/madfeedback4",
                        "http://g1.163.com/madfeedback5"
                    ],
                    "clickm": [//点击监测URL
                        "http://g1.163.com/madfeedback6",
                        "http://g1.163.com/madfeedback7",
                        "http://g1.163.com/madfeedback8",
                        "http://g1.163.com/madfeedback9",
                        "http://g1.163.com/madfeedback10"
                    ],
                    "ext": {
                              "macros": [//宏
                            {
                                "macro": "${bid_a}", //宏 eg:  ${XXXXXXX}
                                "value": "a",//宏替换值
                                "expression": [//宏替换有效范围
                                    1,
                                    2
                                ]
                            },
                            {
                                "macro": "${bid_b}", //宏 eg:  ${XXXXXXX}
                                "value": "b",//宏替换值
                                "expression": [//宏替换有效范围
                                    1,
                                    3
                                ]
                            }
                        ],
                     "style": 3,//创意的展现形式id  参数列表 A.创意素材格式要求
                                 "title": "我是空格空格空格空格空格创意style 3",//标题 (创意名称)
                     "isFullScreen": 0,//非全屏
                                 "linkUrl": "http://www.csdn.net",//点击落地页网址
                     "adm": [//广告素材信息集合
                            {
                                "url": "http://wwww.source.com/aei2.jpg",//广告素材URL
                                "type": 0,//素材类型 0：图片  1：视频  2：gif
                                "w":1080,
                                "h":1920
                            }
                        ],
                                "advertiser": {
                                       "id" : "1",//广告主id
                                       "industry" : "01",//广告主所属的一级行业    参数列表 B.行业标识码
                                       "subIndustry" : "0101"//广告主所属的二级行业    参数列表 B.行业标识码
                                      }
                    },
                    "eventTracker":[
                      {
                        "type":5,
                        "url":"https://www.tracker.com/callapp/ok?id=32e89e301d7326h8c"
                      },
                    ],
                    "interact_mode":1,
                    "need_coordinate":0
                }
            ]
        }
    ]
}