UC浏览器开放参数使用说明 .doc

UC浏览器开放参数使用说明目 录1 UC浏览器客户端公共参数概述21.1 客户端公共参数的作用21.2 UC浏览器开放参数说明21.3 客户端公共参数详细说明32 开放参数获取方式73 常见问题以及说明83.1 UC浏览器直连和中转两种访问方式有何异同？83.2 直连/中转方式对获取公共参数的限制93.3 302跳转不支持公共参数传递的处理方法91 UC浏览器客户端公共参数概述1.1 客户端公共参数的作用Web/Wap应用通过URL传递参数的方式向UC浏览器按需获取需要的信息。开放参数信息可以快捷的帮助Web/Wap应用对UC浏览器适配。通过获取分辨率、平台、联网方式等信息进行优化，给用户提供更好移动互联网访问体验。1.2 UC浏览器开放参数说明UC浏览器公共参数面向所有合法WEB/WAP应用开放。合法WEB/WAP应用可以根据UC浏览器公共参数获取协议按需获取公共参数。值得注意的是：有些开放参数只是在特定版本中可获取，较低版本的UC浏览器可能存在不能获取公参的情况。以下为公共参数的数据字典及与UC浏览器版本的对应关系：序号客户端参数参数描述适用UC浏览器版本1up手机品牌、系统参数7.8版本及以上2ss手机分辨率参数7.8版本及以上3nt客户端联网方式参数7.2版本及以上4dn客户端序列号7.2版本及以上5ve客户端版本号7.2版本及以上6la客户端语言环境7.7版本及以上7mi客户端UA7.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高度的方式，例如：320x2401.3.3 nt参数描述：nt指的是用户使用UC浏览器访问互联网的联网形式。包括wap访问、net访问、wifi访问。用途举例对于下载或耗费流量较大的WEB/WAP应用，通过获取nt参数，可以有针对性的给用户提供最适应资源。若收到nt值为2，表示用户使用wifi上网，那么可以考虑适当的推送高质量的资源给用户。格式：采用数字代表联网方式：代号联网方式0 wap1 net2 wifi99 缺省1.3.4 dn参数描述：dn指的是客户端安装序列号，为用户的手机安装UC浏览器后由浏览器云端随机生成的一个字符串。每一个手机上的UC浏览器客户端都拥有唯一的dn值。当用户卸载UC浏览器后再执行安装UC浏览器的操作，dn值将再次随机生成。用途举例：在非强制注册的Web/Wap应用中，可以用dn做为用户标记参数。因为dn具有唯一性，故阅读类网站可以用于记录用户历史阅读记录、视频类网站可以用于记录观看历史。格式：例如1234567-abcdefg1.3.5 ve参数描述：ve指的是UC浏览器客户端版本号。用于识别用户使用UC浏览器的版本号信息。用途举例：UC浏览器7.7及以上版本支持支付宝在线快捷支付。有移动互联网支付需求的WEB/WAP应用可以根据用户的版本号进行支付流程的个性化定制。格式：例如5。1.3.6 la参数描述： la是指UC浏览器的使用语言环境。用途举例：有国际化需求的Web/Wap应用可以根据从UC浏览器获取的la的属性，推送相应国家语言的页面给用户。格式：采用国际标准的语言的英文缩写形式，例如：zh-cn：Chinese - Peoples Republic of Chinazh-sg：Chinese Singaporezh-tw：Chinese - Taiwanzh-hk：Chinese - Hong Kong SARzh-mo：Chinese - Macao SARen-us：English - United Statesen-gb：English - United Kingdomen-au：English - Australiaen-bz：English - Belizeen-ca：English Canada1.3.7 mi参数描述：mi是手机的UA字符串信息，包含用户手机完整的UA信息。参数传输时，使用urlencode编码用途举例：mi包含用户手机的原始UA信息，可供Web/Wap应用获取原始数据，做更深层次的用户数据分析。格式：与标准的浏览器UA相同。2 开放参数获取方式Web/Wap应用在网页URL中包含申请UC浏览器公参请求字符串：uc_param_str如：/index.php?id=123&uc_param_str=dnupUC浏览器接收到公参申请请求后返回相应数据如：/index.php?id=123&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 直连/中转方式对获取公共参数的限制通过中转方式访问，在以下场景时不支持公共参数传递：n 通过图片请求UC浏览器公共参数n 通过css请求请求UC浏览器公共参数n 通过302跳转请求请求UC浏览器公共参数n 通过refresh请求请求UC浏览器公共参数通过直连方式不受以上限制。3.3 302跳转不支持公共参数传递的处理方法由于UC浏览器客户端不支持对302跳转地址的参数传递，因此跳转的目标地址不能获取公共参数。例如若用户访问的地址为：/index.php?uc_param_str=dnup若服务器要求跳转到地址：/index.php?id=