全媒体会员中心集成说明书

1、全媒体会员中心集成说明书一、集成会员数据源系统1.1. 概述全媒体会员中心内部建有客户资源数据库，存储了客户的基础数据（姓名、称呼、生日、单位、地址、邮箱、手机、座机、QQ、微信号等），客户的行为数据（注册、登录、评论、网上购物、线下订购、分享、爆料、活动等）。客户的基础数据，线下客户的行为数据是通过采集程序从各集成系统（即数据源系统）获取。为保证获取数据成功，各集成系统需要遵循数据规范做好数据准备，提供相应的接口。线上客户的行为数据的获取采用另外一种方式，使用全媒体会员中心提供的API,线上系统根据业务需要在行为发生的代码处调用这些API。参见下表。客户数据集成方法线上基础数据系统接SSO实

2、现单点登录，SSO按数据规范准备视图，采集程序从视图采集数据线上行为数据在行为发生处调用全媒体会员中心的API线下基础数据系统按数据规范准备视图，采集程序从视图采集数据线下行为数据系统按数据规范准备视图，采集程序从视图采集数据1.2. 数据源全媒体会员中心从客户资源数据库角度可以集成的系统比较多，简单的讲凡是涉及客户数据的系统都可以集成。这些系统就成了全媒体会员中心的数据源。具体到现代快报项目，可以作为数据源的有线上的新闻网站、分类网站、易购网站、评论系统、app系统，线下有广告、发行和呼叫中心/excel表等。对于线上系统,要求先通过翔宇的SSO实现单点登录功能，这样全媒体会员中心直接从SS

3、O获取客户信息，不再通过各线上数据源。1.3. 数据规范1.3.1. 基础数据1 .存量数据的数据采集。需要数据源系统提供视图。视图字段参考如excel文件会员基础字段标准表说明。2 .增量数据的采集。全媒体会员中心需要在各数据源数据库中创建表ucMemberTmp,用来记录客户基础信息增删改日志，方便同步。名称字段名类型长度是否为空描述idIdVARCHAR255否原始数据ID标识flagINTEGER10否0-delete1- insert2- update时间戳changetimeTIMESTAMP否自动生成数据源系统在客户信息表上创建触发器，以向ucMemberTmp中插入数据1.3.

4、2. 交易行为需要数据源系统提供视图。视图字段参考如下描述设置。此视图提供的是最终的交易行为，不需要中间过程的交易行为。名称字段名类型长度是否为空描述数据来源SourceVARCHAR255否取自分类：数据来源会员IDMemberIDVARCHAR255否行为开始时间StartTimeTIMESTAMP行为结束时间EndTimeTIMESTAMP可以与开始时间填写一样的内容行为类型TypeVARCHAR255否枚举型。购物、充值、订购、评论、分享、注册、完善个人信息、签到订单号OrderNoVARCHAR255发票号InvoiceNoVARCHAR255商品类别ProductionTypeVA

5、RCHAR255枚举型房产、汽车、理财、奢侈品、医疗、教育、美食、食品、便民服务、报刊、家居、艺术品、数码、女装、户外、化妆品、珠宝、厨具、男装、女鞋、男鞋、箱包、零食、建材、图书音像、玩具、进口商品、酒水、手机配件、眼镜、办公、母婴、保健品商品名称ItemNameVARCHAR255品牌关键字BrandKeyVARCHAR255主要用来记录品牌关键字商品数量ItemCountINTEGER6单价UnitPriceFLOAT10,2总价TotalPriceFLOAT10,2折扣DiscountFLOAT3,2配送地址DeliveryAddressVARCHAR255联系人ContactVARC

6、HAR100联系电话ContactPhoneVARCHAR30活动标识ActivityIDINTEGER10根据活动标识，线下活动信息可以在活动管理模块查至IJ,包括活动名称，描述，时间和地点渠道（部门）OrgVARCHAR100交易行为数据的采集来源数据专员标识ZhuanYuanIDINTEGER10在于后台记录人员操作，多用于线下数据操作注：对于一笔订单含多种商品，需要把该订单拆成多个，每种商品一条。它们的订单号，发票号一致。1.3.3. 非交易行为需要数据源系统提供视图。视图字段参考如下描述设置。此视图提供的是最终的交易行为，不需要中间过程的交易行为。名称字段名类型长度是否为空描述数据来

7、源SourceVARCHAR255否枚举型。新闻网站、易购网站、分类网站、评论系统、app系统、广告、发行、呼叫中心来源描述SourceNoteVARCHAR255主要在于注释行为会员IDMemberlDvarchar255否行为开始时间StartTimeTIMESTAMP否行为结束时间EndTimeTIMESTAMP可以与开始时间填写一样的内容文章类别ArticleTypeVARCHAR255记录阅读行为中的分类，枚举型时政、国际、国内、图片、访谈、视频、娱乐、财经、社会、体育、特稿、民生、房产、二手房、家居、理财、健康、美食、购物、数码、时尚、旅游、汽车、便民服务、现代画报、KAN南京、法

8、律、创富、苏州、无锡、常州、镇江、扬州、泰州、南通、盐城、淮安、宿迁、徐州、连云港、南京、上海、安徽、浙?X活动标识ActivitylDINTEGER10根据活动标识，线下活动信息可以在活动管理模块查到，包括活动名称，描述，时间和地点行为类型TypeVARCHAR255否枚举型。登录、爆料、投诉反馈行为发生位置PositionVARCHAR255枚举型。网站、快报云媒、快报易购、线下活动、呼叫中心、发行、展会、微信关键词KeyWordVARCHAR2551.4. API接口规范1.4.1. 添加或修改非交易类行为描述添加或修改非交易类行为urlPOST:<webroot>/api/

9、event/event?source=&oriID=&info=&member=参数source数据来源，如“网站”orilD在数据来源系统中的IDtc租户代号（可选的）table在数据来源系统中的行为表名（可选的）info行为数据，json格式，每个key与行为类型的子段名（ColumnCode）。如：eStartTime:"2014/10/1210:00:00",eType:"登录"member源系统中的会员ID（修改时不需要）输出成功入库时为null,否则返回错误描述1.4.2. 添加或修改交易类行为描述添加或修改交易类行为

10、urlPOST:<webroot>/api/event/trading?source=&oriID=&info=参数source数据来源，如“网站”oriID在数据来源系统中的IDtc租户代号（可选的）table在数据来源系统中的行为表名（可选的）info行为数据，json格式，每个key与行为类型的子段名（ColumnCode）如：eStartTime:"2014/10/1210:00:00",eType:"充值",eTotalPrice:"200.00”member源系统中的会员ID（修改时不需要）故，输出成功入

11、库时为null,否则返回错误描述二、集成百宝箱2.1. API接口概要概要条目说明会员的当前积分在白宝库查看会员当前积分时调用。会员的积分记录在白宝库查看会员的积分记录时调用。会员兑换行为入库会员在白宝库兑换礼品成功后调用该接口，将会员兑换记录写入全媒体会员中心2.2. API接口规范2.2.1. 会员的当前积分描述会员的当前积分urlGET:<webroot>/api/member/score?source=&id=参数source数据来源，如“网站”id在数据来源系统中的IDtc租户代号，可选table在数据来源系统中的会员表名，可选可选参数：tc（租户代号），tabl

12、e（源系统的会员表）输出积分值2.2.2. 会员的积分记录描述会员的积分记录urlGET:<webroot>/member/scoreList?source=&id=&getAll=&curPage=&pageSize=source数据来源，如“网站”id在数据来源系统中的IDtc租户代号，可选table在数据来源系统中的会员表名，可选getAll是否获取全部记录0-否，1-是curPage当前页从0开始pageSize每页的条数可选参数：tc（租户代号），table（源系统的会员表）输出失败：null成功：xml格式字符串，格式说明如下<?x

13、mlversion="1.0"encoding="UTF-8"?><DocList><!-会员记录总条数-><TotalSum>2</TotalSum><DocItem><!-会员积分记录LibId-><DocLibID>4</DocLibID><!-会员积分记录Id-><DocID>23</DocID><!-会员积分记录排序号-><DocOrder>1</DocOrder><

14、!-添加人-><SYS_AUTHORS>系统</SYS_AUTHORS><!-会员姓名-><msMember>天然大脸蛋儿</msMember><!-会员Id-><msMember_ID>1</msMember_ID><!-创建类型0:系统产生1:积分手工添加2:积分手工扣减，此时是负分3:积分兑换，此时是负分-><msType>3</msType><!-行为描述-><msEvent分兑换</msEvent><!-对应行为

15、ID-><msEventID/><!-行为类型-><msEventTypd><!-行为类型ID-><msEventTypeID/><!-行为时间-><msTime>2014-10-1210:00:00</msTime>< !-积分规则-><msRule/>< !-积分规则D->< msRule_ID/>< !-积屈类型-><msRuleType><!-数据来源-><msSource>网站</m

16、sSource>< !-数据来源ID-><msSource_ID>32</msSource_ID>< !-是否交易型1:是，0:否->< msIsTrading>1</msIsTrading>< !-审批状态0:待审批，1:已批准，2:已撤销->< msIsApproved>1</msIsApproved>< !-积分值-><msScore>-2000</msScore>< !-经验值-><msExperience/>&l

17、t; !-说明->< msMemo>兑换鲁花花生油10斤装一桶</msMemo></DocItem></DocList>2.2.3. 会员的兑换行为入库描述会员的兑换行为入库urlPOST:<webroot>/api/event/convert?source=&member=&info=.参数source数据来源，如“网站”tc租户代号(可选的)member源系统中的会员IDinfo兑换数据，json格式，每个key与会员积分典型的子段名(ColumnCode)-Bo如：msTime:"2014/10/

18、1210:00:00",msMemo:"兑换鲁花花生油10斤装一桶”,msScore:"2000"输出成功：null失败：相关错误提示，例如"保存兑换记录时异常："2.2.4. 获取行为类型描述获取行为类型urlGet:<webroot>/api/event/eventTypes参数tc租户代号，可选可选参数：tc（租户代号）输出登录，购物，充值，订购，爆料，评论,分享,注册,完善个人信息，活动签到，发布信息，活动报名，激活报卡2.2.5. 获取积分规则列表描述状取积分规则列表urlGET:<webroot>/

19、api/event/scoreRuleList?source=参数source数据来源，如“网站”tc租户代号，可选可选参数：tc（租户代号）输出失败：null成功：xml格式字符串，格式说明如下<?xmlversion="1.0"encoding="UTF-8"?><DocList><TotalSum>2</TotalSum><DocItem><!-积分规则LibID-><DocLibID>11</DocLibID><!-积分规则ID-><

20、DocIA1</DocID><!-排序号-><DocOrder>1</DocOrder><!-规则名称-><srName>每日登录</srName><!-规则类型：1=类型一（每日前几次行为奖励），29型二（每日累计次数后奖励），3=类型三（每次行为奖励），44型四（连续几天完成后奖励），5=类型五（一次性奖励），6寸型六（按金额比例返利）-><srType>1</srType><!-规则描述-><srMemo>用户每天第一次登录现代快报网将获得5快币

21、的奖励</srMemo><!-开始时间-><srStartTimU><!-结束时间-><srEndTimd><!-应用平台-><srSource>Jff闻网站</srSource><!-应用平台D-><srSource_ID>17</srSource_ID><!-行为类型->vsrEventType*登录</srEventType*<!-行为类型D-><srEventType_I!>29</srEventType_I

22、><!-规则限制薮字->一<srLimit>1</srLimit><!-积分奖励-><srScore>5</srScore><!-经验值奖励-><srExperience>10</srExperience><!-状态-><srStatus>1</srStatus></DocItem><DocItem><DocLibID>11</DocLibID><DocID>2</DocID><DocOrder>2</DocOrder><srName日登录</srName><srType>4</srType><srMemo>用户连续7天登录现代快报网将获得20快币的奖励</srMemo><srStartTimU><srEndT