使用条款

Mix-Mind系统公司（以下简称“Mix-Mind”）所有文档，接收者有保密义务。未经Mix-Mind书面许可，任何人或任何机构不得向第三方披露、泄露有关本文件的任何内容或细节。Mix-Mind拥有修改、调整、增补本文件的权利。Mix-Mind系统™和Mix-Mind Systems™及相关延展标识为Mix-Mind公司在中国和/或其他国家或地区的注册商标或商标。

目录

Mix-Mind移动端资源接入交互协议说明

版本历史

概述

本文档是Mix-Mind平台移动端资源接入交互协议说明文档，媒体直接向Mix-Mind投放服务器发送广告投放请求(信息流资源包含nativead对象，普通移动端广告不包含nativead对象)，Mix-Mind投放服务器根据投放请求中的参数以及系统中事先录入好的投放规则进行筛选，实时返回被投放的广告信息。

媒体接收Mix-Mind服务器返回的广告信息，并负责完成广告的展现及监测环节。媒体需要根据返回的广告信息中的src资源、跳转地址、曝光监测代码及点击监测代码等自行控制广告的展示。同时，媒体需要自行发出广告监测请求，以便第三方监测和统计。

HTTP投放协议

协议采用HTTP POST，开启keep-alive，消息格式为JSON。请求头中需要设置Content-Type为application/json。

非PMP请求的URL: http://v.ad.xelements.cn/cx
PMP请求URL：http://v.ad.xelements.cn/cx/46

Reqeust

** Note **

本协议支持接入两种媒体资源类型：1.信息流 2.普通资源类型 请求包含nativead object为信息流广告的请求，不包含nativead object为普通资源类型广告的请求。

信息流元素定义

nativead object

** Note **

required_fields:定义信息流广告展示必填字段。不在required_fields中定义，请求有对应元素要求描述的字段是选填字段。
比如：requried_fields:[“1”,“4”], 请求中元素要求中有source_max_safe_length=10，表示信息流广告展示 title和img是必填元素，source是选填元素。
备注：信息流资源如果使用Exchange平台录入的广告位元素设置，请求nativead对象设置为：“nativead”: {“required_fields”: []}

device object

备注：设备ID按照以下顺序至少传一个，否则会影响广告填充

1.Android：oaid、oaid_md5、imei、imei_md5、androidid、androidid1、mac、mac1
2.iOs：idfa、openudid、mac、mac1
3.windowsphone：duid、mac、mac1

app object

site object

pmp object 详细字段及含义

pmp.deals object 详细字段及含义

Response

Mix-Mind投放服务器在收到广告请求后，会根据投放请求中参数实时返回一个JSON格式数据，HTTP Response的状态码为200。 Mix-Mind没有合适广告投放时，HTTP Response的状态码为204.

非信息流广告创意 object

信息流广告创意 object

img object

icon object

logo object

video object

信息流广告Request示例

    {
    "version":"1.0",
    "pid":"123",
    "action_type":1,
    "nativead":{
            "required_fields":[]
    },
    "device":{
            "devicetype":0,
            "os":0,
            "imei_md5":"F1C7976BC455CB548BFC550EB7687F06",
            "m_ip":"14.18.52.69",
            "m_ua":"Mozilla/5.0(Linux;Android4.0.4;GT-I9220 Build/IMM76D)",
            "m_ts":"1374225975"
    },
    "app":{
            "m_app":"wantu",
            "m_app_pn":"com.weitu.wantu"
    },
    "reqid":"123"
}

信息流广告Response示例

    {
        "pid":"123",
        "action":2,
        "type":"R",
         "src":"%7B%22title%22%3A%22Lowest%20mortgage%20rates%22%2C%22desc%22%3A%22Your%20home%20sweet%20Brooklyn%20home%20-%20cheaper%20and%20sooner%20than%20you%20think!%22%2C%22source%22%3A%22NY%20Mortgage%20Inc.%22%2C%22image%22%3A%5B%7B%22url%22%3A%22http%3A%2F%2Fwww.example.net%2Fmypromoimage.png%22%2C%22width%22%3A%22320%22%2C%22height%22%3A%22150%22%7D%2C%7B%22url%22%3A%22http%3A%2F%2Fwww.example1.net%2Fmypromoimage.png%22%2C%22width%22%3A%22320%22%2C%22height%22%3A%22150%22%7D%5D%7D",//{"title":"Lowest mortgage rates","desc":"Your home sweet Brooklyn home - cheaper and sooner than you think!","source":"NY Mortgage Inc.","image":[{"url":"http://www.example.net/mypromoimage.png","width":"320","height":"150"},{"url":"http://www.example1.net/mypromoimage.png","width":"320","height":"150"}]}
        "pm":{"0":["http://url1","http://url2"],"4":["http://url1","http://url2"]},
        "cm":["http://url1","http://url2"],
        "ldp":"http://www.openurl.com",
        "reqid":"123"
}

非信息流广告Request示例

{
    "version":"1.0",
    "pid":"1",
    "action_type":1,
    "device":{
            "devicetype":0,
            "os":0,
            "imei_md5":"F1C7976BC455CB548BFC550EB7687F06",
            "m_ip":"14.18.52.69",
            "m_ua":"Mozilla/5.0(Linux;Android4.0.4;GT-I9220 Build/IMM76D)",
            "m_ts":"1374225975",
            "m_dvw":300,
            "m_dvh":250
    },
    "app":{
            "m_app":"wantu",
            "m_app_pn":"com.weitu.wantu"
    },
    "reqid":"123"
}

非信息流广告Response示例

{
        "pid":"123",
        "action":2,
        "type":"I",
        "src":"%7B%22url%22%3A%22http%3A%2F%2Fres.dxpmedia.com%2F201604%2F1461309356424.jpg%22%2C%22width%22%3A%22300%22%2C%22height%22%3A%22250%22%7D",//{"url":"http://res.dxpmedia.com/201604/1461309356424.jpg","width":"300","height":"250"}
        "pm":{"0":["http://url1","http://url2"],"4":["http://url1","http://url2"]},
        "cm":["http://url1","http://url2"],
        "ldp":"http://www.openurl.com",
        "reqid":"123"
}

宏替换

媒体沙箱联调步骤

1. 媒体获取《Mix-Mind移动端资源接入交互协议说明》文档以及《媒体商务信息+技术》问卷调查。
2. 媒体对问卷调查给予回复，同时根据《Mix-Mind移动端资源接入交互协议说明》文档进行开发。
3. Mix-Mind根据媒体回复的问卷调查，明确需要测试的资源类型，广告位尺寸，媒体投放时可以提供的参数信息。
4. 媒体方根据资源类型和广告位尺寸，在下方联调固定位置中找对应尺寸的广告位进行自测。如果媒体广告位尺寸比较特殊，联系Mix-Mind创建对应尺寸的广告位，再进行测试。只要是联调测试的位置，Mix-Mind都会配置好广告返回。
5. 媒体方根据选择的广告位和Mix-Mind协议定义，自测确认是否已经正确返回广告。
6. 媒体联系Mix-Mind，双方技术进行联调，由媒体发送请求并确认广告展示效果。Mix-Mind方会确认请求参数、曝光、点击监测是否正常，和媒体对数。
7. 若以上都没有问题，联调结束。

问卷调查中需要关注的部分

用curl自测：开屏资源，只需要修改广告位id，信息流资源，需要修改元素信息。

curl -i -H 'Content-Type:application/json'  'http://v.ad.xelements.cn/cx'    -d'{"version":"1.0","pid":"192300","action_type":1,"device":{"devicetype":0,"os":0,"imei_md5":"F1C7976BC455CB548BFC550EB7687F06","m_ip":"14.18.52.69","m_ua":"Mozilla/5.0(Linux;Android4.0.4;GT-I9220 Build/IMM76D)","m_ts":"1374225975"},"app":{"m_app":"wantu","m_app_pn":"com.weitu.wantu"},"reqid":"123"}'

媒体沙箱联调常用固定广告位

备注：如果媒体按照订单方式请求可以使用上述dealId进行联调

线上测试步骤

1. Mix-Mind媒介商务提供给媒体正式合作使用的广告位，媒体在后台系统中配置好该广告位。
2. 沟通好线上数据测试的cpm量级。
3. Mix-Mind方配置好线上测试的广告返回，媒体收到量级通知放量之后再放量。
4. 放量测试结束，提供双方数据，对比数据差异。