2022-12-20

B端产品经理必知:如何将第三方错误信息转化为友好型提示?

前言

作为一个B端或者SaaS产品经理,在日常的工作中经常需要对接第三方的系统。在对接第三方的系统的时候,比较常见的小困扰就是第三方系统返回的错误信息的处理。

有一些研发能力比较强或者说接口做的比较完善的第三方,他们返回的错误信息会比较的齐全,会包含错误码,错误信息和其他内容等,我们可以通过这些信息知道发生了什么错误,应该要怎么解决。

截图出自:Aftership的API文档

同时第三方的API文档中也会有一个公共的错误码查询页面,当我们遇到了一些问题之后,可以查看这些文档去尝试自己解决问题。

截图出自:速卖通的API文档

但是在实际的工作中,我们也会发现有一些第三方的API其实做得很不完善。有一些错误信息没有规范处理,可能没有错误码,也可能错误信息都是一些偏术语性的程序错误,导致我们拿到了错误信息之后并不知道错误信息到底是怎么产生的,应该要怎么解决。类似于下图的错误,是在对接一些国际物流渠道的时候经常会遇到的问题:

DHL返回的错误,即使翻译了也看不太懂原因是啥

在跨境电商SaaS ERP或者SaaS WMS/TMS这一类系统中,以上问题出现的频率很高。尤其是SaaS ERP,因为它需要对接很多外部的第三方系统,例如说:

  1. 对接电商平台,Amazon,eBay,Walmart,Shopify等;
  2. 对接物流商,国际物流(DHL,FedEx,UPS),跨境物流(云途,燕文,4PX)等;
  3. 对接海外仓,谷仓,万邑通,4PX,其他SaaS WMS等;
  4. 对接一些工具服务商,图片翻译,图片编辑,支付收款,选品分析等;

这些第三方系统,有一些是有比较专业的研发团队,有一些则是不太专业的研发团队,所以就会导致在对接完成了之后,用户在使用的过程中如果遇到了问题或者错误,反馈回来的原始错误信息有可能是不太好阅读的,甚至是压根对不上的错误信息。

除此之外,由于要对接很多国外的系统(国际物流商),这些系统返回的错误信息还有一些语言上的差异,例如说德国的物流渠道会返回的错误是德语,法货的物流渠道返回的错误是法语,即使是比较通用的英语,有一些错误信息还是需要借助翻译工具才能理解其中的意思。

DHL Packet返回的错误是德语

基于以上的背景,当我们对接了大量的第三方系统,而第三方系统返回的错误信息可能是千差万别,甚至非常不利于客户理解的时候,我们就需要考虑去对第三方系统返回的错误信息做一个转换处理,这个处理过程我称之为:错误信息转化为友好型提示的过程

什么是友好型提示?

当用户在使用系统的过程中,用户并不关心系统背后对接了多少家第三方系统,用户甚至也不担心在使用的过程中遇到报错,用户担心的是报错看不懂,报错有误,这种不确定性会很容易消耗掉用户的耐心,从而让用户对系统产生一些负面的看法

作为一款信息系统的设计者(产品经理),我们都知道系统运行发生错误,提示错误信息是不可避免的。但是我们期待的是,当系统出现了错误时,呈现给用户看到的东西是"友好型的提示",也就是让用户容易理解,最好是能能让用户自主排查问题、自行解决问题的一种提示。

友好型提示案例1

如上图所示,我在刊登产品到Shopify的时候报错了,系统告诉了我错误原因是"Unavaliable Shop",同时还告诉了我解决方案,是因为我的店铺不可用,需要重新授权,点击就可以查看具体的授权操作帮助指引。

这种错误提示对用户来说就是"友好型提示",除了告诉我出错了,还告诉了我错误原因是啥,我应该怎么去解决这个错误。

友好型提示案例2

上面这张图反馈的也算是"友好型提示",先告诉了我遇到了错误,同时也告诉了我错误原因是"account numer must be of the legth 14",所以我要做的就是查看我的account number是否有超长。

并不是说"友好型提示"就一定要翻译成中文或者一定要带上解决方案,只要能让用户快速知道问题所在,并知道怎么解决这个问题,那么这种错误提示都可以称之为"友好型提示"

错误信息如何转化为友好型提示?

当我们请求第三方系统的时候,从结果上来看,要么是成功的,要么是失败的。如果只看失败的情况下,失败的提示也就分成两种,要么是能看得懂的(友好型),要么是看不太懂的(非友好型)。

所以,当我们讨论怎么将错误信息转化为友好型提示时,其实前提是将"非友好型"的错误信息转化为"友好型"的提示。因为,有一些第三方系统是会对错误信息处理好后才抛给请求方,这样的错误信息一般情况下都是友好型的,而有一些第三方系统则是因为种种原因,所以就直接将非友好型的错误信息回传给请求方了。

如果第三方回传的是友好型提示,那么后端接收到了错误信息之后,无需处理,直接传给前端去展示对应的错误即可;如果第三方回传的是非友好型提示,那么后端接收到了之后就需要额外处理、转化加工之后再传给前端,去展示处理后的友好型提示。

那么,后端怎么判断第三方系统返回的错误信息是友好型提示还是非友好型呢?

错误信息转化为友好型提示的示意图

最简单的办法就是在"错误信息"和"友好型提示"之间,加.............

原文转载:http://fashion.shaoqun.com/a/1200413.html


跨税云:https://m.ikjzd.com/w/2826
美国宣布限制印度旅客入境:https://m.ikjzd.com/articles/123157
东莞市库珀电子有限公司:https://www.ikjzd.com/news/111518
警告信:https://www.ikjzd.com/articles/23202
landing page:https://m.ikjzd.com/articles/18287
亚马逊广告:https://m.ikjzd.com/k/12138
zappos:https://www.ikjzd.com/w/330
关键词分析工具:https://www.ikjzd.com/w/1768
阿根廷世界杯夺冠,跨境卖家如何借势营销?:https://www.ikjzd.com/articles/1604775807462883329
新链接错放类目,快速获取BS标志!同行表示:投诉到底:https://www.ikjzd.com/articles/1604054047528534018

No comments:

Post a Comment