全媒體會(huì)員中心集成說(shuō)明書(shū)1118

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

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

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

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

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

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

7、段名類(lèi)型長(zhǎng)度是否為空描述數(shù)據(jù)來(lái)源SourceVARCHAR255否枚舉型。新聞網(wǎng)站、易購(gòu)網(wǎng)站、分類(lèi)網(wǎng)站、評(píng)論系統(tǒng)、app系統(tǒng)、廣告、發(fā)行、呼叫中心來(lái)源描述SourceNoteVARCHAR255主要在于注釋行為會(huì)員IDMemberIDvarchar255否行為開(kāi)始時(shí)間StartTimeTIMESTAMP否行為結(jié)束時(shí)間EndTimeTIMESTAMP可以與開(kāi)始時(shí)間填寫(xiě)一樣的內(nèi)容文章類(lèi)別ArticleTypeVARCHAR255記錄閱讀行為中的分類(lèi)，枚舉型時(shí)政、國(guó)際、國(guó)內(nèi)、圖片、訪談、視頻、娛樂(lè)、財(cái)經(jīng)、社會(huì)、體育、特稿、民生、房產(chǎn)、二手房、家居、理財(cái)、健康、美食、購(gòu)物、數(shù)碼、時(shí)尚、旅游、汽車(chē)、便民

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

9、<webroot>/api/event/event?source=&oriID=&info=&member=參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”oriID 在數(shù)據(jù)來(lái)源系統(tǒng)中的IDtc 租戶代號(hào)（可選的）table 在數(shù)據(jù)來(lái)源系統(tǒng)中的行為表名（可選的）info 行為數(shù)據(jù)，json格式，每個(gè)key與行為類(lèi)型的字段名（ColumnCode）一致。如：eStartTime:"2014/10/12 10:00:00",eType:"登錄"member 源系統(tǒng)中的會(huì)員ID（修改時(shí)不需要）輸出成功入庫(kù)時(shí)為null，否則返回錯(cuò)誤描述

10、1.4.2. 添加或修改交易類(lèi)行為描述添加或修改交易類(lèi)行為urlPOST: <webroot>/api/event/trading?source=&oriID=&info=參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”oriID 在數(shù)據(jù)來(lái)源系統(tǒng)中的IDtc 租戶代號(hào)（可選的）table 在數(shù)據(jù)來(lái)源系統(tǒng)中的行為表名（可選的）info 行為數(shù)據(jù)，json格式，每個(gè)key與行為類(lèi)型的字段名（ColumnCode）一致，如：eStartTime:"2014/10/12 10:00:00",eType:"充值",eTotalPrice:&quo

11、t;200.00"member 源系統(tǒng)中的會(huì)員ID（修改時(shí)不需要）輸出成功入庫(kù)時(shí)為null，否則返回錯(cuò)誤描述二、 集成百寶箱2.2.1. API接口概要概要條目說(shuō)明會(huì)員的當(dāng)前積分在百寶庫(kù)查看會(huì)員當(dāng)前積分時(shí)調(diào)用。會(huì)員的積分記錄在百寶庫(kù)查看會(huì)員的積分記錄時(shí)調(diào)用。會(huì)員兌換行為入庫(kù)會(huì)員在百寶庫(kù)兌換禮品成功后調(diào)用該接口，將會(huì)員兌換記錄寫(xiě)入全媒體會(huì)員中心2.2. API接口規(guī)范2.2.1.2.2.2.2.1. 會(huì)員的當(dāng)前積分描述會(huì)員的當(dāng)前積分urlGET: <webroot>/api/member/score?source=&id=參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”id

12、在數(shù)據(jù)來(lái)源系統(tǒng)中的IDtc 租戶代號(hào)，可選table 在數(shù)據(jù)來(lái)源系統(tǒng)中的會(huì)員表名，可選可選參數(shù)：tc（租戶代號(hào)），table（源系統(tǒng)的會(huì)員表）輸出積分值2.2.2. 會(huì)員的積分記錄描述會(huì)員的積分記錄urlGET: <webroot>/member/scoreList?source=&id=&getAll=&curPage=&pageSize=參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”id 在數(shù)據(jù)來(lái)源系統(tǒng)中的IDtc 租戶代號(hào)，可選table 在數(shù)據(jù)來(lái)源系統(tǒng)中的會(huì)員表名，可選getAll是否獲取全部記錄 0-否，1-是curPage 當(dāng)前頁(yè),從0開(kāi)始pag

13、eSize 每頁(yè)的條數(shù)可選參數(shù)：tc（租戶代號(hào)），table（源系統(tǒng)的會(huì)員表）輸出失?。簄ull成功：xml格式字符串，格式說(shuō)明如下<?xml version="1.0" encoding="UTF-8"?><DocList>       <!- 會(huì)員記錄總條數(shù) ->       <TotalSum>2</TotalSum>    

14、60;  <DocItem>              <!- 會(huì)員積分記錄LibId ->              <DocLibID>4</DocLibID>          

15、;    <!- 會(huì)員積分記錄Id ->              <DocID>23</DocID>              <!- 會(huì)員積分記錄排序號(hào) ->        &#

16、160;     <DocOrder>1</DocOrder>              <!- 添加人 ->              <SYS_AUTHORS>系統(tǒng)</SYS_AUTHORS>   

17、0;          <!- 會(huì)員姓名 ->              <msMember>天然大臉蛋兒</msMember>              <!- 會(huì)員Id ->  

18、            <msMember_ID>1</msMember_ID>              <!- 創(chuàng)建類(lèi)型              0：系統(tǒng)產(chǎn)生   

19、           1：積分手工添加              2：積分手工扣減，此時(shí)是負(fù)分              3：積分兌換，此時(shí)是負(fù)分        

20、0;      ->              <msType>3</msType>              <!- 行為描述 ->         

21、60;    <msEvent>積分兌換</msEvent>              <!- 對(duì)應(yīng)行為ID ->              <msEventID/>        

22、      <!- 行為類(lèi)型 ->              <msEventType/>              <!- 行為類(lèi)型ID ->         &

23、#160;    <msEventType_ID/>              <!- 行為時(shí)間 ->              <msTime>2014-10-12 10:00:00</msTime>     

24、         <!- 積分規(guī)則 ->              <msRule/>              <!- 積分規(guī)則_ID ->       

25、;       <msRule_ID/>              <!- 積分規(guī)則類(lèi)型 ->              <msRuleType/>         

26、;     <!- 數(shù)據(jù)來(lái)源 ->              <msSource>網(wǎng)站</msSource>              <!- 數(shù)據(jù)來(lái)源ID ->       

27、60;      <msSource_ID>32</msSource_ID>              <!- 是否交易型 1：是，0：否 ->              <msIsTrading>1</msIsTrading>&

28、#160;             <!- 審批狀態(tài) 0：待審批，1：已批準(zhǔn)，2：已撤銷(xiāo) ->              <msIsApproved>1</msIsApproved>           

29、   <!- 積分值 ->              <msScore>-2000</msScore>              <!- 經(jīng)驗(yàn)值 ->          &

30、#160;   <msExperience/>              <!- 說(shuō)明 ->              <msMemo>兌換魯花花生油10斤裝一桶</msMemo>       </DocI

31、tem></DocList>2.2.3. 會(huì)員的兌換行為入庫(kù)描述會(huì)員的兌換行為入庫(kù)urlPOST: <webroot>/api/event/convert?source=&member=&info=.參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”tc 租戶代號(hào)（可選的）member 源系統(tǒng)中的會(huì)員IDinfo 兌換數(shù)據(jù)，json格式，每個(gè)key與會(huì)員積分類(lèi)型的字段名（ColumnCode）一致。如：msTime:"2014/10/12 10:00:00",msMemo:"兌換魯花花生油10斤裝一桶",msScore:

32、"2000"輸出成功：null失?。合嚓P(guān)錯(cuò)誤提示，例如"保存兌換記錄時(shí)異常："2.2.4. 獲取行為類(lèi)型描述獲取行為類(lèi)型urlGet: <webroot>/api/event/eventTypes參數(shù)tc 租戶代號(hào)，可選可選參數(shù)：tc（租戶代號(hào)）輸出登錄,購(gòu)物,充值,訂購(gòu),爆料,評(píng)論,分享,注冊(cè),完善個(gè)人信息,活動(dòng)簽到,發(fā)布信息,活動(dòng)報(bào)名,激活報(bào)卡2.2.5. 獲取積分規(guī)則列表描述獲取積分規(guī)則列表urlGET: <webroot>/api/event/scoreRuleList?source=參數(shù)source 數(shù)據(jù)來(lái)源，如“網(wǎng)站”

33、tc 租戶代號(hào)，可選可選參數(shù)：tc（租戶代號(hào)）輸出失敗：null成功：xml格式字符串，格式說(shuō)明如下<?xml version="1.0" encoding="UTF-8"?><DocList>       <TotalSum>2</TotalSum>       <DocItem>        

34、      <!- 積分規(guī)則LibID ->              <DocLibID>11</DocLibID>              <!- 積分規(guī)則ID ->      

35、;        <DocID>1</DocID>              <!- 排序號(hào) ->              <DocOrder>1</DocOrder>   &#

36、160;          <!- 規(guī)則名稱(chēng) ->              <srName>每日登錄</srName>              <!- 規(guī)則類(lèi)型：1=類(lèi)型一（每日前幾次行為獎(jiǎng)勵(lì)）,2=類(lèi)型

37、二（每日累計(jì)次數(shù)后獎(jiǎng)勵(lì)）,3=類(lèi)型三（每次行為獎(jiǎng)勵(lì)）,4=類(lèi)型四（連續(xù)幾天完成后獎(jiǎng)勵(lì)）,5=類(lèi)型五（一次性獎(jiǎng)勵(lì)）,6=類(lèi)型六（按金額比例返利）->              <srType>1</srType>              <!- 規(guī)則描述 ->   &

38、#160;          <srMemo>用戶每天第一次登錄現(xiàn)代快報(bào)網(wǎng)將獲得5快幣的獎(jiǎng)勵(lì)</srMemo>              <!- 開(kāi)始時(shí)間 ->              <srStartTi

39、me/>              <!- 結(jié)束時(shí)間 ->              <srEndTime/>              <!- 應(yīng)用平臺(tái) ->

40、0;             <srSource>新聞網(wǎng)站</srSource>              <!- 應(yīng)用平臺(tái)_ID ->              <srSour

41、ce_ID>17</srSource_ID>              <!- 行為類(lèi)型 ->              <srEventType>登錄</srEventType>         

42、;     <!- 行為類(lèi)型_ID ->              <srEventType_ID>29</srEventType_ID>              <!- 規(guī)則限制數(shù)字 ->     

43、         <srLimit>1</srLimit>              <!- 積分獎(jiǎng)勵(lì) ->              <srScore>5</srScore>  

44、            <!- 經(jīng)驗(yàn)值獎(jiǎng)勵(lì) ->              <srExperience>10</srExperience>              <!- 狀態(tài) ->

45、;              <srStatus>1</srStatus>       </DocItem>       <DocItem>              <DocLibID>11</DocLibID>              <DocID>2</DocID>              <DocOrder>2</DocOrder>    &#