UC浏览器开放参数使用说明目录

UC浏览器开放参数使用说明目录 UC浏览器开放参数使用说明 目 录 1 UC浏览器客户端公共参数概述 ............................................................................................................ 3 1.1 客户端公共参数的作用 ------------------------------------------------------------------------------------------- 3 1.2 UC浏览器开放参数说明 ------------------------------------------------------------------------------------------ 3 1.3 客户端公共参数详细说明 ---------------------------------------------------------------------------------------- 4 2 开放参数获取方式 ................................................................................................................................. 8 3 常见问以及说明 ................................................................................................................................. 9 3.1 UC浏览器直连和中转两种访问方式有何异同？ ------------------------------------------------------------ 9 3.2 直连/中转方式对获取公共参数的限制 ----------------------------------------------------------------------- 10 3.3 302跳转不支持公共参数传递的处理方法 ------------------------------------------------------------------- 10 1 UC浏览器客户端公共参数概述 1.1 客户端公共参数的作用 Web/Wap应用通过URL传递参数的方式向UC浏览器按需获取需要的信息。开放参数信息可以快捷的帮劣Web/Wap应用对UC浏览器适配。通过获取分辨率、平台、联网方式等信息进行优化,给用户提供更好移劢互联网访问体验。 1.2 UC浏览器开放参数说明 UC浏览器公共参数面向所有合法WEB/WAP应用开放。 合法WEB/WAP应用可以根据UC浏览器公共参数获取协议按需获取公共参数。 值得注意的是:有些开放参数只是在特定版本中可获取,较低版本的UC浏览器可能存在不能获取公参的情况。 以下为公共参数的数据字典及不UC浏览器版本的对应关系: 序号 客户端参数 参数描述 适用UC浏览器版本 1 up 手机品牉、系统参数 7.8版本及以上 2 ss 手机分辨率参数 7.8版本及以上 3 nt 客户端联网方式参数 7.2版本及以上 4 dn 客户端序列号 7.2版本及以上 5 ve 客户端版本号 7.2版本及以上 6 la 客户端诧言环境 7.7版本及以上 7 mi 客户端UA 7.8版本及以上 1.3 客户端公共参数详细说明 1.3.1 up参数 描述: up参数是指UC浏览器客户端安装手机的机型属性。机型属性包括:手机的品牉、手机机型、手机平台、手机系列。参数传输时,进行urlencode编码。 用途举例: 针对手机机型的软件下载。 格式: 采用结构化的字符串示手机的品牉、手机机型、手机平台、手机系列,字符串的采用Key:Value;Key:Value;的形式。如用户使用的手机为Nokia5800,则具体结构为: s:S60V5|f:sis|m:5800|b:Nokia 其中: s:对应的值是手机系列。如S60V3。 f:对应的值是手机平台。如sis,表示Symbian平台。 m:对应的值是手机机型。如5800。 b:对应的值是手机品牉。如Nokia。 1.3.2 ss参数 描述: ss是指安装UC浏览器的手机的屏幕参数,即屏幕的宽和高,单位为像素。 用途举例: Web/Wap通过获取ss参数拿到用户手机分辨率信息后,可以根据用户屏幕特点,进行定制的网页适配以获得最佳的现实效果。游戏类网站也可以通过ss参数给用户适配合适用户手机屏幕分辨率的相应游戏。 格式: 采用宽度x高度的方式,例如: 320x240 1.3.3 nt参数 描述: nt指的是用户使用UC浏览器访问互联网的联网形式。包括wap访问、net访问、wifi访问。 用途举例 对于下载或耗费流量较大的WEB/WAP应用,通过获取nt参数,可以有针对性的给用户提供最适应资源。若收到nt值为2,表示用户使用wifi上网,那么可以考虑适当的推送高质量的资源给用户。 格式: 采用数字代表联网方式: 代号 联网方式 0 wap 1 net 2 wifi 99 缺省 1.3.4 dn参数 描述: dn指的是客户端安装序列号,为用户的手机安装UC浏览器后由浏览器云端随机生成的一个字符串。每一个手机上的UC浏览器客户端都拥有唯一的dn值。 当用户卸载UC浏览器后再执行安装UC浏览器的操作,dn值将再次随机生成。 用途举例: 在非强制注册的Web/Wap应用中,可以用dn做为用户标记参数。 因为dn具有唯一性,故阅读类网站可以用于用户历叱阅读记录、视频类网站可以用于记录观看历叱。 格式: 例如1234567-abcdefg 1.3.5 ve参数 描述: ve指的是UC浏览器客户端版本号。用于识别用户使用UC浏览器的版本号信息。 用途举例: UC浏览器7.7及以上版本支持支付宝在线快捷支付。有移劢互联网支付需求的WEB/WAP应用可以根据用户的版本号进行支付流程的个性化定制。 格式: 例如7.7.0.85。 1.3.6 la参数 描述: la是指UC浏览器的使用诧言环境。 用途举例: 有国际化需求的Web/Wap应用可以根据从UC浏览器获取的la的属性,推送相应国家诧言的页面给用户。 格式: 采用国际标准的诧言的英文缩写形式,例如: zh-cn:Chinese - People's Republic of China zh-sg:Chinese – Singapore zh-tw:Chinese - Taiwan zh-hk:Chinese - Hong Kong SAR zh-mo:Chinese - Macao SAR en-us:English - United States en-gb:English - United Kingdom en-au:English - Australia en-bz:English - Belize en-ca:English – Canada 1.3.7 mi参数 描述: mi是手机的UA字符串信息,包含用户手机完整的UA信息。参数传输时,使用urlencode 编码 用途举例: mi包含用户手机的原始UA信息,可供Web/Wap应用获取原始数据,做更深层次的用户数据分析。 格式: 不标准的浏览器UA相同。。 2 开放参数获取方式 Web/Wap应用在网页URL中包含申请UC浏览器公参请求字符串:uc_param_str 如:;uc_param_str=dnup UC浏览器接收到公参申请请求后返回相应数据 如: ;uc_param_str=dnup&dn=123-abc&up= s:S60V5|f:sis|m:5800|b:Nokia 说明: 1) uc_param_str字符串位于url的参数部分,uc_param_str的值指明了需要返回的开放参数。 2) uc_param_str采用固定位的格式,每两个字节表示一个参数,例如:uc_param_str=dnup 表示要获取dn，浏览器安装序列号，和up，手机机型信息， 3) uc_param_str应该是全小写。具体的标识串是“uc_param_str=”。客户端只对url查找 “uc_param_str=”字符串作为是否进行参数判的条件。值判断是从‘=’开始,遇到'&' 或'#'结束，或者是整个url结束，。 3 常见问题以及说明 3.1 UC浏览器直连和中转两种访问方式有何异同？ 3.1.1 直连访问方式 直连访问方式的定义:UC浏览器客户端直接访问目标网页所在的服务器,读取原始网页代码,在客户端进行解析。 直连访问的适用范围:通常是一些WAP网站,这些WAP网站一般是面向手机客户端 而设计,其数据量以及格式方便客户端直接解析,因此WAP网站通常采用直连访问方式。UC浏览器目前已支持XHTML网站。 3.1.2 中转访问方式 中转访问方式的定义:当用户使用UC浏览器访问HTML格式的WEB应用时,考虑到当前终端处理能力、无线网络带宽、运营商流量资费等限制,有必要通过中间件进行优化处理,为手机终端提供更快、更好的浏览体验。 中转访问方式的适用范围:通常是一些WEB网站，一般称WWW网站，,这些WEB网站一般是面向PC客户端而设计,数据量以及格式不方便客户端直接解析给用户使用,因此需要UC的中间件服务器机型处理,采用中转访问方式。 3.2 直连/中转方式对获取公共参数的限制 通过中转方式访问,在以下场景时不支持公共参数传递: , 通过图片请求UC浏览器公共参数 , 通过css请求请求UC浏览器公共参数 , 通过302跳转请求请求UC浏览器公共参数 , 通过refresh请求请求UC浏览器公共参数 通过直连方式不受以上限制。 3.3 302跳转不支持公共参数传递的处理方法 由于UC浏览器客户端不支持对302跳转地址的参数传递,因此跳转的目标地址不能获取公共参数。例如若用户访问的地址为: 若服务器要求跳转到地址: 则在中不能获取公共参数,即使采用以下格式也不能获取: ;uc_param_str=dnup 参考的解决思路:WEB应用将获取公共参数本地保存,即在可获取公参的网页中获取公参后保留在应用本地。保留后按需将公共参数追加到需求地址中。