亿起发广告主CPS接口文档()重点分析.pptVIP

亿起发广告主CPS业务接入手册 亿玛在线科技有限公司应用开发部 2013.05 V1.3.0 目录 前言 接口 说明 示例 代码 1.1 术语表 1.2 亿起发推广流程 2.1 广告入口 2.2 实时数据接口 2.3 数据查询接口 3.1 JAVA代码 3.2 PHP代码 3.3 .NET/C#代码 * 1.1 术语表 名称 描述 广告主 广告主（Merchant, Advertiser, Retailer, E-retailer, or Online Retailer），是通过网络长期推广销售其产品、提高知名度/访问量、寻找新的营销渠道、新的营销增长点的企业/网站；期望降低营销成本却又能提高收益的公司，及计划重点推介某一项目、产品、服务、网站频道等的企业/网站。是亿起发联盟营销广告活动的提供者，并能承担相关法律责任。如：京东、卓越、当当 广告活动 简称活动，是广告主发布的拥有特定营销效果要求和结算方式的营销活动。一个广告主可以有多个不同合作方式的活动，合作方式有：CPS、CPA、SEM、ROI等。 广告活动ID 简称活动ID，是活动在亿起发的唯一标识。 广告效果认定期 简称RD（Return Day的缩写），是广告主对联盟会员（即网站主）营销效果的评介期限，也可以理解为效果跟踪COOKIE的有效期。 效果跟踪COOKIE 是广告主为了跟踪联盟会员的营销效果，在广告主网站上写的标识联盟会员信息的COOKIE。 网站主 网站主(affiliate,publisher,content site,partner,reseller,associate,email marketer, or search marketer)，是通过申请并播放广告主发布的广告活动、引导用户至广告主页面、达到预定推广效果而获得收益的网站。网站主可以自主选择广告活动，免费享受亿起发的服务并承担相应的法律责任。网站主可以是门户网站、垂直网站、专业网站或个人网站、博客等。如：易购，一淘。 目标地址 也称为着陆页，即点击广告后到达的页面。 1.1 术语表 名称 描述 数据来源 在此文档中数据来源是指哪个合作伙伴推广带来的订单。比如：贵公司和A、B、C三个合作伙伴合作进行推广，数据来源为A时表明订单是由“A”推广产生的。 推广渠道 推广渠道是指通过什么样的媒体及方式推广，在亿起发主要有以下几个渠道：cps、roi、sem等。cps渠道指对媒体没有什么特殊的要求，roi是指在一些优质媒体上进行推广，sem指的是搜索引擎的推广。 注：本文档中红色字体为需要特别注意的部分。 2.1 广告入口 广告入口是广告主提供给亿起发的在广告跳转过程中能记录联盟以及网站主信息的链接，这些信息保存在COOKIE中，采用last click win（即效果算做最后一次带来流量的联盟和网站主）的方式更新COOKIE的值。 广告入口参数如下表： 名称 含意 格式 长度 说明 source 数据来源 字符串 广告主指定 广告主标识数据的来源，在来源不为空的情况下请如实记录 channel 推广渠道 字符串 广告主指定 广告主标识数据的推广渠道。不传值，直接默认为channel=cps cid 活动ID 数字 20 亿起发分配给广告主的标识，多个推广渠道分配多个值 wi 反馈标签 字符串 500 可以有字母、数字、“_”。 ）组成 target 目标地址 字符串 广告主指定 广告主网站的任意链接，这个链接网站主在投放广告的时候可以更改。 左侧表格中除target参数外都是必要参数，source、channel 可以让广告主接口在多合作 伙伴、多渠道推广时具有最大 的灵活性，且给广告主统计各 个渠道的数据带来方便，一次 开发多次使用。cid、wi是亿起发统计数据和给站长结算的依据，也是必不可少的。 target参数是广告入口记录COOKIE后要跳转到的链接地址，请根据自己网站使用的字符集进行URLDecode,防止目标地址参数丢失。 2.1 广告入口 广告入口形式： 注意：红色部分为目标地址，目标地址在网站主投放广告时可以修改为广告主网站的任意一个链接。 /track.page?source=emarchannel=cpscid=101wi=NDgwMDB8dGVzdA==target=/some.page 广告入口的功能： 1、读取链接参数source、channel、cid、wi、target的值。 2、在COOKIE中保存参数source、channel、cid、wi的值，并设置COOKIE有效期。 3、对参数目标地址做URLDecode(所有字符集与广告主网站使用的字符集相同)操作后跳转到目标地址指定的页面。 （如果您使用的是由亿起发提供的sdk，