DSP、DMP合作接口方案.doc

《DSP、DMP合作接口方案.doc》由会员分享，可在线阅读，更多相关《DSP、DMP合作接口方案.doc（9页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

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

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

3、有自 己的私有 DMP，会再次利用自己的 DMP 进行匹配，返回一个更合适的创意）。以下是两个可能的投放流程，演示了从用户访问网站 SSP 到最终看到 PCP 返回的广告 创意内容的过程（人群定向）： PCP 投放流程投放流程（图 1：DSP 直接发送分析后的匹配人群标签）（图 2：DSP 只发送 cookie id，必须再次从 DMP 查找用户人群标签）从以上两个流程图可以看到，PCP 跟 DSP 进行对接过程中，需要 DSP 提供相关参数用于程序化创意组合的展示。广告主在 PCP 后台创建创意发布计划后，可以在后台获取到程序化创意地址，如：http:/ DSP后台相应地方（合作 DSP 应

4、为广告主提供填写第三方创意地址的选项）。开始投放后，DSP 每次竞价成功的曝光推送请求，都带上以下参数：PCP 创意请求参数创意请求参数参数名说明类型长度属性样例kz_id广告 ID 一组从 PCP 获取到的包含 计划 ID、广告 ID、创意 ID、尺寸 ID 的字符串， 以逗号做分隔string32必选127,276,12,114type创意代码类型，可选string10可选默认 iframejs,json,iframedsp_idDSP ID DSP 在 PCP 绑定的唯一 IDint10可选默认 1dmp_idDMP ID 数据标签来源的 DMP IDint10可选默认 1bid_id竞

5、价 ID 识别广告曝光的唯一 IDstring32可选BID00012345user_tag用户人群标签 可以是网站类型、频道、 关键字、应用类型等string255可选多个以逗号分割， 如： NBA,IT,男 如果带标签权重， 则如： tag1:10,tag2:15,t ag3:20creative_tag创意标签 用户自由定义，通过传递 此标签定向到特定创意string255可选多个以逗号分割， 如： 娱乐,体育ref广告投放来路string255可选http:/www.site.c om/urlclick_3p第三方点击监测链接 多个链接可使用 JS 全局 数组变量传递，如： var c

6、lick_3p_arr=url1,url2 ;string255可选http:/www.site.c om/click 或者 click_3p_arr URL 使用 encodeURIComp onent 编码impression_3p第三方曝光监测链接string255可选http:/www.site.c om/impression 使用 encodeURIComp onent 编码landing_page强制指定落地页 点击创意将直接打开指定 落地页，同时异步加载筷 子统计页。 也可以指定一个外部函数， 点击时将直接触发此函数， 不再跳转（iframe 参数需 设置为 no）。string

7、255可选http:/www.site.c om/landing_page 或者 outer.click() 使用 encodeURIComp onent 编码iframe是否输出框架代码 yes:先输出框架，然后再 将创意内容输出到框架内 no:直接将创意内容输出到string20可选默认 yes当前页面async是否异步加载 JS（仅在 iframe=yes 生效） yes:异步加载，即 load 完 后再 append 到 body 中 no:直接 document.write 到 页面当前位置string20可选默认为 noglobal_var外加框架时，需要传入 iframe 的全局

8、变量（仅在 async=yes 时生效）string20可选JS 变量名logo设置 logo 显示位置 lt:左上 rt:右上 lb:左下 rb:右下string20可选默认不显示time当前时间戳，防止浏览器 缓存，每次加载时动态获 取，一般用于 JS 方式加 载 创意代码。string20可选(new Date().getTime( )DSP、PCP 对接准备工作对接准备工作:1.PCP 为合作 DSP 生成唯一的 DSP ID。 2.DSP 后台增加广告主填写第三方创意地址的功能。（后期可双方协商通过 API 自动获 取可选第三方动态创意供广告主选择） 3.双方人群标签进行匹配。DSP

9、 后台可能的操作步骤如下：后台可能的操作步骤如下：1、新建广告计划（计划名称） 2、设置基本投放策略（周期、预算、出价等） 3、设置人群定向，如下图：其中“汽车”是基础人群，“娱乐”、“时尚”、“旅游、 户外”、“奢侈品”、“体育运动”、“家居生活”是额外兴趣人群。4、上传创意时，选择“KZPCP(筷子科技)”为第三方动态创意平台，弹出输入框填写 第三方创意地址。（后期可自动通过接口显示绑定登录到 KZPCP 的中转页面，完成 帐号绑定后，自动列出广告商在 KZPCP 对应的广告列表，选择其中之一进行广告绑 定。广告绑定成功后，接口自动同步双方的广告信息，包括广告 ID，广告尺寸，广告 地址，

10、点击地址等。）PCP 后台获取创意代码步骤：后台获取创意代码步骤：1.点击动态创意投放菜单 2.选择要投放的创意 3.点击创意预览图上方的“代码” 4.在弹出窗口中根据实际情况选择 JS 代码或 iframe 代码然后，DSP 通过自己系统中动态生成带参数据创意代码，并推送给 ADX 或 SSP。 如果 DSP 有自己的广告推广框架页面，可在广告页面中嵌入我们的 JS 代码，并通过 ref 参 数传递广告投放的真实页面地址，如：document.write()Flash 及视频播放器支持及视频播放器支持如果 DSP 支持 flash 创意投放，还可以下载我们的创意 flash 文件，然后上传到

11、到 DSP 系统中进行投放。这时要注意，DSP 不需要在 flash 上层加 DIV 点击链接，flash 内部会自 动生成动态点击链接，如果 DSP 需要统计点击，可以通过 flash 设置参数 click_3p 传递到 flash 内部。Flash 参数传递方式有两种：1、通过 flash 文件地址传递。假设从 PCP 导出的的 flash 上传到到 DSP 系统后后地址为： http:/ 点击监测链接为：http:/ 则 flash 代码如下：注意：allowScriptAccess 参数一定要设置为 always，URL 要进行编码。2、通过设置 flash 参数 flashvars

12、传递。假设从 PCP 导出的的 flash 上传到到 DSP 系统后后 地址为： http:/ 点击监测链接为：http:/ 则 flash 代码如下：同样注意：allowScriptAccess 参数一定要设置为 always，URL 要进行编码还有用户标签，用户 cookie id，页面来路 ref 等参数传递，也可以参考上面两种方式通过 flash 参数进行传递。如： http:/ &user_tag=NBA&ref=http%3A%2F%2F%2Fs%3Fwd%3D%25E7%2599%25B E%25E5%25BA%25A6%25E7%259F%25A5%25E9%2581%2593

13、%26ie%3Dutf-8如果播放器支持 VAST（Video Ad Serving Template）协议，我们还提供的 VAST 协议的 xml 链接，可以推送视频前贴片，及播放浮窗广告。 线性(前贴片广告)： http:/ 非线性(播放浮窗)： http:/ DSP 支持支持另外，我们也支持移动端对接。 如果是支持 HTML5 或 JS 的 SDK，可以直接推送我们的 JS 或 iframe 代码。 对于不支持 JS 的旧版 SDK，我们专门提供 JSON 格式数据，用于 server to server 的对接：http:/ mzia%2F580.pcrr%23692%2C25&k

14、z_hash=eNoFwbEVgCAMBcBdnCAJIRKtdFwwh0DAwm eF-iz- 8N71KaVpYCVcJ1FnAsOs1izFQlWPwXPJsqtbbFGstVbA7BAbwQIVXFyf0qP3Wzul4- zAti4IYFwiwjD_EG0cNw,&ref=2“,“hover_url“:“http:/dcp.kuaizitech.co m/hover/?kz_hash=eNoFwbEVgCAMBcBdnCAJIRKtdFwwh0DAwmeF-iz- 8N71KaVpYCVcJ1FnAsOs1izFQlWPwXPJsqtbbFGstVbA7BAbwQIVXFyf0qP3

15、Wzul4- zAti4IYFwiwjD_EG0cNw,&ref=b“,“click_3p“:null,“logo“:null返回数据格式如下：参数名说明width创意宽度（像素）height创意高度type创意类型，img、html、flash(移动端不建议使用 flash)creative_url创意文件地址（仅在类型为 img 或 flash 时有效）objs创意元素组合（仅在类型为 html 时有效）background创意背景图片（仅在类型为 html 时有效）click_url创意点击地址hover_url创意悬停地址（触摸时发起，不一定有点击产生）click_3p第三方点击监测链接（可选）logo筷子 logo 位置（左上：lt 左下：lb 右上：rt 右下：rb）null 为不显 示DSP 请求 JSON 地址时，同样可以带上用户标签，来路（APP 名）等数据进行定向推送。 DSP 在接收到数据后，自行处理并推送到用户 APP 端。当然如果用户手机支持 HTML5，直接推送我们的 JS 或者 iframe 代码更好。