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

爱德威CHANet成果网媒体接口说明 CHANet的媒体接口类型可分为两类： ## 网站媒体定时读取CNAHet数据的接口 ## CHANet实时发送数据给网站媒体的接口 1．网站媒体定时来读CHANet数据： 里的u〔string型〕，e〔int型〕两个下线信息，支持媒体下线返点功能。详细读报表方法如下： 通过rest调用数据查询接口： 1.请求查询报表： 用户名、密码和网站编号使用chanet系统的设定 令牌为CHANet客服给出。 开始时间和结束时间表示查询时间范围，精确到天，格式为yyyy-mm-dd 如果参数无误，返回xml中将包括一个查询编号〔job_id〕 如果参数无误，返回xml中将包括查询报表状态：正在生成〔working〕或生成完毕〔finished〕 报表生成完毕后，返回xml包括查询的成果信息 mc Parameters user_name/u (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的同样的操作就要消耗５０点的配额。 PT API 数据类型 Promotion:(AS申请的一个活动) Int ID;(活动标示) String promotion_name;〔活动名称〕 String merchant_name;〔活动的广告主名称〕 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 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，必须为数字，通过链接中的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_ID;〔原稿的标示〕 String DRAFT_NAME;〔原稿名称〕 Int PROMOTION_ID;〔该原稿对应的活动标示〕 String PROMOTION_NAME;〔该原稿对应的活动名称〕 Int PAGEVIEW;〔该原稿被浏览次数〕 I