全媒體會員中心集成說明書

1、全媒體會員中心集成說明書一、集成會員數(shù)據(jù)源系統(tǒng)1.1. 概述全媒體會員中心內(nèi)部建有客戶資源數(shù)據(jù)庫，存儲了客戶的基礎(chǔ)數(shù)據(jù)（姓名、稱呼、生日、單位、地址、郵箱、手機(jī)、座機(jī)、QQ、微信號等），客戶的行為數(shù)據(jù)（注冊、登錄、評論、網(wǎng)上購物、線下訂購、分享、爆料、活動等）。客戶的基礎(chǔ)數(shù)據(jù)，線下客戶的行為數(shù)據(jù)是通過采集程序從各集成系統(tǒng)（即數(shù)據(jù)源系統(tǒng)）獲取。為保證獲取數(shù)據(jù)成功，各集成系統(tǒng)需要遵循數(shù)據(jù)規(guī)范做好數(shù)據(jù)準(zhǔn)備，提供相應(yīng)的接口。線上客戶的行為數(shù)據(jù)的獲取采用另外一種方式，使用全媒體會員中心提供的API,線上系統(tǒng)根據(jù)業(yè)務(wù)需要在行為發(fā)生的代碼處調(diào)用這些API。參見下表。客戶數(shù)據(jù)集成方法線上基礎(chǔ)數(shù)據(jù)系統(tǒng)接SSO實

2、現(xiàn)單點(diǎn)登錄，SSO按數(shù)據(jù)規(guī)范準(zhǔn)備視圖，采集程序從視圖采集數(shù)據(jù)線上行為數(shù)據(jù)在行為發(fā)生處調(diào)用全媒體會員中心的API線下基礎(chǔ)數(shù)據(jù)系統(tǒng)按數(shù)據(jù)規(guī)范準(zhǔn)備視圖，采集程序從視圖采集數(shù)據(jù)線下行為數(shù)據(jù)系統(tǒng)按數(shù)據(jù)規(guī)范準(zhǔn)備視圖，采集程序從視圖采集數(shù)據(jù)1.2. 數(shù)據(jù)源全媒體會員中心從客戶資源數(shù)據(jù)庫角度可以集成的系統(tǒng)比較多，簡單的講凡是涉及客戶數(shù)據(jù)的系統(tǒng)都可以集成。這些系統(tǒng)就成了全媒體會員中心的數(shù)據(jù)源。具體到現(xiàn)代快報項目，可以作為數(shù)據(jù)源的有線上的新聞網(wǎng)站、分類網(wǎng)站、易購網(wǎng)站、評論系統(tǒng)、app系統(tǒng)，線下有廣告、發(fā)行和呼叫中心/excel表等。對于線上系統(tǒng),要求先通過翔宇的SSO實現(xiàn)單點(diǎn)登錄功能，這樣全媒體會員中心直接從SS

3、O獲取客戶信息，不再通過各線上數(shù)據(jù)源。1.3. 數(shù)據(jù)規(guī)范1.3.1. 基礎(chǔ)數(shù)據(jù)1 .存量數(shù)據(jù)的數(shù)據(jù)采集。需要數(shù)據(jù)源系統(tǒng)提供視圖。視圖字段參考如excel文件會員基礎(chǔ)字段標(biāo)準(zhǔn)表說明。2 .增量數(shù)據(jù)的采集。全媒體會員中心需要在各數(shù)據(jù)源數(shù)據(jù)庫中創(chuàng)建表ucMemberTmp,用來記錄客戶基礎(chǔ)信息增刪改日志，方便同步。名稱字段名類型長度是否為空描述idIdVARCHAR255否原始數(shù)據(jù)ID標(biāo)識flagINTEGER10否0-delete1- insert2- update時間戳changetimeTIMESTAMP否自動生成數(shù)據(jù)源系統(tǒng)在客戶信息表上創(chuàng)建觸發(fā)器，以向ucMemberTmp中插入數(shù)據(jù)1.3.

4、2. 交易行為需要數(shù)據(jù)源系統(tǒng)提供視圖。視圖字段參考如下描述設(shè)置。此視圖提供的是最終的交易行為，不需要中間過程的交易行為。名稱字段名類型長度是否為空描述數(shù)據(jù)來源SourceVARCHAR255否取自分類：數(shù)據(jù)來源會員IDMemberIDVARCHAR255否行為開始時間StartTimeTIMESTAMP行為結(jié)束時間EndTimeTIMESTAMP可以與開始時間填寫一樣的內(nèi)容行為類型TypeVARCHAR255否枚舉型。購物、充值、訂購、評論、分享、注冊、完善個人信息、簽到訂單號OrderNoVARCHAR255發(fā)票號InvoiceNoVARCHAR255商品類別ProductionTypeVA

5、RCHAR255枚舉型房產(chǎn)、汽車、理財、奢侈品、醫(yī)療、教育、美食、食品、便民服務(wù)、報刊、家居、藝術(shù)品、數(shù)碼、女裝、戶外、化妝品、珠寶、廚具、男裝、女鞋、男鞋、箱包、零食、建材、圖書音像、玩具、進(jìn)口商品、酒水、手機(jī)配件、眼鏡、辦公、母嬰、保健品商品名稱ItemNameVARCHAR255品牌關(guān)鍵字BrandKeyVARCHAR255主要用來記錄品牌關(guān)鍵字商品數(shù)量ItemCountINTEGER6單價UnitPriceFLOAT10,2總價TotalPriceFLOAT10,2折扣DiscountFLOAT3,2配送地址DeliveryAddressVARCHAR255聯(lián)系人ContactVARC

6、HAR100聯(lián)系電話ContactPhoneVARCHAR30活動標(biāo)識ActivityIDINTEGER10根據(jù)活動標(biāo)識，線下活動信息可以在活動管理模塊查至IJ,包括活動名稱，描述，時間和地點(diǎn)渠道（部門）OrgVARCHAR100交易行為數(shù)據(jù)的采集來源數(shù)據(jù)專員標(biāo)識ZhuanYuanIDINTEGER10在于后臺記錄人員操作，多用于線下數(shù)據(jù)操作注：對于一筆訂單含多種商品，需要把該訂單拆成多個，每種商品一條。它們的訂單號，發(fā)票號一致。1.3.3. 非交易行為需要數(shù)據(jù)源系統(tǒng)提供視圖。視圖字段參考如下描述設(shè)置。此視圖提供的是最終的交易行為，不需要中間過程的交易行為。名稱字段名類型長度是否為空描述數(shù)據(jù)來

7、源SourceVARCHAR255否枚舉型。新聞網(wǎng)站、易購網(wǎng)站、分類網(wǎng)站、評論系統(tǒng)、app系統(tǒng)、廣告、發(fā)行、呼叫中心來源描述SourceNoteVARCHAR255主要在于注釋行為會員IDMemberlDvarchar255否行為開始時間StartTimeTIMESTAMP否行為結(jié)束時間EndTimeTIMESTAMP可以與開始時間填寫一樣的內(nèi)容文章類別ArticleTypeVARCHAR255記錄閱讀行為中的分類，枚舉型時政、國際、國內(nèi)、圖片、訪談、視頻、娛樂、財經(jīng)、社會、體育、特稿、民生、房產(chǎn)、二手房、家居、理財、健康、美食、購物、數(shù)碼、時尚、旅游、汽車、便民服務(wù)、現(xiàn)代畫報、KAN南京、法

8、律、創(chuàng)富、蘇州、無錫、常州、鎮(zhèn)江、揚(yáng)州、泰州、南通、鹽城、淮安、宿遷、徐州、連云港、南京、上海、安徽、浙?X活動標(biāo)識ActivitylDINTEGER10根據(jù)活動標(biāo)識，線下活動信息可以在活動管理模塊查到，包括活動名稱，描述，時間和地點(diǎn)行為類型TypeVARCHAR255否枚舉型。登錄、爆料、投訴反饋行為發(fā)生位置PositionVARCHAR255枚舉型。網(wǎng)站、快報云媒、快報易購、線下活動、呼叫中心、發(fā)行、展會、微信關(guān)鍵詞KeyWordVARCHAR2551.4. API接口規(guī)范1.4.1. 添加或修改非交易類行為描述添加或修改非交易類行為urlPOST:<webroot>/api/

9、event/event?source=&oriID=&info=&member=參數(shù)source數(shù)據(jù)來源，如“網(wǎng)站”orilD在數(shù)據(jù)來源系統(tǒng)中的IDtc租戶代號（可選的）table在數(shù)據(jù)來源系統(tǒng)中的行為表名（可選的）info行為數(shù)據(jù)，json格式，每個key與行為類型的子段名（ColumnCode）。如：eStartTime:"2014/10/1210:00:00",eType:"登錄"member源系統(tǒng)中的會員ID（修改時不需要）輸出成功入庫時為null,否則返回錯誤描述1.4.2. 添加或修改交易類行為描述添加或修改交易類行為

10、urlPOST:<webroot>/api/event/trading?source=&oriID=&info=參數(shù)source數(shù)據(jù)來源，如“網(wǎng)站”oriID在數(shù)據(jù)來源系統(tǒng)中的IDtc租戶代號（可選的）table在數(shù)據(jù)來源系統(tǒng)中的行為表名（可選的）info行為數(shù)據(jù)，json格式，每個key與行為類型的子段名（ColumnCode）如：eStartTime:"2014/10/1210:00:00",eType:"充值",eTotalPrice:"200.00”member源系統(tǒng)中的會員ID（修改時不需要）故，輸出成功入

11、庫時為null,否則返回錯誤描述二、集成百寶箱2.1. API接口概要概要條目說明會員的當(dāng)前積分在白寶庫查看會員當(dāng)前積分時調(diào)用。會員的積分記錄在白寶庫查看會員的積分記錄時調(diào)用。會員兌換行為入庫會員在白寶庫兌換禮品成功后調(diào)用該接口，將會員兌換記錄寫入全媒體會員中心2.2. API接口規(guī)范2.2.1. 會員的當(dāng)前積分描述會員的當(dāng)前積分urlGET:<webroot>/api/member/score?source=&id=參數(shù)source數(shù)據(jù)來源，如“網(wǎng)站”id在數(shù)據(jù)來源系統(tǒng)中的IDtc租戶代號，可選table在數(shù)據(jù)來源系統(tǒng)中的會員表名，可選可選參數(shù)：tc（租戶代號），tabl

12、e（源系統(tǒng)的會員表）輸出積分值2.2.2. 會員的積分記錄描述會員的積分記錄urlGET:<webroot>/member/scoreList?source=&id=&getAll=&curPage=&pageSize=source數(shù)據(jù)來源，如“網(wǎng)站”id在數(shù)據(jù)來源系統(tǒng)中的IDtc租戶代號，可選table在數(shù)據(jù)來源系統(tǒng)中的會員表名，可選getAll是否獲取全部記錄0-否，1-是curPage當(dāng)前頁從0開始pageSize每頁的條數(shù)可選參數(shù)：tc（租戶代號），table（源系統(tǒng)的會員表）輸出失?。簄ull成功：xml格式字符串，格式說明如下<?x

13、mlversion="1.0"encoding="UTF-8"?><DocList><!-會員記錄總條數(shù)-><TotalSum>2</TotalSum><DocItem><!-會員積分記錄LibId-><DocLibID>4</DocLibID><!-會員積分記錄Id-><DocID>23</DocID><!-會員積分記錄排序號-><DocOrder>1</DocOrder><

14、!-添加人-><SYS_AUTHORS>系統(tǒng)</SYS_AUTHORS><!-會員姓名-><msMember>天然大臉蛋兒</msMember><!-會員Id-><msMember_ID>1</msMember_ID><!-創(chuàng)建類型0:系統(tǒng)產(chǎn)生1:積分手工添加2:積分手工扣減，此時是負(fù)分3:積分兌換，此時是負(fù)分-><msType>3</msType><!-行為描述-><msEvent分兌換</msEvent><!-對應(yīng)行為

15、ID-><msEventID/><!-行為類型-><msEventTypd><!-行為類型ID-><msEventTypeID/><!-行為時間-><msTime>2014-10-1210:00:00</msTime>< !-積分規(guī)則-><msRule/>< !-積分規(guī)則D->< msRule_ID/>< !-積屈類型-><msRuleType><!-數(shù)據(jù)來源-><msSource>網(wǎng)站</m

16、sSource>< !-數(shù)據(jù)來源ID-><msSource_ID>32</msSource_ID>< !-是否交易型1:是，0:否->< msIsTrading>1</msIsTrading>< !-審批狀態(tài)0:待審批，1:已批準(zhǔn)，2:已撤銷->< msIsApproved>1</msIsApproved>< !-積分值-><msScore>-2000</msScore>< !-經(jīng)驗值-><msExperience/>&l

17、t; !-說明->< msMemo>兌換魯花花生油10斤裝一桶</msMemo></DocItem></DocList>2.2.3. 會員的兌換行為入庫描述會員的兌換行為入庫urlPOST:<webroot>/api/event/convert?source=&member=&info=.參數(shù)source數(shù)據(jù)來源，如“網(wǎng)站”tc租戶代號(可選的)member源系統(tǒng)中的會員IDinfo兌換數(shù)據(jù)，json格式，每個key與會員積分典型的子段名(ColumnCode)-Bo如：msTime:"2014/10/

18、1210:00:00",msMemo:"兌換魯花花生油10斤裝一桶”,msScore:"2000"輸出成功：null失?。合嚓P(guān)錯誤提示，例如"保存兌換記錄時異常："2.2.4. 獲取行為類型描述獲取行為類型urlGet:<webroot>/api/event/eventTypes參數(shù)tc租戶代號，可選可選參數(shù)：tc（租戶代號）輸出登錄，購物，充值，訂購，爆料，評論,分享,注冊,完善個人信息，活動簽到，發(fā)布信息，活動報名，激活報卡2.2.5. 獲取積分規(guī)則列表描述狀取積分規(guī)則列表urlGET:<webroot>/

19、api/event/scoreRuleList?source=參數(shù)source數(shù)據(jù)來源，如“網(wǎng)站”tc租戶代號，可選可選參數(shù)：tc（租戶代號）輸出失?。簄ull成功：xml格式字符串，格式說明如下<?xmlversion="1.0"encoding="UTF-8"?><DocList><TotalSum>2</TotalSum><DocItem><!-積分規(guī)則LibID-><DocLibID>11</DocLibID><!-積分規(guī)則ID-><

20、DocIA1</DocID><!-排序號-><DocOrder>1</DocOrder><!-規(guī)則名稱-><srName>每日登錄</srName><!-規(guī)則類型：1=類型一（每日前幾次行為獎勵），29型二（每日累計次數(shù)后獎勵），3=類型三（每次行為獎勵），44型四（連續(xù)幾天完成后獎勵），5=類型五（一次性獎勵），6寸型六（按金額比例返利）-><srType>1</srType><!-規(guī)則描述-><srMemo>用戶每天第一次登錄現(xiàn)代快報網(wǎng)將獲得5快幣

21、的獎勵</srMemo><!-開始時間-><srStartTimU><!-結(jié)束時間-><srEndTimd><!-應(yīng)用平臺-><srSource>Jff聞網(wǎng)站</srSource><!-應(yīng)用平臺D-><srSource_ID>17</srSource_ID><!-行為類型->vsrEventType*登錄</srEventType*<!-行為類型D-><srEventType_I!>29</srEventType_I

22、><!-規(guī)則限制藪字->一<srLimit>1</srLimit><!-積分獎勵-><srScore>5</srScore><!-經(jīng)驗值獎勵-><srExperience>10</srExperience><!-狀態(tài)-><srStatus>1</srStatus></DocItem><DocItem><DocLibID>11</DocLibID><DocID>2</DocID><DocOrder>2</DocOrder><srName日登錄</srName><srType>4</srType><srMemo>用戶連續(xù)7天登錄現(xiàn)代快報網(wǎng)將獲得20快幣的獎勵</srMemo><srStartTimU><srEndT