淘宝Tanx_bidding.proto
下载地址:http://code.taobao.org/p/adx_guide/src/trunk/docs/API/tanx-bidding.proto
// Tanx广告广告请求数据接口
// 字段详尽解释请参见 http://sps.corp.alimama.com/ad/ADExchange/DocLib/Tan(X)%20Exchange%20API-PF.pdfpackage Tanx;message BidRequest {//------------------------------------------- 协议基础信息// 协议版本号, 现在我们支持的版本号为3required int32 version = 1;// Tanx系统生成的唯一的竞价ID, 32字节的字符串required string bid = 2;//如果属实,那么这是一个测试要求。//DSP 需要反回正常的BidResponse//但是结果是不显示给用户,DSP不会收到一个响应optional uint32 is_test = 11 [default = 0];//如果属实,那么这个要求的目的是衡量网络延迟。//DSP需要返回一个空的BidResponseoptional uint32 is_ping = 12 [default = 0];//------------------------------------------- 浏览者信息// tanx系统对于cookie的加密结果, 长度为12个字节// 对于阿里系的DSP, 该字段为未加密的acookie, 长度为24个字节optional string tid = 3;// 访问者的IP地址, ipv4 如:192.168.1.1optional string ip = 4;// 访问者的代理浏览器类型// 原始用户UAoptional string user_agent = 5;// 用户时间偏移量 // 举个例子, 东八区 timezone_offset = 60 * 8 = 480.optional int32 timezone_offset = 13;// 用户垂直类别// 预留字段, 本期留空repeated int32 user_vertical = 14;// cookie版本号// tid 字段的版本号optional uint32 tid_version = 19;//------------------------------------------- 网页信息// 流量来源网站主不要的目标跳转url, 多值// 最大200个字节repeated string excluded_click_through_url = 6;// 来源url, 对于没有匿名设置的网站该字段被设置// 对于设置了匿名投递网站, 我们使用anonymous_idoptional string url = 7;// 网页网站分类// 参见数据字典 Tanx字典文件-网站类别.txt 定义optional uint32 category = 8;// 流量所属来源: 区别不同的adx平台// 0: Tanx原生流量 1: Google流量// 参见数据字典 Tanx字典文件-流量来源.txt 定义optional uint32 adx_type = 9 [default = 0];// 来源url, 对于设置了域名投递的网站使用这个字段。// 直接使用google的数据optional string anonymous_id = 15;// 遵循 ISO 639-1语言编码标准 双字母代码// 比如 en zh jaoptional string detected_language = 16;// 网站垂直分类的版本号// category 字段版本号optional int32 category_version = 18;//------------------------------------------- 广告位信息message AdzInfo {// id: 页面广告位编号,从0开始递增// 在返回的时候我们会根据这个字段匹配广告required uint32 id = 1; // tanx系统分配广告位的唯一标识// 为当前广告位的pid(阿里内部), 如流量提供方为非阿里系,则此pid为流量提供方在阿里系的虚拟pidrequired string pid = 2; // 广告位的尺寸: widthxheight e.g.200x300optional string size = 3;// Tanx建议DSP返回的参与竞价的广告的个数// 默认为2,DSP可以提供小于等于此数据的广告个数,Tan(X)或获取相应的数量广告竞价(竞价结果只有一个胜出)// 给外部的 ad_bid_count 为 1optional uint32 ad_bid_count = 4 [default = 2];// 展现形式// 参见数据字典 Tanx字典文件-展现形式.txt 定义// 1 页面固定广告位、2 弹窗广告位、3 页面漂浮广告位repeated uint32 view_type = 5;// 屏蔽的创意类型 // 参见数据字典 Tanx字典文件-广告创意类型.txt 定义// 1 文字 2 图片 3 Flash 4 视频 5 文字链 6 图文(iframe方式引用) 7 JS广告牌 8 HTML广告 9 Flash不遮盖(动态Flash)repeated uint32 excluded_filter = 6;// 流量最低竞标价格, DSP出价需要不小于这个值, 单位为分, 只支持人民币optional uint32 min_cpm_price = 7;// 广告位相对位置,已经废弃,请使用view_screen字段// 0:未被检测; 1: 在首屏; 2:不在首屏enum Location {NA = 0;FIRST_VIEW = 1;OTHER_VIEW = 2;}optional Location adz_location = 8 [default = NA];// 扩充的广告位相对位置// 0: 无数据; 1-5: 第1-5屏; 6: 第六屏及以外enum ViewScreen {SCREEN_NA = 0;SCREEN_FIRST = 1;SCREEN_SECOND = 2;SCREEN_THIRD = 3;SCREEN_FOURTH = 4;SCREEN_FIFTH = 5;SCREEN_OTHER = 6;}optional ViewScreen view_screen = 9 [default = SCREEN_NA];}repeated AdzInfo adzinfo = 10;// 屏蔽的敏感类目// 参见数据字典 Tanx字典文件-敏感类别.txt 定义repeated int32 excluded_sensitive_category = 17;// 屏蔽的广告行业类目// 参见数据字典 Tanx字典文件-广告类别.txt 定义repeated int32 excluded_ad_category = 20;
}message BidResponse {//------------------------------------------- 协议基础信息// 协议版本号, 现在我们支持的版本号为3required int32 version = 1;// BidRequest中传过来的bid, 32字节的字符串required string bid = 2;//------------------------------------------- 广告信息// 广告定义message Ads {// id: 页面广告位编号,需要跟BidRequest中的AdzInfo里的id相对应required uint32 adzinfo_id = 1;// 计划的最高竞标价格, 单位为分// 千次展现金额required uint32 max_cpm_price = 2;// 每个广告位需要的广告索引,默认为0开始递增,不能超过ad_bid_count数量optional uint32 ad_bid_count_idx = 3;// 广告代码片段(aloc)optional string html_snippet = 4;// 广告的目标跳转地址// 需要http://或者https://协议头repeated string click_through_url = 5;// 广告行业敏感类目和行业类目// 填充返回广告所属的敏感类目id和广告类目id// 如果返回的广告属于敏感类目,请按照数据字典中(敏感类别.txt)的敏感类别id进行填充// 如果返回的广告属于某些广告行业类目,请按照数据字典中(广告类别.txt)的类别id进行填充// Tanx会验证此字段是否与BidRequest中的excluded_sensitive_category字段和excluded_ad_category字段有交集.repeated int32 category = 6;// 广告创意类型// 参见数据字典 Tanx字典文件-广告创意类型.txt 定义// 1 文字 2 图片 3 Flash 4 视频 5 文字链 6 图文(iframe方式引用) 7 JS广告牌 8 HTML广告 9 Flash不遮盖(动态Flash)repeated int32 creative_type = 7;// network自定义id// only in [_0-9a-zA-Z]// max_length: 128optional string network_guid = 8;// DSP需要传递的额外自定义数据// Tanx会在竞价反馈的时候将该字段反馈给DSP// 不可以使用的分隔符为字符G,'\007'// max_length: 128optional string extend_data = 9;// 为广告的目标页面的url地址// 并且必须以http://或者https://开头.// destination_url必须是不经过任何加密或者跳转的最终目标地址repeated string destination_url = 10;// 广告创意ID// 该字段由DSP设置,用于标记创意的审核状态,长度不超过64字节// 若不同的创意被设置相同的ID,其中某个创意发生问题会导致所有相同ID的创意被拒绝投放// 若同一个创意被设置了不同的ID,会导致该创意被拒绝投放或整个账户被拒绝投放// 该字段不能包含回车换行以及其他不可见字符optional string creative_id = 11;}repeated Ads ads = 3;
}//只有竞价成功的时候Tanx才会向DSP发送BidResultmessage BidResult {//------------------------------------------- 协议基础信息// 协议版本号, 现在我们支持的版本号为3required int32 version = 1;// BidRequest中传过来的bid, 32字节的字符串required string bid = 2;//------------------------------------------- 竞价结果信息message Res {// id: 下标,从0开始递增(新增)required uint32 adzinfo_id = 1;// 每个广告位需要的广告索引,默认为0开始递增,不能超过adcount数量optional uint32 ad_bid_count_idx = 2;// 因为Tanx只会向竞价成功的请求发送反馈// 所以这个code只会有0optional int32 result_code = 3 [default = 0];// 竞标成功价格 ,单位为分// Tanx会向DSP要的价格,千次展现金额optional uint32 result_price = 4;// DSP在竞价过程中发送给Tanx的extend_data字段optional string extend_data = 5; }repeated Res res = 3;
}
淘宝Tanx_bidding.proto相关推荐
- 淘宝获取单笔订单信息服务端调用API及流程
淘宝获取单笔交易接口(文档地址):https://open.taobao.com/api.htm?docId=54&docType=2 调用接口所需依赖(文档地址):https://devel ...
- Linux 下安装cnpm淘宝镜像命令npm
由于NMP源都在国外,下载相关资源很慢,所以建议用国内的淘宝NPM镜像(http://npm.taobao.org/) 通过cnmp命令安装的包都会从淘宝NMP下载,速度很快. npm install ...
- 解密淘宝网的开源架构(转)
淘宝网,是一个在线商品数量突破一亿,日均成交额超过两亿元人民币,注册用户接近八千万的大型电子商务网站,是亚洲最大的购物网站.那么对于淘宝网这样大规模的一个网站,我猜想大家一定会非常关心整个网站都采用了 ...
- 淘宝李晓拴:淘宝网PHP电子商务应用
源自:http://tech.qq.com/a/20110512/000298.htm 大家好,大家知道淘宝搜索是一个典型PHP架构.在座同学不知道有多少人使用过淘宝搜索可以举手示意一下?在开始这个话 ...
- 淘宝Tengine服务器开源
http://tengine.taobao.org/index_cn.html Tengine是由 淘宝核心系统部基于Nginx开发的Web服务器,它在 Nginx的基础上,针对大访问量网站的需求,添 ...
- 淘宝网7年变化图--建议非美工UED人员也看看
从2003年开始,这么几年间淘宝网首页截图,UED美工和开发人员都可以看看.图片来自www.infoq.com网站 的PPT
- [转] JavaScript仿淘宝智能浮动
转载自: http://www.williamlong.info/archives/2864.html 我们经常在淘宝网看到这样的特效,商品列表特别长,而商品列名称始终保持在最顶端.如果你把滚动条滚动 ...
- 怎么样才能快速的把淘宝店铺推广出去
我来到淘宝近一个月了,目前顺利地得到了两颗心心.感触颇多. 其中店铺的推广显得尤其重要,应很多淘友的提问,我把一些店铺推广技巧介绍如下,你如果觉得有益,就回一下贴,以示支持.在这里先谢谢了! 先看第一 ...
- 拿到淘宝offer后的胡思乱想plus面试总结
没想到能拿到淘宝的实习offer,心里还是很激动的. 大三以后就忙着找实习,参加了SAP和淘宝的校招,呵呵,还好,第二次就拿到了offer,剩下还有腾讯和百度的招聘,决定去看看,但是还是要走淘宝.这是 ...
最新文章
- SmartDraw2008破解过程总结
- 一站式 Java Web 框架 firefly-2.0_07发布
- AT91RM9200Linux移植笔记(三)-移植Linux kernel 2.6.17
- 学习yield《转》
- 2.图像作为函数 | 初探数字图像_3
- 斯坦福博弈论笔记整理活动的任务已重新划分,望周知
- 华为手机多久可以摆脱美国技术依赖?任正非放出豪言!
- 对listView的理解
- 【零基础学Java】—继承的概述(十九)
- java并发学习--线程池(一)
- matlab ga 函数的最好适应度是什么
- 英语中常见的反义词组
- Mysql数据库死锁实战-锁的基础知识
- php strict,PHP 5.4中的E_STRICT和E_ALL有什么区别?
- Termux设置自启动
- 孤单终结者:神棍节十大“脱光”应用
- 安装VS2008的时候Windows Mobile 5.0 SDK R2 for pocket pc错误解决方案
- 一个简单的文本编辑器。(是在DEV C++下写的)
- 北京金普蝶:让客户满意就是最好的营销!
- Cloud Foundry 峰会进入中国 全球专家与你面对面