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

爱德威CHANet成果网媒体接口说明CHANet的媒体接口类型可分为两类：##网站媒体定时读取CNAHet数据的接口##CHANet实时发送数据给网站媒体的接口1．网站媒体定时来读CHANet数据：数据齐全，能读取成果网广告链接：=111&d=111&u=&e=里的u（string型），e（int型）两个下线信息，支持媒体下线返点功能。详细读报表方法如下：通过rest调用数据查询接口：1.请求查询报表：=用户名&password=密码&token=令牌&as_id=网站编号&start_time=开始时间&end_time=结束时间用户名、密码和网站编号使用chanet系统的设定令牌为CHANet客服给出。开始时间和结束时间表示查询时间范围，精确到天，格式为yyyy-mm-dd如果参数无误，返回xml中将包括一个查询编号（job_id）2.查询报表状态=用户名&password=密码&token=令牌&job_id=查询编号如果参数无误，返回xml中将包括查询报表状态：正在生成（working）或生成完毕（finished）3.获取报表=用户名&p=密码&t=令牌&j=查询编号报表生成完毕后，返回xml包括查询的成果信息://(Required)使用者的用户名password/p(Required)使用者的密码token/t(Required)分配给使用者的令牌job_id/j(Required)查询编号名词解释：AS：联盟网站，广告都是投放在在联盟网站上PT：联盟网站主，各个联盟网站管理MC：广告主，决定投放广告的商家DRAFT：放在联盟网站上的广告源代码PROMOTION：广告主投放广告所做的一个活动ACTION：为某个广告做的成果关于权限每个api用户（包括网站与广告主）使用其用户名，密码以及被分配的令牌来进行身份验证。系统会分配一定的限额给每个api用户，每次调用api操作都会消耗一定的配额。通过配额的限制，系统可以控制一个用户可以调用一个操作多少次，也可以控制参数的范围。例如：如果’getReport’操作每天要消耗１０点的配额，那么一个从2006-01-01到2006-01-05的同样的操作就要消耗５０点的配额。PTAPI数据类型Promotion:(AS申请的一个活动)IntID;(活动标示)Stringpromotion_name;（活动名称）Stringmerchant_name;（活动的广告主名称）StringLOGO_URL;（LOGO的URL）DateSTART_TIME;（活动开始时间）DateEND_TIME;（活动结束时间）StringINTRODUCTION;（活动介绍）StringCATEGORY;(活动类别)Stringcertification;（广告活动的认证状态）Thanks[]THANKS;（具体活动的具体成果的类别）Thanks:（具体活动的具体成果的类别）StringNAME;（类别名称）StringTYPE;（类型，表示是一个click还是一个action，等等）FloatPRICE;（价格）Draft:（原稿）IntID;（原稿标示）StringNAME;（原稿名）StringURL;（原稿链接）StringSIZE;（原稿大小）StringTYPE;（原稿类型）StringPREVIEW_CODE;（用于预览的原稿代码，点击不计click）StringADVERTISEMENT_CODE;（用于放置在AS网站上的真实原稿代码，点击不计click）Action:（成果）IntPROMOTION_ID;（活动标示，这个成果是属于这个活动的）StringPROMOTION_NAME;（活动名称）StringTHANKS_NAME;（成果类型名称）IntEXT_INFO;（下线的ID，必须为数字，通过链接中的e参数得到）StringIP;（成果发生的来源ip）StringUSER_INFO;（成果发生的用户信息，通过链接中的u参数得到）FloatPRICE;（成果价格）TimeRECORD_TIME;（成果记录时间）TimeCONFIRM_DEADLINE;（成果确认最后期限）TimeCONFIRM_TIME;（成果确认时间）StringCONFIRM_STATUS;（成果确认状态）Ext:（AS的下线）IntEXT_ID;（AS下线标示）Record[]RECORDS;（某个下线按draft的记录）Record:（按某个具体draft的记录）IntDRAFT_ID;（原稿的标示）StringDRAFT_NAME;（原稿名称）IntPROMOTION_ID;（该原稿对应的活动标示）StringPROMOTION_NAME;（该原稿对应的活动名称）IntPAGEVIEW;（该原稿被浏览次数）IntCLICK;（该原稿被点击次数）IntTOTAL_ACTION;（从此原稿来源的总成果数）IntUNCONFIRMED_ACTION;（从此原稿来源的尚未被认证的成果数）IntCONFIRMED_ACTION;（从此原稿来源的已认证的成果数）IntREJECTED_ACTION;（从此原稿来源的被否认证的成果数）FloatREMUNERATION;（该原稿产生的报酬）Operation活动相关getPromotionList得到所有对此as可见的活动信息权限需要ＰＴ（联盟网站主，下同）有读权限参数user_name(Required)使用者的用户名password(Required)使用者的密码token(Required)分配给使用者的令牌as_id(Required)调用接口的网站IDcost_type(Required)case-insensitive指定广告活动的类型‘all’‘cpc’‘cpa’‘ec’certification(Required)case-insensitive指定广告活动的认证状态‘all’‘applying’‘approved’‘rejected’‘not_applied’返回值Promotion[]Restinterface参数同上示例：输入=******&password=******&token=########&as_id=28226&cost_type=all&certification=all输出：?xmlversion=1.0encoding=UTF-8?SOAP-ENV:Envelopexmlns:SOAP-ENV=:namesp2=:xsi=:SOAP-ENC=:xsd=:encodingStyle=:Headeruser_namexsi:type=xsd:string******/user_namepasswordxsi:type=xsd:string******/passwordtokenxsi:type=xsd:string########/token/SOAP-ENV:HeaderSOAP-ENV:Bodynamesp1:get_promotion_listxmlns:namesp1=PROMOTIONc-gensym7xsi:type=namesp2:SOAPStructcertificationxsi:type=xsd:stringall/certificationcost_typexsi:type=xsd:stringall/cost_typeas_idxsi:type=xsd:int28226/as_id/c-gensym7/namesp1:get_promotion_list/SOAP-ENV:Body/SOAP-ENV:Envelope?xmlversion=1.0encoding=UTF-8?-soap:Envelopexmlns:xsi=:soapenc=:xsd=:encodingStyle=:soap=:Body-get_promotion_listResponsexmlns=PROMOTION+promotion_listxsi:nil=truesoapenc:arrayType=xsd:anyType[51]xsi:type=soapenc:Array-promotionidxsi:type=xsd:int11/idpromotion_namexsi:type=xsd:stringCHANet招募联盟网站主/promotion_namemerchant_namexsi:type=xsd:string上海爱通广告有限公司/merchant_namelogo_urlxsi:type=xsd:string:type=xsd:date2005-03-01/start_timeend_timexsi:type=xsd:date2008-02-01/end_timeintroductionxsi:type=xsd:string网站主注册只有经CHANet管理部门审核通过的,才视为有效成果./introductioncategoryxsi:type=xsd:string招聘/求职/categorycertificationxsi:type=xsd:string已批准/certification-thanks_listxsi:nil=truesoapenc:arrayType=xsd:anyType[3]xsi:type=soapenc:Array-thanksnamexsi:type=xsd:stringclick