如何发布CPS销售广告

如何发布CPS销售广告

广告商帮助|2020-02-03 17:29:16

格屋广告联盟系统CPS接口手册 

 

一、 说明 

针对广告联盟CPS计划,实现实时数据接受的API接口调用或开发

 

二、 实现步骤

1、 联盟发布广告计划,设置接口Key密钥,

2、 发布计划后,在计划管理中取的计划ID

3、 放置或请求订单实时入库接口 

    4、放置或请求已付款(订单有效状态)接口

三、 接口实现

方法:有两种方式

使用iframe框架式

或是使用SocketAjax直接POST或是GET接口地址

接口地址http://www.a.com/ track/cps.php

 

订单建立参数表

参数

说明

参数格式

必须

action

固定值create

String

order

订单号

String

orderamount

订单总价

Float

假设计划为固定分成此项为必须

goodsname

商品名称,一单多商品使用|符分隔

String

如:商品1|商品2

goodsprice

商品价格,一单多商品使用|符分隔

String

如:12.3|200.5

假设计划分成设置的为按类目分成,此项为必须项

goodsmark

订单标识,一单多商品使用|符分隔

String

如:1|3

假设计划分成设置的为按类目分成,此项为必须项

customaff

会员自定义分成比例

Int

1~100

计划分成设置成接口自定义时为必须项

customadv

广告商给的分成比例

同上

同上

sig

数据签名

Md5(order+key)

String

32MD5加密

planid

计划id

Int

status

订单状态

String

如:已下单,未付款

uid

联盟会员id值,在非iframe接品方调用的此项为必须项

Int

如:1001

iframe方式可以为空

aid

广告ID

Int

如:22

zid

广告位ID

Int

如:212

sid

网站ID

Int

如:11

 

iframe接口示例:

 src='http://www.a.com/track/cps.php?action=create&planid=1&order=2014080133866 &orderamount=38&goodsname=衣服&sig=d37db4800a742e5b894ae519940b6651'>

 

SocketAjaxe接口示例(uid必须带上)

url='http://www.a.com/track/cps.php?action=create&planid=1&order=2014080133866 &orderamount=38&goodsname=衣服&sig=d37db4800a742e5b894ae519940b6651&uid=1001'> 

 

返回值:

返回值

说明

succeed

成功

为空或其他值

 

 

 

 

订单更新参数表

参数

说明

参数格式

必须

action

固定值update

String

order

订单号

String

planid

计划id

Int

valid

值不等于true时,只更新订单状态,为true时更新报表和拥金

true

false(或为空)

status

订单状态

String

如:已付款

sig

数据签名

Md5(order+valid+status+key)

String

32MD5加密,请注意顺序

 

iframe接口示例:

 

 src='http://www.a.com/track/cps.php?action=update&planid=1&order=2014080133866 &valid=true&status=已付款&sig=d37db4800a742e5b894ae519940b6651'>

 

SocketAjaxe接口示例:

url='http://www.a.com/track/cps.php?action=update&planid=1&order=2014080133866 &valid=true&status=已付款&sig=d37db4800a742e5b894ae519940b6651'> 

 

返回值:

返回值

说明

succeed

成功

为空或其他值