您好,欢迎访问三七文档
当前位置:首页 > 商业/管理/HR > 广告经营 > 爱德威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’操作每天要消耗10点的配额,那么一个从2006-01-01到2006-01-05的同样的操作就要消耗50点的配额。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可见的活动信息权限需要PT(联盟网站主,下同)有读权限参数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
本文标题:爱德威chanet成果网媒体接口说明
链接地址:https://www.777doc.com/doc-1481559 .html