DSPDMP合作接口方案

1、DSP、PCP合作方案 v2.4筷子科技谢统玲PCP简介广州筷子信息科技提供程序化创意平台Programmatic Creative Platform ,简称PCP ，致力于通过大数据，利用各种疋向条件如人群疋向，时间疋向，天气疋向，地区定向等，为用户动态推送最适合的广告创意组合，实现广告内容更精准投放，进一步提高广告投放ROI。目前广告交易市场生态圈主要由SSR Ad Exchange、DSP DMP等组成，市场一般是这样交易的：当一个用户访问广告位页面时，SSP端向Ad Exchange发出访问讯号，告知有一个访问请求，Ad Exchange把广告位的具体信息，例如所属站点、最低出价以及用

2、户人群信 息打包发送给各个 DSP DSP端开始对这个广告展现进行竞价，竞价获胜者就能够让自己的 广告展现在这个广告位上，进而让用户看到当然有些DSP有自己的私有 DMP会再次利用自己的DMF进行用户匹配，挑选适宜的广告及价格进行竞价。参加了 PCP提供动态创意内容之后，流程就会变成这样：DSP在给Ad Exchange返回竞价响应之前，会先把相关的广告位页面信息及用户人群信息告诉PCP PCP再根据这些信息匹配一个最适合的创意内容，并通过 DSP最终返回给Ad Exchange 同样，PCP也可能会有 自己的私有DMP会再次利用自己的 DMRS行匹配，返回一个更适宜的创意。以下是两个可能的投

3、放流程，演示了从用户访问网站 SSP到最终看到PCP返回的广告创意内容的过程人群定向：PCP投放流程DSP1USEReawe Engiadclco-okie domain: double dick cookie id(dbcid)； abc> SSP > ADXaddbid. $1.0RIBbid: $11.5,V» DSP3Ad Malchingtag adl ad2 ad3tsgl121lag23i2lag3231-rfIag1,1ag2dbcid: abcus.er(lag1.tag2)DMPCookie Mappingdbcld； a betagtlag2dbci

4、ddspid abc 123 def 456图1: DSP直接发送分析后的匹配人群标签dbcid a bedbcid a be useHiag i stg2图2: DSP只发送cookie id，必须再次从 DMP查找用户人群标签从以上两个流程图可以看到，PCP跟DSP进行对接过程中，需要DSP提供相关参数用于程序化创意组合的展示。广告主在PCP后台创立创意发布方案后，可以在后台获取到程序化创意地址，如： :/dcp.kuaizitech /?kz_id=127,276,12,114，广告主再将创意地址填写到DSP 后台相应地方合作 DSP应为广告主提供填写第三方创意地址的选项。开始投放后，D

5、SP每次竞价成功的曝光推送请求，都带上以下参数：PCP创意请求参数参数名说明类型长度属性样例kz_id广告ID一组从PCP获取到的包含 方案ID、广告ID、创意ID、 尺寸ID的字符串，以逗号 做分隔stri ng32必选127,276,12,114type创意代码类型，可选jsjso n, iframestri ng10可选默认iframedsp_idDSP IDDSP在PCP绑定的唯一 IDint10可选默认1dmp_idDMP ID数据标签来源的 DMP IDint10可选默认1bid_id竞价ID识别广告曝光的唯一IDstri ng32可选BID00012345user_tag用户人群

6、标签 可以是网站类型、频道、 关键字、应用类型等stri ng255可选多个以逗号分 害9,如：NBA,IT,男 如果带标签权 重，那么如：tag1:10,tag2:15,t ag3:20ref广告投放来路stri ng255可选 :/ site.c om/urlclick_3p第三方点击监测链接stri ng255可选 :/ site.c om/click使用en codeURIComp onent编码impressi on_3p第三方曝光监测链接stri ng255可选 :/ site.c om/impressi on 使用en codeURIComp onent编码landin g_pa

7、ge强制指定落地页点击创意将直接翻开指定 落地页，同时异步加载筷 子统计页。也可以指定一个外部函 数，点击时将直接触发此 函数，不再跳转iframe 参数需设置为n 0。stri ng255可选 :/ site.c om/landing page 或者outer.click()使用en codeURIComp onent编码iframe是否输出框架代码yes:先输出框架，然后再将 创意内容输出到框架内no:直接将创意内容输出到 当前页面stri ng20可选默认yeslogo设置logo显示位置lt:左上 rt:右上 lb:左下rb:右下stri ng20可选默认不显示time当前时间戳，防止

8、浏览器 缓存，每次加载时动态获 取，一般用于JS方式加载stri ng20可选(newDate().getTime()创意代码。DSP、PCP对接准备工作：1. PCP为合作 DSP生成唯一的 DSP ID。2. DSP后台增加广告主填写第三方创意地址的功能。后期可双方协商通过API自动获取可选第三方动态创意供广告主选择3. 双方人群标签进行匹配。DSP后台可能的操作步骤如下:1、新建广告方案方案名称2、设置根本投放策略周期、预算、出价等3、设置人群定向，如下列图：其中“汽车是根底人群，“娱乐、“时尚、“旅游、 户外、“奢侈品、“体育运动、“家居生活是额外兴趣人群。4、上传创意时，选择“ KZ

9、PCP筷子科技为第三方动态创意平台，弹出输入框填写 第三方创意地址。后期可自动通过接口显示绑定登录到KZPCP的中转页面，完成帐号绑定后，自动列出广告商在KZPCP对应的广告列表，选择其中之一进行广告绑定。广告绑定成功后，接口自动同步双方的广告信息，包括广告ID，广告尺寸，广告地址,点击地址等。300-250728-90336-2804JXT3Wurarn25CT2M200-2CM)468-60酌占抚険；4&33%13.&4%10.30%645%3.18%4.66fe4.1B%2.51%1L?S%1.63%弼尺汝咲:g&D-ffi)JJ0r6OT22D'12QB

10、OO'ISD5KF3XK24D'ia)sio'gu64CK90250-250約占超：0.&K%o.ai%0.30%a.imoumi“3%0.00%民寸：宙斬寸将匕痢巫 乂非鮒尺可的用法上信上传避函虫因怠PCP后台获取创意代码步骤:1. 点击动态创意投放菜单2. 选择要投放的创意3. 点击创意预览图上方的“代码4. 在弹出窗口中根据实际情况选择JS代码或iframe代码心匕广皆檯枚代码£代码:iframeK 玛:r»» a创 Flash;<ECTipt src=wbttp：/dcp. Iknai zitedk. com/?kz_

11、id=L27,276 12L15Stype=j s*X/script><i frame i d=dcpP 127r 276,12.115" sta- : /dcp. kuaiii tecli. Gom/?kE_i t=127f 276z 12, 115 h皂:i ght="280" o-argi nw i dthO" marginLeight=OAi hordlerO41 screlli ng=no £rameborder=l£L276d2U15 : /dgp, kuti z：i t打扎 ge.1 dsl£? 2

12、75 1乙 115西HftfldMhesliS文件,1 f下如直接上樽到广因5或禹三方广吿臺统里即可投fluADX 或 SSP。JS代码，并通过ref参然后，DSP通过自己系统中动态生成带参数据创意代码，并推送给 如果DSP有自己的广告推广框架页面，可在广告页面中嵌入我们的 数传递广告投放的真实页面地址，如：<script>docume nt.write('<scriptsrc=" :/dcp.kuaizitech /?kz_id=164,338,33&type=js&ref='+e ncodeURICompo nen t(docum

13、en t.referrer)+"'x/'+'script>')</script>Flash及视频播放器支持如果DSP支持flash创意投放，还可以下载我们的创意flash文件，然后上传到到 DSP系统中进行投放。 这时要注意，DSP不需要在flash上层加DIV点击链接，flash内部会自动 生成动态点击链接， 如果DSP需要统计点击，可以通过flash设置参数click_3p传递到flash 内部。Flash参数传递方式有两种：1通过flash文件地址传递。假设从 PCP导出的的flash上传到到DSP系统后后地址为： :/dcp.

14、kuaizitech /view.swf ， DSP 点击监测链接为： :/ dsp /tarck71234 那么flash代码如下：vobject id="dc" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase=" :/dow nl oad.macromedia /pub/shockwave/cabs/flash/swflash.c ab#versio n=11,0,0,0" width="336" height="280&qu

15、ot;>vparam n ame="movie" value=" :/dcp.kuaizitech /view.swf?click_3p= %3A%2F%2F dsp %2Ftarck% 3F1234">vparam n ame="quality" value="high"> vparam n ame="wmode" value="tra nspare nt"> vparam n ame='allowScriptAccess' valu

16、e ='always' /> vembed src=" :/dcp.kuaizitech /view.swf?click_3p= %3A%2F%2F dsp %2Ftarck%3F 1234" width="336" height="280" quality="high"plugi nspage=" :/ macromedia /go/getflashplayer" type="applicati on /x-shockwave-flash" wmode

17、="tra nspare nt" allowScriptAccess="always" ></embed></object>注意：allowScriptAccess参数一定要设置为 always， URL要进行编码。2、通过设置flash参数flashvars传递。假设从 PCP导出的的flash上传到到DSP系统后后 地址为： :/dcp.kuaizitech /view.swf ， DSP 点击监测链接为： :/ dsp /tarck71234 那么flash代码如下：vobject id="dc"

18、classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase=" :/dow nl oad.macromedia /pub/shockwave/cabs/flash/swflash.c ab#versio n=11,0,0,0" width="336" height="280">vparam n ame="movie" value=" :/dcp.kuaizitech /view.swf">vparam

19、 n ame="quality" value="high">vparam n ame="wmode" value="tra nspare nt"> vparam n ame='allowScriptAccess' value ='always' />vparam name='flashvars' value ='click_3p= %3A%2F%2F dsp %2Ftarck%3F1234' />vembed src="

20、; :/dcp.kuaizitech /view.swf" width="336" height="280" quality="high" plugi nspage=" :/ macromedia /go/getflashplayer"type="application/x-shockwave-flash" wmode="transparent" allowScriptAccess="always" flashvars="click_3

21、p= %3A%2F%2F dsp %2Ftarck%3F1234"x/embed> </object>同样注意：allowScriptAccess参数一定要设置为 always, URL要进行编码还有用户标签，用户cookie id，页面来路ref等参数传递，也可以参考上面两种方式通过flash参数进行传递。如： :/dcp.kuaizitech /view.swf7click 3p= %3A%2F%2F dsp %2Ftarck%3F1234& user tag=NBA&ref= %3A%2F%2F baidu %2Fs%3Fwd%3D%25E7%

22、2599%25BE%25E5%25BA%25A6%25E7%259F%25A5%25E9%2581%2593%26ie%3Dutf-8移动端DSP支持另外，我们也支持移动端对接，我们专门为移动端DSP或网盟提供JSON格式数据： :/dcp.kuaizitech /?kz id=119,267,12&type=json"width":"336","height":"280","type":"img","creative_url":" :Wi mg.kuaizitech V267V42_12.jpg?1407817524","click_url":" :Wd cp.kuaizitech VclickV?click_url=mzax%3A%2F%2Fdef.btiuq.jwv%2Fvyw mzia%2F580.pcrr%23692%2C25&kz_hash=eNoFwbEVgCAMBcBd n