本文目标:整理邮件用户状态和邮件查阅/点击情况情况的获取通道

1.用户状态及订购信息的获取

大致有这两个通道获取:

1.运营商的订购同步信息:目前仅有移动有

其中暂停服务的交易可以得到用户的状态信息;

2.下发系统中的发送响应及报告中的信息;

联通响应中有失败原因可以获取一些信息:如红,黑名单,退订用户等.详见:

2.邮件查阅情况:

电信有获取任务发送效果接口,可以查到一些关于打开,点击等情况,未调试;

邮件的阅读情况还可以通过对邮件中的静态资源,如logo,图片,邮件附件等的访问统计获取,.

实现需要分析nginx的日志,并对nginx日志格式预告定义好.

分析日志可以使用ELK全文检索框架或编写脚本进行分析,并形成报告.

3.resp 中的信息

3.1 mail139

接口返回码定义表

返回代码	对应含义说明
200	操作成功。
301	IP错误，未认证的ip请求。
302	COMEFROM错误（为空、超长、与IP绑定的COMEFROM不匹配）。
304	REQSN错误（为空、超长、同一请求流水号已提交）。
305	SKEY错误（请求包里的SKEY与MD5生成的值不一致）。
306	VERSION错误（为空或与服务端的版本不匹配）。
307	COMMANDID错误（为空、超长或不存在）
308	PROVINCE错误（为空、超长或不存在）
309	BILLINGFILE错误(为空、超长)
310	同一批次文件数超过最大量
311	MD5错误（为空、长度不足或超长）
312	指定的文件不存在
313	XML包体格式不正确（为空、XML解析错误）。
314	BILLINGFILE错误（格式错）
315	TIMESTAMP时间戳错误
316	BUSICODE错误（为空、超长、未在139邮箱投递平台注册）
317	该业务代码未启用
318	REQTIME错误（为空、超长或格式错误）
319	TEMPLATEID错误（为空、超长、或者不存在）
320	OPTYPE错误（为空、超长或者不存在）
321	TEMPLATEFILE错误(为空、超长)
322	TEMPLATEFILE错误（格式错）
323	FROM错误（超长或未在139邮箱投递平台注册）
324	FROMNAME错误（超长）
325	TITLE错误（超长）
326	TO错误（为空、超长）
327	TONAME错误（超长）
328	BRAND错误（超长或者不存在）
329	ID错误（为空、超长）
330	TYPE错误（为空、超长）
331	VALUE错误（为空、超长）
332	TOLIST错误（为空、超长）
333	TOLIST错误（格式错）
334	PASSWORD错误（超长）
335	TriggerMode触发模式错误
336	INFO错误（模板封装失败，Info传值有错误）
337	文件MD5校验失败
338	该TEMPLATEID未就绪、失败或已取消
339	TOLIST错误（用户数量超过上限/下限）
340	文件解压失败
341	实例模版审核不通过
342	该模版在139邮箱平台里的未就绪及启用状态的模版超过系统允许的最大量
343	账单文件本月上传批次已超过系统允许的最大批次量
344	文件解密失败
501	邮件发送失败
388	该用户可接收邮件数已达到一天可接收邮件最大量
388	该业务可接收邮件数已达到一天可接收邮件最大量
388	该客户可接收邮件数已达到一天可接收邮件最大量
388	黑名单用户(免打扰)
388	退订用户
388	红名单用户
388	黑名单用户
388	灰名单用户
388	沉默用户
388	收费用户
388	忠诚用户
388	活跃用户
501	数据库操作失败
601	服务器配置信息错误
602	获取模板错误
998	服务器忙
999	未知错误

3.2.mail 186

resp中没有关于客户状态的信息,仅仅返回taskId.

3.3 mail 189

错误代码	说明
0	调用成功
30402	缺少必要接口参数
30403	认证不通过，accessToken不存在或已过期
30409	没有权限调用该接口
30404	服务器拒绝服务（调用太频繁）
30405	用户不存在
30411	任务已过期
30412	任务创建失败，请重新调用创建任务接口创建任务
30600	系统出错
30500	其它错误

另外电信有接口可以获取任务发送效果,接口未调试.

可以获取如下信息:

filteredCount	float	略过数（当taskType为103时，该字段为空或0）
successCount	float	成功数
failCount	float	失败数
sendCount	Float	发送数
unSendCount	Float	未发送数=发送数-成功数-失败数-略过数（当taskType为103时，该字段为发送数-成功数-失败数）
unsubcribeCount	float	退订数（当taskType为103时，该字段为空或0）
realSendCount	float	实际发送数=发送数-略过数（当taskType为103时，该字段为发送数）
openMans	float	打开人数（当taskType为103时，该字段为空或0）
openTimes	float	打开次数（当taskType为103时，该字段为空或0）
clickMans	float	点击人数（当taskType为103时，该字段为空或0）
clickTimes	float	点击次数（当taskType为103时，该字段为空或0）
onlyClickTimes	float	唯一点击数（当taskType为103时，该字段为空或0）
sendCountRatio	float	发送数比率，默认是1
filteredRatio	float	略过率=略过数/发送数（当taskType为103时，该字段为空或0）
realSendRatio	float	实际发送率=实际发送数/发送数
successSendRatio	float	成功发送率=成功发送数 /发送数
unSendRatio	float	未发送率=未发送数/发送数
openMansRatio	float	打开人数率=打开人数 /成功发送数（当taskType为103时，该字段为空或0）
openTimesRatio	float	打开次数率=打开此时 /成功发送数（当taskType为103时，该字段为空或0）
clickMansRatio	float	点击人数率=点击人数 /成功发送数（当taskType为103时，该字段为空或0）
clickTimesRatio	float	点击次数率=点击次数 /成功发送数（当taskType为103时，该字段为空或0）
onlyClickRatio	float	唯一点击率=唯一点击数 /成功发送数（当taskType为103时，该字段为空或0）
attractRatio	float	页面吸引率=点击人数/ 打开人数（当taskType为103时，该字段为空或0）
unsubscribeRatio	float	退订率=退订人数 /成功发送数（当taskType为103时，该字段为空或0）

2.发送报告

2.1 mail 139

使用的是短信的发送报告.有价值的错误码如下:

206 移动用户帐户数据异常 208 用户余额不足 210 超过最高欠费额

232 月消费超额

2.2 mail186

报告中无相关说明

2.3 mail 189

报告中无相关错误码说明

3.运营商订购接口

189 无

186 无

139:订购关系同步接口

actionId	1：开通服务； 2：停止服务； 3：激活服务； 4：暂停服务；	String	1	必需	misc计费通过actionId处理业务

zhrun8899 / learning-notes

1.用户状态及订购信息的获取

2.邮件查阅情况:

3.resp 中的信息

3.1 mail139

3.2.mail 186

3.3 mail 189

2.发送报告

2.1 mail 139

2.2 mail186

2.3 mail 189

3.运营商订购接口

简介

发行版

贡献者

近期动态

zhrun8899 / learning-notes .gitee-modal { width: 500px !important; }

1.用户状态及订购信息的获取

2.邮件查阅情况:

3.resp 中的信息

3.1 mail139

3.2.mail 186

3.3 mail 189

2.发送报告

2.1 mail 139

2.2 mail186

2.3 mail 189

3.运营商订购接口

简介

发行版

贡献者

近期动态

搜索帮助

zhrun8899 / learning-notes