本文筆者將從需求目的、需求描述、數(shù)據(jù)需求分析等方面來推出省唄撞庫(kù)聯(lián)登渠道的需求文檔，enjoy~

一、需求目的

1. 需求背景

為配合新產(chǎn)品****的推廣，新增省唄撞庫(kù)聯(lián)登渠道。因?yàn)闃I(yè)務(wù)同事市場(chǎng)推廣策略會(huì)有較頻繁的變更，所以需要修改拉新撞庫(kù)規(guī)則，其中主要包括新增撞庫(kù)準(zhǔn)入條件的配置化需求。

2. 上線聯(lián)登效果預(yù)估

引流動(dòng)用用戶量：日均***，動(dòng)用成本：***（聯(lián)登合作是對(duì)方上線必要條件）。

二、需求描述

1. 整體流程圖

2. 撞庫(kù)準(zhǔn)入流程

1）省唄發(fā)起用戶信息校驗(yàn)

用戶點(diǎn)擊****的省唄廣告進(jìn)行申請(qǐng)，省唄向市場(chǎng)推廣系統(tǒng)發(fā)起用戶信息校驗(yàn)請(qǐng)求，校驗(yàn)接口傳遞MD5后的手機(jī)號(hào)，并附帶簽名，簽名規(guī)則詳見省唄聯(lián)合注冊(cè)接口文檔v1.4的【5.】。

2）判斷用戶類型

市場(chǎng)推廣收到校驗(yàn)請(qǐng)求后進(jìn)入撞庫(kù)準(zhǔn)入流程，根據(jù)傳入的MD5手機(jī)號(hào)，查詢?cè)撚脩羰欠裨?**動(dòng)用過：未動(dòng)用過的話撞庫(kù)準(zhǔn)入通過（默認(rèn)未動(dòng)用過的用戶撞庫(kù)準(zhǔn)入通過，可更改配置為不通過），動(dòng)用過的話進(jìn)入用戶風(fēng)控等級(jí)驗(yàn)證流程。

3）用戶風(fēng)控等級(jí)驗(yàn)證

若用戶的風(fēng)控等級(jí)為A、B、C、D、E、Z，則驗(yàn)證結(jié)果為通過（默認(rèn)全部風(fēng)控等級(jí)的用戶結(jié)果都為通過，可單獨(dú)更改每一種風(fēng)控等級(jí)的用戶配置為不通過）；若用戶的風(fēng)控等級(jí)為空或獲取失敗，則驗(yàn)證結(jié)果為通過。

4）配置需求

***未動(dòng)用過的用戶準(zhǔn)入結(jié)果可配置：在***未動(dòng)用過的用戶撞庫(kù)準(zhǔn)入結(jié)果可配置為通過或不通過（默認(rèn)通過）。

用戶風(fēng)控等級(jí)驗(yàn)證結(jié)果可配置：在***動(dòng)用過的用戶，每一級(jí)的用戶風(fēng)控等級(jí)的撞庫(kù)準(zhǔn)入結(jié)果都可單獨(dú)配置為通過或不通過（默認(rèn)通過），如下表：

5）撞庫(kù)準(zhǔn)入結(jié)果

撞庫(kù)準(zhǔn)入不通過：市場(chǎng)推廣的校驗(yàn)接口回值如下表：

撞庫(kù)準(zhǔn)入通過：市場(chǎng)推廣進(jìn)入撞庫(kù)處理流程。

3. 撞庫(kù)處理流程

1）動(dòng)用過****的用戶判斷

用戶信息通過撞庫(kù)準(zhǔn)入后，市場(chǎng)推廣會(huì)進(jìn)行撞庫(kù)處理，查詢判斷用戶是否在****動(dòng)用過。如果從未動(dòng)用過，則進(jìn)入風(fēng)控4個(gè)黑名單庫(kù)驗(yàn)證流程；如果動(dòng)用過，則進(jìn)一步判斷該用戶上一次在****結(jié)清的時(shí)間。

2）用戶上一次結(jié)清時(shí)間判斷

如果距離用戶上一次在****結(jié)清的時(shí)間不超過30天(天數(shù)可配置)或尚未結(jié)清，則市場(chǎng)推廣得到撞庫(kù)結(jié)果為老用戶；如果距離用戶上一次結(jié)清超過了30天(天數(shù)可配置)，則同樣進(jìn)入風(fēng)控4個(gè)黑名單庫(kù)驗(yàn)證流程。

3）風(fēng)控4個(gè)黑名單庫(kù)驗(yàn)證

進(jìn)入黑名單庫(kù)驗(yàn)證流程的用戶包括：從未在****動(dòng)用過的用戶和上一次在****結(jié)清的時(shí)間超過30天(天數(shù)可配置)的用戶。市場(chǎng)推廣調(diào)用風(fēng)控接口判斷是否命中風(fēng)控4個(gè)黑名單，若有任何1個(gè)命中，則市場(chǎng)推廣得到撞庫(kù)結(jié)果為不通過；若未命中任何1個(gè)名單庫(kù)，則市場(chǎng)推廣得到撞庫(kù)結(jié)果為新用戶、進(jìn)入聯(lián)合注冊(cè)流程。

4）市場(chǎng)推廣校驗(yàn)接口回值

撞庫(kù)結(jié)果為老用戶，接口回值如下表：

撞庫(kù)結(jié)果為不通過，接口回值如下表：

撞庫(kù)結(jié)果為新用戶，接口回值如下表：

4. 聯(lián)合注冊(cè)流程

1）省唄發(fā)起聯(lián)合注冊(cè)請(qǐng)求

用戶在省唄點(diǎn)擊廣告位發(fā)起注冊(cè)申請(qǐng)后，經(jīng)過市場(chǎng)推廣校驗(yàn)接口判斷，如果該用戶不是****的老用戶（即回值code不為1），省唄就會(huì)立即調(diào)用注冊(cè)接口，向市場(chǎng)推廣發(fā)起聯(lián)合注冊(cè)請(qǐng)求。

注冊(cè)接口發(fā)送加密后的用戶數(shù)據(jù)，并附帶簽名。加密規(guī)則及簽名規(guī)則詳見省唄聯(lián)合注冊(cè)接口文檔v1.4的【4.】及【5.】。

接口參數(shù)定義如下表：

2）判斷用戶是否已注冊(cè)

市場(chǎng)推廣收到注冊(cè)請(qǐng)求后，調(diào)用會(huì)員中心接口查詢用戶在****是否已注冊(cè)，若已注冊(cè)，則返回“已注冊(cè)”（注冊(cè)接口code返回1）。

若未在****注冊(cè)，則調(diào)用會(huì)員中心接口進(jìn)行注冊(cè)，注冊(cè)成功返回“注冊(cè)成功”（注冊(cè)接口code返回0），若注冊(cè)失敗則返回“注冊(cè)失敗”（注冊(cè)接口返回2）。

3）市場(chǎng)推廣注冊(cè)接口回值

已注冊(cè)：

新用戶注冊(cè)成功：

新用戶注冊(cè)失?。?/p>

跳轉(zhuǎn)URL說明省唄接收到市場(chǎng)推廣返回的注冊(cè)結(jié)果，跳轉(zhuǎn)到對(duì)應(yīng)的下載URL地址，標(biāo)志著整個(gè)流程撞庫(kù)聯(lián)登流程的結(jié)束。

通過省唄聯(lián)合注冊(cè)渠道注冊(cè)的用戶，用戶再次點(diǎn)擊時(shí)，不會(huì)再調(diào)用****撞庫(kù)注冊(cè)接口，而向用戶直接展示****提供的老用戶落地頁URL1。

三、數(shù)據(jù)需求

1. 撞庫(kù)聯(lián)登數(shù)據(jù)表頭

• 渠道號(hào)
• 產(chǎn)品ID
• 明文手機(jī)號(hào)
• MD5手機(jī)號(hào)
• 撞庫(kù)結(jié)果碼
• 撞庫(kù)結(jié)果說明
• 撞庫(kù)返回時(shí)間戳
• 注冊(cè)結(jié)果碼
• 注冊(cè)結(jié)果說明
• 注冊(cè)返回時(shí)間戳

2. 撞庫(kù)結(jié)果說明

• 撞庫(kù)準(zhǔn)入不通過，用戶在***未動(dòng)用；
• 撞庫(kù)準(zhǔn)入不通過，用戶的風(fēng)控等級(jí)為“X”被拒絕；
• 撞庫(kù)處理不通過，撞庫(kù)結(jié)果為老用戶；
• 撞庫(kù)處理不通過，未動(dòng)用的用戶命中了風(fēng)控黑名單；
• 撞庫(kù)處理不通過，已動(dòng)用的沉默被喚醒用戶命中了風(fēng)控黑名單；
• 撞庫(kù)處理通過，未動(dòng)用的用戶未命中風(fēng)控黑名單；
• 撞庫(kù)處理通過，已動(dòng)用的沉默被喚醒用戶未命中風(fēng)控黑名單。

3. 注冊(cè)結(jié)果說明

• 老用戶不可注冊(cè)
• 注冊(cè)成功
• 注冊(cè)失敗

4. 補(bǔ)充

出于節(jié)省資源考慮，市場(chǎng)推廣只記錄最近2周的撞庫(kù)聯(lián)登數(shù)據(jù)，超過2周的數(shù)據(jù)定期刪除。

四、其他說明

1. 風(fēng)控、會(huì)員中心接口調(diào)用失敗需重新發(fā)出請(qǐng)求，連續(xù)3次失敗報(bào)警通知到相關(guān)責(zé)任人（開發(fā)，測(cè)試，產(chǎn)品，運(yùn)營(yíng)）。
2. 調(diào)用風(fēng)控接口查詢用戶的風(fēng)控等級(jí)，每天的調(diào)用上限為4萬人，預(yù)估后期要支持每天40萬撞庫(kù)查詢量。
3. 測(cè)試密鑰用**********，與省唄測(cè)試聯(lián)調(diào)過程中需要提供校驗(yàn)接口url，注冊(cè)接口url。
4. 產(chǎn)品會(huì)提供郵箱給省唄接收線上密鑰，上生產(chǎn)時(shí)會(huì)提供密鑰給開發(fā)測(cè)試，同時(shí)需要準(zhǔn)備好線上校驗(yàn)接口url，注冊(cè)接口url，下載url（新、老用戶）。
5. 接口約定、加密、簽名、接口詳細(xì)定義詳見附件《省唄聯(lián)合注冊(cè)接口文檔v1.4》。

本文由 @魚缸外的魚 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可，禁止轉(zhuǎn)載

題圖來自 Unsplash ，基于 CC0 協(xié)議