中国联通通信管家统计分析数据接口协议.docx
- 文档编号:5424217
- 上传时间:2022-12-16
- 格式:DOCX
- 页数:18
- 大小:37.83KB
中国联通通信管家统计分析数据接口协议.docx
《中国联通通信管家统计分析数据接口协议.docx》由会员分享,可在线阅读,更多相关《中国联通通信管家统计分析数据接口协议.docx(18页珍藏版)》请在冰豆网上搜索。
中国联通通信管家统计分析数据接口协议
中国联通通信管家
统计分析数据接口协议
中国联通
2011.2
目录
1业务分析1
1.1背景描述1
1.2缩略词1
1.3接口概况1
2统计分析数据接口2
2.1WO家庭业务用户数(月度)文件接口2
2.1.1交互流程2
2.1.2文件传输服务器及文件目录2
2.1.3文件命名3
2.1.4文件格式约束3
2.1.5文件头描述3
2.1.6文件体描述3
2.2业务细分功能用户数(月度)文件接口4
2.2.1交互流程4
2.2.2文件传输服务器及文件目录5
2.2.3文件命名5
2.2.4文件格式约束5
2.2.5文件头描述5
2.2.6文件体描述5
2.3WO家庭业务用户数(天)文件接口6
2.3.1交互流程6
2.3.2文件传输服务器及文件目录7
2.3.3文件命名7
2.3.4文件格式约束7
2.3.5文件头描述8
2.3.6文件体描述8
2.4业务细分功能用户数(天)文件接口8
2.4.1交互流程8
2.4.2文件传输服务器及文件目录9
2.4.3文件命名9
2.4.4文件格式约束10
2.4.5文件头描述10
2.4.6文件体描述10
2.5业务使用数据(天)文件接口10
2.5.1交互流程11
2.5.2文件传输服务器及文件目录11
2.5.3文件命名11
2.5.4文件格式约束12
2.5.5文件头描述12
2.5.6文件体描述12
2.6业务收入数据(月度)文件接口13
2.6.1交互流程13
2.6.2文件传输服务器及文件目录14
2.6.3文件命名14
2.6.4文件格式约束14
2.6.5文件头描述14
2.6.6文件体描述14
1业务分析
1.1背景描述
面向沃家庭用户开展的家庭总机是中国联通面向家庭客户提供的信息导航通信助理类产品。
业务功能包括:
家庭号簿(管理、查询、转接)、短信代发、漏话提醒、同振。
对于以上四种业务功能,集团信息导航平台系统应根据主要付费号码(固话、2G及3G)用户对统计结果进行区分。
提供周期可配置的统计分析报表,内容主要包括:
沃家庭用户中家庭总机用户数及收入统计,使用家庭号簿用户数,转接电话和代发短信数统计,通过多种接入方式进行上传/编辑家庭号簿的用户数,并可根据不同的操作种类对业务使用频度和用户使用习惯进行分析。
1.2缩略词
1.3接口概况
业务描述:
各省分导航平台以文件方式,向集团导航平台上传统计数据,集团导航平台负责入库。
后续将作为集团进行业务统计的依据。
2统计分析数据接口
2.1WO家庭业务用户数(月度)文件接口
各省分平台以月为周期,按地市、付费号码类型维度,上传集团导航平台当前WO家庭业务用户数、活跃用户数、当月新增及当月退订用户数文件。
2.1.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.1.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.1.3文件命名
省份每月初凌晨开始沉淀上一月的数据,生成Wo家庭业务用户数(月度)文件。
文件命名规则:
MbisInsWouserMonth_省份编码_yyyymm.txt。
1、MbisInsWouserMonth,是本文件接口标识。
2、yyyymm为文件生成当天年月。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.1.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.1.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.1.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
user_kind
String
非空
付费号码类型(1.固话、2.2G、3.3G)
4
total_num
String
非空
当前WO家庭业务用户数
5
active_num
String
非空
活跃用户数
6
new_num
String
非空
当月新增数
7
cancel_num
String
非空
当月退订数
8
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.2业务细分功能用户数(月度)文件接口
各省分平台以月为周期,按地市、业务细分功能为维度,上传集团导航平台当前用户数、活跃用户数、当月新增数及当月退订用户数文件。
业务细分包括家庭号簿、同振、漏电提醒。
2.2.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.2.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.2.3文件命名
省份每月初凌晨开始沉淀上一月的数据,生成业务细分功能用户数(月度)文件。
文件命名规则:
MbisInsWouserdetailMonth_省份编码_yyyymm.txt。
1、MbisInsWouserdetailMonth,是本文件接口标识。
2、yyyymm为文件生成当天年月。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.2.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.2.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.2.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
service_kind
String
非空
业务细分类型(1.家庭号码、2.同振、3.漏话提醒)
4
total_num
String
非空
当前用户数
5
active_num
String
非空
活跃用户数
6
new_num
String
非空
当月新增数
7
cancel_num
String
非空
当月退订数
8
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.3WO家庭业务用户数(天)文件接口
各省分平台以天为周期,按地市、付费号码类型维度,上传集团导航平台当天新增、退订用户数文件。
2.3.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.3.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.3.3文件命名
省份每天凌晨开始沉淀上一天的数据,生成Wo家庭业务用户数(天)文件。
文件命名规则:
MbisInsWouserDay_省份编码_yyyymmdd.txt。
1、MbisInsWouserDay,是本文件接口标识。
2、yyyymmdd为文件生成当天年月日日期。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.3.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.3.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.3.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
user_kind
String
非空
付费号码类型(1.固话、2.2G、3.3G)
4
new_num
String
非空
当天新增数
5
cancel_num
String
非空
当天退订数
6
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.4业务细分功能用户数(天)文件接口
各省分平台以天为周期,按地市、业务细分功能为维度,上传集团导航平台当天新增、退订用户数文件。
业务细分包括家庭号簿、同振、漏电提醒。
2.4.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.4.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.4.3文件命名
省份每天初凌晨开始沉淀上一天的数据,生成业务细分功能用户数(天)文件。
文件命名规则:
MbisInsWouserdetailDay_省份编码_yyyymmdd.txt。
1、MbisInsWouserdetailDay,是本文件接口标识。
2、yyyymmdd为文件生成当天年月日日期。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.4.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.4.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.4.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
service_kind
String
非空
业务细分类型(1.家庭号码、2.同振、3.漏话提醒)
4
new_num
String
非空
当天新增数
5
cancel_num
String
非空
当天退订数
6
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.5业务使用数据(天)文件接口
各省分平台以天为周期,按地市维度,上传业务使用数据文件。
家庭号簿业务使用数据内容包括:
各渠道上传通信录条数、电话转接时长、代发短信数量、使用固话消息通知用户数以及发送条数。
漏话提醒业务使用数据内容包括:
漏话提醒短信下行条数。
2.5.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.5.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.5.3文件命名
省份每天凌晨开始沉淀上一天的数据,生成业务使用数据(天)文件。
文件命名规则:
MbisInsWoservingDay_省份编码_yyyymmdd.txt。
1、MbisInsWoservingDay,是本文件接口标识。
2、yyyymmdd为文件生成当天年月日日期。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.5.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.5.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.5.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
telebook_num
String
非空
各渠道上传通信录条数
4
phone_length
String
非空
电话转接时长
5
sms_num
String
非空
代发短信数量
6
notice_num
String
非空
使用固话消息通知用户数
7
send_num
String
非空
发送条数
8
new_num
String
非空
漏话提醒短信下行条数
9
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.6业务收入数据(月度)文件接口
各省分平台以月为周期,按地市上传集团导航平台当前WO家庭业务收入情况文件,业务收入细分到当月业务子功能维度。
2.6.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、集团FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、集团定期到前置机获取数据文件。
4、集团获取文件进行校验、入库等业务处理。
2.6.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
集团系统会定期清理过期文件,此协议中规定集团侧生成文件保留3个月。
2.6.3文件命名
省分每月初凌晨开始沉淀上一月的数据,生成Wo家庭业务收入(月度)文件。
文件命名规则:
MbisInsWoincomeMonth_省份编码_yyyymm.txt。
1、MbisInsWoincomeMonth,是本文件接口标识。
2、yyyymm为文件生成当天年月。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.6.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.6.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.6.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
prov_code
String
非空
省分编码(文件生成省分)
2
city_code
String
非空
地市编码
3
service_kind
String
非空
业务细分类型(1.家庭号码、2.同振、3.漏话提醒)
4
total_fee
String
非空
业务收入
8
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
2.
2.1
2.2
2.3
2.4
2.5
2.6
2.7注册用户上传接口
各省分平台每15分钟上传本省开户用户信息和用户订购关系,用于电话导航共享平台数据同时和鉴权使用。
2.7.1交互流程
交互流程时序图
1、省份定期沉淀数据到指定文件。
2、电话导航共享平台FTP前置机根据不同省份分配不同用户和目录,并根据不同省份数据分配到各自目录下。
3、电话导航共享平台定期到前置机获取数据文件。
4、电话导航共享平台获取文件进行校验、入库等业务处理。
2.7.2文件传输服务器及文件目录
请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
电话导航共享平台系统会定期清理过期文件,此协议中规定电话导航共享平台侧生成文件保留3个月。
2.7.3文件命名
省分每15分钟生成上一时间段的用户数据,生成文件并上传。
文件命名规则:
User_省份编码_yyyymm.txt。
1、User,是本文件接口标识。
2、yyyymm为文件生成当天年月。
3、省分编码,请参考《附件一:
省分电话导航平台数据动态更新(上行下行)接口技术规范》。
4、以上各参数间用下划线分割。
5、文件扩展名为txt。
2.7.4文件格式约束
1、文件采用GB-2312编码方式;
2、文件体参数以“|”竖线(ASCII码为0x7C)分割,可参见文件示例。
3、文件体中一行作为一条记录,各条记录之间用换行(ASCII码0x0d0x0a)符作为分隔并在文件中连续书写。
2.7.5文件头描述
该接口不约束文件头内容,文件首行即开始文件体。
2.7.6文件体描述
序号
参数名称
数据类型
约束
中文说明
1
RecordSequenceID
String
非空
流水号,格式为时间戳+序列号:
YYYYMMDDHHMMSSxxxx,其中xxxx为序列号,从0001开始,排满9999后重新循环
2
prov_code
String
非空
省分编码(文件生成省分)
3
mdn
String
非空
用户号码
4
order_status
String
非空
用户状态(0:
业务未开通1:
业务开通)
5
old_order_status
String
非空
更改前的状态
6
book_status
String
非空
号簿状态(0:
业务未开通1:
业务开通)
7
effective_date
String
非空
业务生效时间
格式:
yyyyMMddhhmmss
如果为-1表示立即生效
8
expire_date
String
非空
业务失效时间
格式:
yyyyMMddhhmmss
如果为-1表示永不失效
9
换行
char
非空
回车换行符,ASCII码0x0d0x0a
文件示例
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国联通 通信 管家 统计分析 数据 接口 协议
![提示](https://static.bdocx.com/images/bang_tan.gif)