爱德威CHANet成果网媒体接口说明

1、爱德威CHANet成果网媒体接口说明CHANet的媒体接口类型可分为两类：# 网站媒体定时读取CNAHet数据的接口# CHANet实时发送数据给网站媒体的接口1网站媒体定时来读CHANet数据：数据齐全，能读取成果网广告链接：里的u（string型），e（int型）两个下线信息，支持媒体下线返点功能。详细读报表方法如下：通过rest调用数据查询接口：1.请求查询报表：用户名、密码和网站编号使用chanet系统的设定令牌为CHANet客服给出。开始时间和结束时间表示查询时间范围，精确到天，格式为yyyy-mm-dd如果参数无误，返回xml中将包括一个查询编号（job_id）2.查询报表状态如果

2、参数无误，返回xml中将包括查询报表状态：正在生成（working）或生成完毕（finished）3.获取报表报表生成完毕后，返回xml包括查询的成果信息Parametersuser_name/u (Required) 使用者的用户名password/p (Required) 使用者的密码token/t (Required) 分配给使用者的令牌job_id/j (Required) 查询编号名词解释：AS：联盟网站，广告都是投放在在联盟网站上PT：联盟网站主，各个联盟网站管理MC：广告主，决定投放广告的商家DRAFT：放在联盟网站上的广告源代码PROMOTION：广告主投放广告所做的一个活动A

3、CTION：为某个广告做的成果关于权限每个api用户（包括网站与广告主）使用其用户名，密码以及被分配的令牌来进行身份验证。系统会分配一定的限额给每个api用户，每次调用api操作都会消耗一定的配额。通过配额的限制，系统可以控制一个用户可以调用一个操作多少次，也可以控制参数的范围。例如：如果getReport操作每天要消耗点的配额，那么一个从2006-01-01到2006-01-05的同样的操作就要消耗点的配额。PT API数据类型Promotion:(AS申请的一个活动)Int ID;(活动标示)String promotion_name;（活动名称）String merchant_name;

4、（活动的广告主名称）String LOGO_URL;（LOGO的URL）Date START_TIME;（活动开始时间）Date END_TIME;（活动结束时间）String INTRODUCTION;（活动介绍）String CATEGORY;(活动类别)String certification;（广告活动的认证状态）Thanks THANKS;（具体活动的具体成果的类别）Thanks: （具体活动的具体成果的类别）String NAME;（类别名称）String TYPE;（类型，表示是一个click还是一个action，等等）Float PRICE;（价格）Draft:（原稿）Int

5、ID;（原稿标示）String NAME;（原稿名）String URL;（原稿链接）String SIZE;（原稿大小）String TYPE;（原稿类型）String PREVIEW_CODE;（用于预览的原稿代码，点击不计click）String ADVERTISEMENT_CODE;（用于放置在AS网站上的真实原稿代码，点击不计click）Action:（成果）Int PROMOTION_ID;（活动标示，这个成果是属于这个活动的）String PROMOTION_NAME;（活动名称）String THANKS_NAME;（成果类型名称）Int EXT_INFO;（下线的ID，必须为

6、数字，通过链接中的e参数得到）String IP;（成果发生的来源ip）String USER_INFO;（成果发生的用户信息，通过链接中的u参数得到）Float PRICE;（成果价格）Time RECORD_TIME;（成果记录时间）Time CONFIRM_DEADLINE;（成果确认最后期限）Time CONFIRM_TIME;（成果确认时间）String CONFIRM_STATUS;（成果确认状态）Ext:（AS的下线）Int EXT_ID;（AS下线标示）Record RECORDS;（某个下线按draft的记录）Record:（按某个具体draft的记录）Int DRAFT_I

7、D;（原稿的标示）String DRAFT_NAME;（原稿名称）Int PROMOTION_ID;（该原稿对应的活动标示）String PROMOTION_NAME;（该原稿对应的活动名称）Int PAGEVIEW;（该原稿被浏览次数）Int CLICK;（该原稿被点击次数）Int TOTAL_ACTION;（从此原稿来源的总成果数）Int UNCONFIRMED_ACTION;（从此原稿来源的尚未被认证的成果数）Int CONFIRMED_ACTION; （从此原稿来源的已认证的成果数）Int REJECTED_ACTION; （从此原稿来源的被否认证的成果数）Float REMUNERA

8、TION;（该原稿产生的报酬）Operationl 活动相关getPromotionList得到所有对此as可见的活动信息权限需要（联盟网站主，下同）有读权限参数user_name (Required) 使用者的用户名password (Required) 使用者的密码token (Required) 分配给使用者的令牌as_id (Required) 调用接口的网站IDcost_type (Required) case- insensitive 指定广告活动的类型allcpccpaeccertification (Required) case- insensitive 指定广告活动的认证状态

9、allapplyingapprovedrejectednot_applied返回值PromotionRest interface参数同上示例：输入输出：<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="/soap/envelope/" xmlns:namesp2="/xml-soap" xmlns:xsi=&quo

10、t;/1999/XMLSchema-instance" xmlns:SOAP-ENC="/soap/encoding/" xmlns:xsd="/1999/XMLSchema" SOAP-ENV:encodingStyle="/soap/encoding/"><SOAP-ENV:Header><user_name xsi:type=&quo

11、t;xsd:string">*</user_name><password xsi:type="xsd:string">*</password><token xsi:type="xsd:string">#</token></SOAP-ENV:Header><SOAP-ENV:Body><namesp1:get_promotion_list xmlns:namesp1="PROMOTION"><c-gensym7 xsi:

12、type="namesp2:SOAPStruct"><certification xsi:type="xsd:string">all</certification><cost_type xsi:type="xsd:string">all</cost_type><as_id xsi:type="xsd:int">28226</as_id></c-gensym7></namesp1:get_promotion_list>

13、;</SOAP-ENV:Body></SOAP-ENV:Envelope><?xml version="1.0" encoding="UTF-8" ?> - <soap:Envelope xmlns:xsi="/2001/XMLSchema-instance" xmlns:soapenc="/soap/encoding/" xmlns:xsd="/20

14、01/XMLSchema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/soap/envelope/">- <soap:Body>- <get_promotion_listResponse xmlns="PROMOTION">+ <promotion_list xsi:nil="true" soapenc:array

15、Type="xsd:anyType51" xsi:type="soapenc:Array">- <promotion> <id xsi:type="xsd:int">11</id> <promotion_name xsi:type="xsd:string">CHANet招募联盟网站主</promotion_name> <merchant_name xsi:type="xsd:string">上海爱通广告有限公司<

16、/merchant_name> <logo_url xsi:type="xsd:string"> <start_time xsi:type="xsd:date">2005-03-01</start_time> <end_time xsi:type="xsd:date">2008-02-01</end_time> <introduction xsi:type="xsd:string">网站主注册只有经CHANet管理部门审核通过的,才视为有

17、效成果.</introduction> <category xsi:type="xsd:string">招聘/求职</category> <certification xsi:type="xsd:string">已批准</certification> - <thanks_list xsi:nil="true" soapenc:arrayType="xsd:anyType3" xsi:type="soapenc:Array">

18、- <thanks> <name xsi:type="xsd:string">click</name> <price xsi:type="xsd:float">0.0000</price> <type xsi:type="xsd:string">cpc</type> </thanks>- <thanks> <name xsi:type="xsd:string">click ip</name&

19、gt; <price xsi:type="xsd:float">0.0000</price> <type xsi:type="xsd:string">cpc</type> </thanks>- <thanks> <name xsi:type="xsd:string">通过审核</name> <price xsi:type="xsd:float">3.0000</price> <type xs

20、i:type="xsd:string">cpa</type> </thanks> </thanks_list> </promotion>  </get_promotion_listResponse>  </soap:Body>  </soap:Envelope原稿相关getDraftList得到该as做的特定活动的所有的原稿信息权限此方法要求有读权限，并且该活动对于该as而言是可以访问的参数user_name (Required) 使用者的用户名password

21、 (Required) 使用者的密码token (Required) 分配给使用者的令牌as_id (Required) 调用接口的网站IDpromotion_id (Required) 广告活动ID 返回值DraftRest interface参数同上示例：输入：输出：<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="/soap/envelope/" xmlns:name

22、sp2="/xml-soap" xmlns:xsi="/1999/XMLSchema-instance" xmlns:SOAP-ENC="/soap/encoding/" xmlns:xsd="/1999/XMLSchema" SOAP-ENV:encodingStyle="/soap/encoding/

23、"><SOAP-ENV:Header><user_name xsi:type="xsd:string">*</user_name><password xsi:type="xsd:string">*</password><token xsi:type="xsd:string">#</token></SOAP-ENV:Header><SOAP-ENV:Body><namesp1:get_draft_list x

24、mlns:namesp1="DRAFT"><c-gensym7 xsi:type="namesp2:SOAPStruct"><as_id xsi:type="xsd:int">28226</as_id><promotion_id xsi:type="xsd:int">34</promotion_id></c-gensym7></namesp1:get_draft_list></SOAP-ENV:Body></

25、SOAP-ENV:Envelope> <?xml version="1.0" encoding="UTF-8" ?> - <soap:Envelope xmlns:xsi="/2001/XMLSchema-instance" xmlns:soapenc="/soap/encoding/" xmlns:xsd="/2001/XMLSchema" soap:enc

26、odingStyle="/soap/encoding/" xmlns:soap="/soap/envelope/">- <soap:Body>- <get_draft_listResponse xmlns="DRAFT">+ <draft_list xsi:nil="true" soapenc:arrayType="xsd:anyType36" xsi:type

27、="soapenc:Array">- <draft> <id xsi:type="xsd:int">412</id> <draft_name xsi:type="xsd:string">gif130_18</draft_name> <url xsi:type="xsd:string"> <type xsi:type="xsd:string">banner</type> <size xsi:

28、type="xsd:string">130*18</size> <preview_code xsi:type="xsd:string"><img height=18 width=130 src=" <advertisement_code xsi:type="xsd:string"><a href=" target="_blank"><IMG SRC=" height="18" width="

29、130" border="0"></a></advertisement_code> </draft>  </get_draft_listResponse>  </soap:Body>  </soap:Envelope>l 成果相关getActionList得到该as在这段时间内的所有成果信息权限要求PT有读权限参数user_name (Required) 使用者的用户名password (Required) 使用者的密码token (Required) 分配

30、给使用者的令牌as_id (Required) 调用接口的网站IDconfirm_status (Required) case- insensitive 成果认证状态 allunconfirmedconfirmedrejecteduserinfo (Required) case- insensitive 是否需要返回u参数noyesstart_time (Required) 指定查询时间范围的开始时间end_time (Required) 指定查询时间范围的结束时间返回值ActionRest interface参数同上示例：输入：输出：<?xml version="1.0&qu

31、ot; encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="/soap/envelope/" xmlns:namesp2="/xml-soap" xmlns:xsi="/1999/XMLSchema-instance" xmlns:SOAP-ENC="/soap/enco

32、ding/" xmlns:xsd="/1999/XMLSchema" SOAP-ENV:encodingStyle="/soap/encoding/"><SOAP-ENV:Header><user_name xsi:type="xsd:string">*</user_name><password xsi:type="xsd:string">*</password&g

33、t;<token xsi:type="xsd:string">#</token></SOAP-ENV:Header><SOAP-ENV:Body><namesp1:get_action_list xmlns:namesp1="AS_ACTION"><c-gensym7 xsi:type="namesp2:SOAPStruct"><userinfo xsi:type="xsd:string">no</userinfo>&l

34、t;end_time xsi:type="xsd:string">06-08-03</end_time><start_time xsi:type="xsd:string">06-08-01</start_time><confirm_status xsi:type="xsd:string">all</confirm_status><as_id xsi:type="xsd:int">28226</as_id></c-gens

35、ym7></namesp1:get_action_list></SOAP-ENV:Body></SOAP-ENV:Envelope><?xml version="1.0" encoding="UTF-8"?><soap:Envelope xmlns:xsi="/1999/XMLSchema-instance" xmlns:soapenc="/soap/encoding/" x

36、mlns:xsd="/1999/XMLSchema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/soap/envelope/"><soap:Body><get_action_listResponse xmlns="AS_ACTION"><job_id xsi:type="xsd:in

37、t">556</job_id></get_action_listResponse></soap:Body></soap:Envelope><?xml version="1.0" encoding="UTF-8"?><soap:Envelope xmlns:xsi="/1999/XMLSchema-instance" xmlns:soapenc="/soap/enc

38、oding/" xmlns:xsd="/1999/XMLSchema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/soap/envelope/"><soap:Body><get_action_listResponse xmlns="AS_ACTION"><job_id xsi:typ

39、e="xsd:int">556</job_id></get_action_listResponse></soap:Body></soap:Envelope>l EC成果相关get_as_ec_list权限要求PT有读权限参数user_name (Required) 使用者的用户名password (Required) 使用者的密码token (Required) 分配给使用者的令牌as_id (Required) 调用接口的网站IDconfirm_status (Required) case- insensitive 成

40、果认证状态 allunconfirmedconfirmedrejecteduserinfo (Required) case- insensitive 是否需要返回u参数noyesstart_time (Required) 指定查询时间范围的开始时间（格式yyyy-mm-dd）end_time (Required) 指定查询时间范围的结束时间（格式同上）返回值ActionRest interface示例：输入：输出：<?xml version="1.0" encoding="UTF-8" ?> - <soap:Envelope xmlns

41、:xsi="/1999/XMLSchemainstance" xmlns:soapenc="/soap/encoding/" xmlns:xsd="/1999/XMLSchema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/soap/en

42、velope/">- <soap:Body>- <get_action_listResponse xmlns="ACTION">- <action_list soapenc:arrayType="xsd:urtype240" xsi:type="soapenc:Array">- <action> <promotion_id xsi:type="xsd:int">252</promotion_id> <promotion_n

43、ame xsi:type="xsd:string">99读书人推广活动</promotion_name> <thanks_name xsi:type="xsd:string">99读书人</thanks_name> <ext_info xsi:type="xsd:int">34693</ext_info> <ip xsi:type="xsd:string">1</ip> <user_info xsi

44、:type="xsd:string" /> <action_info xsi:type="xsd:string">W070809595340</action_info> <price xsi:type="xsd:float">21.1050</price> - <action_ec_list soapenc:arrayType="xsd:urtype1" xsi:type="soapenc:Array">- <ec>

45、<id xsi:type="xsd:int">24910</id> <goods_name xsi:type="xsd:string" /> <order_price xsi:type="xsd:float">281.4000</order_price> <amount xsi:type="xsd:int">1</amount> <ratio_for_as xsi:type="xsd:float">0

46、.0750</ratio_for_as> </ec> </action_ec_list> <record_time xsi:type="xsd:time">2007-08-09 01:31:36</record_time> <confirm_status xsi:type="xsd:string">unconfirmed</confirm_status> <confirm_time xsi:type="xsd:time" /> </a

47、ction>l 报表相关getReport得到在一段时间内此as的概要报表权限需要PT有读权限参数user_name (Required) 使用者的用户名password (Required) 使用者的密码token (Required) 分配给使用者的令牌as_id (Required) 调用接口的网站IDstart_time (Required) 指定查询时间范围的开始时间end_time (Required) 指定查询时间范围的结束时间返回值ExtRest interface参数同上示例：输入：输出：<?xml version="1.0" encoding

48、="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="/soap/envelope/" xmlns:namesp2="/xml-soap" xmlns:xsi="/1999/XMLSchema-instance" xmlns:SOAP-ENC="/soap/encoding/"

49、xmlns:xsd="/1999/XMLSchema" SOAP-ENV:encodingStyle="/soap/encoding/"><SOAP-ENV:Header><user_name xsi:type="xsd:string">*</user_name><password xsi:type="xsd:string">*</password><token

50、xsi:type="xsd:string">#</token></SOAP-ENV:Header><SOAP-ENV:Body><namesp1:get_report xmlns:namesp1="AS_REPORT"><c-gensym7 xsi:type="namesp2:SOAPStruct"><end_time xsi:type="xsd:string">06-03-03</end_time><start_tim

51、e xsi:type="xsd:string">05-03-03</start_time><as_id xsi:type="xsd:int">28226</as_id></c-gensym7></namesp1:get_report></SOAP-ENV:Body></SOAP-ENV:Envelope><?xml version="1.0" encoding="UTF-8"?><soap:Envelope

52、xmlns:xsi="/1999/XMLSchema-instance" xmlns:soapenc="/soap/encoding/" xmlns:xsd="/1999/XMLSchema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/s

53、oap/envelope/"><soap:Body><get_reportResponse xmlns="AS_REPORT"><job_id xsi:type="xsd:int">551</job_id></get_reportResponse></soap:Body></soap:Envelope><?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:E

54、nvelope xmlns:SOAP-ENV="/soap/envelope/" xmlns:xsi="/1999/XMLSchema-instance" xmlns:SOAP-ENC="/soap/encoding/" xmlns:namesp4="/xml-soap" xmlns:xsd="/1999

55、/XMLSchema"SOAP-ENV:encodingStyle="/soap/encoding/"><SOAP-ENV:Header><user_name xsi:type="xsd:string">*</user_name><password xsi:type="xsd:string">*</password><token xsi:type="xsd:string">#&l

56、t;/token></SOAP-ENV:Header><SOAP-ENV:Body><namesp3:get_report_status xmlns:namesp3="AS_REPORT"><c-gensym14 xsi:type="namesp4:SOAPStruct"><job_id xsi:type="xsd:int">551</job_id></c-gensym14></namesp3:get_report_status>&l

57、t;/SOAP-ENV:Body></SOAP-ENV:Envelope><?xml version="1.0" encoding="UTF-8"?><soap:Envelope xmlns:xsi="/1999/XMLSchema-instance" xmlns:soapenc="/soap/encoding/" xmlns:xsd="/1999/XMLS

58、chema" soap:encodingStyle="/soap/encoding/" xmlns:soap="/soap/envelope/"><soap:Body><get_report_statusResponse xmlns="AS_REPORT"><job_status xsi:type="xsd:string">finished</job_status></get_report_statusResponse></soap:Body></soap:Envelope>getReportStatus得到报表或成果相关服务的状态权限需要PT有读权限参数user_name (Required) 使用者的用户名password