[Part 2]媒体API接入是在接入什么

之前在上一篇文章当中介绍到了互联网广告当中几个关键参与方与平台,可以回顾一下。(在整个程序化交易的生态当中不仅仅只有以下四方,为了能够让读者看起来比较清晰,在后面的章节会逐步完善各个环节的参与方)

[Part 2]媒体API接入是在接入什么

Publisher 把广告展示机会发送给Ad Exchange & SSP , Ad Exchange & SSP 经过处理后,会分发给各个 DSP & TD 等Ad Server,由Ad Server进行广告内容的填充。
Publisher 与 Ad Exchange & SSP 的数据交互方式有两种: API 或者 SDK的方式,本文将会详细的介绍API的对接方式。
Publisher 即媒体,在当有用户打开应用进入到有广告位的页面的时候(比较比如打开应用时的开屏广告),媒体想要有广告展示给用户。这个时候媒体就会将数据发送给SSP, 在SSP收到来自APP的信息后,根据自身服务的处理,最终会告知APP使用何种广告进行填充,如下图:
[Part 2]媒体API接入是在接入什么

既然有双方在进行通信,则一定需要一门共通的格式来约定双方通信当中所需要包含的信息。在这里介绍一下在RTB当中经常会用到的两种数据交换格式Protocol buffer与JSON。

protocol buffer 是Google提供的一种语言中立,平台中立,可扩展的用作序列化的数据体。开发者可以自己定义自己需要的结构化数据,并直接在自己熟悉的源代码当中使用,如C#, C++, Python , Go, Java。一般用于通信协议,数据存储。来一段简单的例子:

message Person {
  required string name = 1;
  required int32 id = 2;
  optional string email = 3;
}

(以上例子来自于 developers.google.com)
一段简单的代码即可定义一个所需要的结构。目前Proto最新的大版本是proto3。有兴趣的朋友可以到https://developers.google.com/protocol-buffers/ 获取更多关于Protocol buffer的信息。

Json,也属于一个轻量级的数据交换格式,术语ECMAScript的一个子集。在Json的世界当中,以Key/Values的形式来进行数据的保存。
具体信息也可以到 http://www.json.org/ 获取。
[Part 2]媒体API接入是在接入什么

Protocol buffer 与Json都可以用做数据交换格式的定义,没有最好最坏之分,下面列举一下他们双方的区别:
Protocol Buffer优点: 二进制格式,体积小,传输快,向后兼容性好。缺点:通用性差,自解释性差。
Json 优点:格式简单,可读性高。 缺点:文件大小比Protocol buffer大。

毕竟技术没有真的对错,以上只是粗略描述了2个数据格式。

不管在选择使用哪种数据格式,都会涉及到具体数据传输对象的约定。通用的结构体一般会采取遵从iab (Interactive Advertising Bureau) 的OpenRTB 项目的协议。目前该协议的OpenRTB 3.0正在收集各方的意见。市场上用的比较多的还是2.X版本。
如之前描述到的,当APP上的一个展示机会出现时,APP需要将该Request进行发送。按照OpenRTB 2.4 的协议,大致需要发送如下的对象。
[Part 2]媒体API接入是在接入什么

(图片来自于OpenRTB-API-Specification-Version-2-4-FINAL)
简单列举部分需要发送的数据对象如下:

• id
发送一个请求的唯一标识符。
• Imp
发送当前展示机会中的展示对象。
• Site
发送当前开发者的网站信息对象。
• App
发送当前APP的具体信息。
• Device
发送产生该展示机会的设备对象。
• User
发送当前展示机会的该设备的Human对象。
• Test
发送当前请求是否为测试请求,通用以0表示正式请求,1表示测试请求。
• At
Auction Type, 用于表示该请求采用的First Price 或者Second Price + 作为竞价成功标准。
• Tmax
当前请求要求的最大响应时长。
• cur
结算货币类型。

不难看出,媒体需要向外发出的信息如果简单的来讲,就是 谁在什么开发者的什么媒体的什么广告位上产生了一次曝光展示机会。 作为媒体的同学来讲,如果把这些信息的都向外发送的话,是否会让别人知道太多的信息? 我们下面来对谁在什么媒体的什么广告位上产生了一次曝光展示机会。 进行拨洋葱式的解析。

首先,在什么设备上。一讲到设备,以前的一些媒体朋友总会担心一旦传输设备信息就是将自己的用户信息给传输掉了。实际上不会,根据iab的规则,这里的用户指的是 Device对象。一般会需要以下的信息:
• ua
• geo (经纬度,视不同的APP功能可能有的APP不会发送)
• ip
• make (设备的品牌,如 Apple )
• model (设备的类型, 如ipad)
• OS (设备操作系统)
• OSV (操作系统版本)
• hwv (设备硬件版本)
• h (设备屏幕高度)
• w(设备屏幕宽度)
• device (设备ID, 一般采用的是可以SHA1或者MD5的方式来加密传输 IMEI, Android id 或 IDFA)

其次,描述在什么开发者的什么媒体上,这里一般描述的信息就是开发者的id,名称,分类,以及APP自身的名称, Bundle(如App Id或 com.com.adxing), 分类.

再细化到,什么广告位上。 这里iab提供的是一个Imp(Impression)对象,其中可以包括现在市面上的主流广告形式,如Banner, Video, Audio, Native。 以Banner 为力,如果这次广告展示机会是一个Banner的广告展示机会,则在Banner对象当中会描述出这个Banner广告位的宽度,高度,可接受最大宽度,可接受最大高度,可接受最小宽度,可接受最小高度,禁止投放的广告类型(如JavaScript),可接受的广告物料类型(如jpg, gif)。

综上,一次展示机会被媒体发出的仅仅只会是和广告相关的信息,而并没有带上任何和该APP业务相关的信息。

作为Request接收方的SSP, Ad exchange 或DSP ,在接受到一次广告展示机会后同样也要通过自身的业务处理后,选择一个最合适的广告物料告知到APP侧。这一部分就是我们通常说到的Response ,还是按照iab的标准来看,需要提供以下的信息。
[Part 2]媒体API接入是在接入什么

(图片来自于OpenRTB-API-Specification-Version-2-4-FINAL)

主要有这么几个内容构成:

• id
Response 的ID
• Seatbid
席位回应的内容
• bidid
Response 的ID
• Cur
回应出价的货币单位
• nbr
未回应的原因

广告展示的物料的具体信息体现在Seatbid对象当中,可能会根据不同的SSP或者Ad exchange 约定不同的具体内容。但归纳以下一般会告知媒体以下的信息:
• price
该物料的出价。
• site_url
该物料的落地页地址。
• creative_elements
该物料的具体内容,如图片的URL, 视频的URL等。
• click_tracking_urls
当物料被点击时,需要上报的地址。多为第三方监测地址。
• imp_tracking_urls
当物料被有效展示时,需要上报的地址。

在APP获取到这些信息后,按照与SSP或Ad Exchange约定的形式进行展示即可完成广告的一次展示。

从新回顾一下最早我们讲到这张图,整个广告传输的内容无非就是按照约定的数据传输格式,按照约定的内容,由APP告知谁在什么开发者的什么媒体的什么广告位上产生了一次曝光展示机会, 由Ad Serving处理后,告知APP针对这一次展示机会,需要展示什么样的广告内容,以及当广告物料被点击和被展示时,需要做出何种上报行为。

[Part 2]媒体API接入是在接入什么

本期我们就说到这里,下一期我们来聊一聊在整套交互体系上,如何用阿里云的一些功能来规划一个广告交互流程。

上一篇:[爱偷懒的程序员系列]-Section 3. 链接钉钉审批流


下一篇:(7)ESP32 Python 使用看门狗 脱坑HC-SR04