亿起发广告主CPS接口文档(最新).ppt

1、亿起发广告主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#代码,3,1.1 术语表,1.1 术语表,注：本文档中红色字体为需要特别注意的部分。,2.1 广告入口,广告入口是广告主提供给亿起发的在广告跳转过程中能记录联盟以及网站主信息的链接，这些信息保存在COOKIE中，采用last click win（即效果算做最后一次带来流量的联盟和网站主）的方式更新COOKIE的值。 广告入口参数如下

2、表：,左侧表格中除target参数外都是必要参数，source、channel 可以让广告主接口在多合作 伙伴、多渠道推广时具有最大 的灵活性，且给广告主统计各 个渠道的数据带来方便，一次 开发多次使用。cid、wi是亿起发统计数据和给站长结算的依据，也是必不可少的。 target参数是广告入口记录COOKIE后要跳转到的链接地址，请根据自己网站使用的字符集进行URLDecode,防止目标地址参数丢失。,2.1 广告入口,广告入口形式： 注意：红色部分为目标地址，目标地址在网站主投放广告时可以修改为广告主网站的任意一个链接。 广告入口的功能： 1、读取链接参数source、channel、ci

3、d、wi、target的值。 2、在COOKIE中保存参数source、channel、cid、wi的值，并设置COOKIE有效期。 3、对参数目标地址做URLDecode(所有字符集与广告主网站使用的字符集相同)操作后跳转到目标地址指定的页面。 （如果您使用的是由亿起发提供的sdk，一些默认参数可直接使用各版本定义好的即可）,2.2 实时数据接口,实时数据接口由亿起发提供，用于接收广告主的订单数据。广告主需要在订单生成后支付前调用此接口向亿起发发送订单数据，不作为最后结算的依据。此接口发送所有来源为亿起发的订单，实时性好，网站主能及时看到产生的订单，有助于增强网站主推广的信心，请求格式：,2

4、.2 实时数据接口,优惠券分摊处理公式： price（商品金额）=商品单价*【1-（优惠券金额/总价）】 （查询接口显示也同样这样处理） 问题描述： 一个订单，商品A单价100元1件、商品B单价50元2件，使用优惠券金额20元，此时总价为200： 商品A对应的price=100*1-(20/200)=90 amount参数=1 商品B对应的price=50*1-(20/200)=45 amount参数=2,2.2 实时数据接口,1、实时数据接口形式： interId=519200e5e03bbcaa579e8b04 Sender send = new Sender(order); send.s

5、endOrder(request); 2、发送订单状态信息： orderStatus orderStatus = new orderStatus(); Sender send = new Sender(orderStatus); send.sendOrderStatus(); 特别注意： a、广告主在和亿起发对接接口时，需要在配置文件中设置接口ID（亿起发提供）。 b、该类根据订单信息拼接URL,拼接URL时会对商品名称、下单时间和佣金类型进行编码。,3.1 JAVA代码,三）、java版本Sdk查询接口调用说明： 调用方式，例如： ,3.1 JAVA代码,注意：需要使用PHP5或者PHP5以

6、上版本 一）、php版本Sdk广告入口调用说明： 实现功能：接受亿起发传过去的参数，创建AdEnter对象，调用jump方法，传入获取的参数保存cookie并跳转到对应的目标地址。 网站调用接口的形式：,3.2 PHP代码,二）、php版本Sdk实时推送接口调用说明： 实现功能： Sender类为实时数据接口类,接口用于推送送广告主的订单数据,广告主需要在订单生成后、支付前调用此接口程序会读取亿起发cookie、拼接链接向亿起发发送订单数据。 发送格式为JSON 。默认编码格式为 GBK （配置文件yiqifa-config.php中可更换）。 Sender类使用方法： 1、发送订单信息： $

7、sender = new Sender(); $sender - setOrder($order); $sender - sendOrder(); 测试文件参考TestOrder.php 2、发送订单状态信息： $sender = new Sender(); $sender - setOrder($orderStatus); $sender - sendOrderStatus(); 测试文件参考TestOrderStatus.php 特别注意： 广告主在和亿起发对接接口时，需要在配置文件中设置接口ID（亿起发提供）。,3.2 PHP代码,三）、php版本Sdk查询接口调用说明： 调用的方式：

8、/查询的是在orderStartTime和orderEndTime这段的时间段内的订单 /查询的是在updateStartTime和updateEndTime这段时间段内订单状态发生变化的订单 相关类说明： 1.getOrder.php，订单信息查询接口 2.getOrderStatus.php，订单状态信息查询接口 3.Dto.php，操作数据库，把查询出来的数据已json的格式返回。 特别注意： 1、yiqifa-config.php，配置文件，该文件为主配置文件，重要和常用的变量都在该文件中设置。其中涉及到IP限制和sign签名的设置 2、util/Config.php，工具类，getS

9、tring($name)方法调用亿起发获取yiqifa-config.php配置文件中已设置的变量。,3.2 PHP代码,注意点：需要使用Visual Studio 2008版本 一）、.net版本Sdk广告入口调用说明 实现功能：接受亿起发传过去的参数，创建AdEnterCore的对象，调用jump方法，获取参数保存至cookie并跳转到对应的目标地址。 网站调用接口的形式： ,3.3 .NET代码,二）、.net版本Sdk实时推送接口调用说明 业务逻辑：当用户点击“提交订单”按钮时，程序判断是否是亿起发带去的订单， 如果是，将订单信息回传给我们。 代码调用示例： protected voi

10、d Button1_Click(object sender, EventArgs e) GetDataFromPage gdfp = new GetDataFromPage(); List order = new List(); order = this.getOrder(); string url = gdfp.getOrderFromPage(order); Sender s = new Sender(); s.send(url); protected void Button2_Click(object sender, EventArgs e) GetDataFromPage gdfp = new GetDataFromPage(); List orderStatuss = new List(); orderStatuss = this.getOrderStatus(); string url = gdfp.getStatusFromPa