|  | 
| 1 | 1 | # sa-sdk-javascript | 
| 2 | 2 | 
 | 
| 3 |  | -Sensors Analytics JavaScript SDK | 
|  | 3 | +Sensors Analytics JavaScript SDK   | 
| 4 | 4 | 
 | 
| 5 |  | -完整文档请[ 点击这里](http://www.sensorsdata.cn/manual/js_sdk.html) ,如有疑问请联系邮箱 [email protected]。 | 
|  | 5 | +完整文档请[ 点击这里](http://www.sensorsdata.cn/manual/js_sdk.html) ,如有疑问请联系邮箱 [email protected] | 
| 6 | 6 | 
 | 
| 7 |  | -需要使用的文件说明: | 
|  | 7 | +> 注意 SDK 可能不完全向前兼容,请查看版本更新说明,如果有说明不兼容的话,需要升级神策分析对应的版本   | 
| 8 | 8 | 
 | 
| 9 |  | -* sensorsdata.min.js:打包压缩后的,数据采集文件, sdk_url 使用这个文件的位置    | 
| 10 |  | -* heatmap.min.js:打包压缩后的,点击图渲染时候需要用的文件( 1.9 以上版本新加 ), heatmap_url 指定这个文件的位置    | 
|  | 9 | +播广告一条:  | 
|  | 10 | + * 紧急招聘前端工程师,求发送到我邮箱 ([email protected])     | 
| 11 | 11 | 
 | 
| 12 |  | -> 注意 SDK 可能不完全向前兼容,请阅读具体的 Release Log。如果不确定是否支持,请联系神策技术支持人员!例如使用 1.9 版本 SDK ,神策分析系统必须也升级到 1.9 以上! | 
| 13 | 12 | 
 | 
| 14 |  | -请根据需要 [Releases](https://github.com/sensorsdata/sa-sdk-javascript/releases) 里下载对应的文件      | 
| 15 |  | - | 
| 16 |  | -插播广告一条: | 
| 17 |  | - * 紧急招聘前端工程师,求发送到我邮箱 ([email protected] ) | 
| 18 |  | - | 
| 19 |  | -  | 
| 20 |  | -最近更新:    | 
| 21 |  | -1.11.6 优化超时机制,增加自定义域名    | 
| 22 |  | -1.11.7 使用npm模块引入时候,多次init的判断    | 
| 23 |  | -1.11.8 在1.10.1 - 1.11.7间的版本有这个问题,必须更新!部分浏览器,发送相同数据时,不会发送,导致丢失数据的问题!   | 
| 24 |  | -1.11.9 heatmap增加了setContent参数,setContent是一个函数,有一个element参数,用户可以对元素内容进行操作,然后返回想要显示的内容,返回的内容会在点击图中的"当前内容"中显示   | 
| 25 |  | -1.11.10 增加autoTrackSinglePage首次可以触发profile_set_once的功能   | 
| 26 |  | -1.12.1 增加点击图第二版,按快捷键z和x,可切换点击图的渲染模式,用于解决某些点击图页面的样式冲突问题。增加配置heatmap:{element_selector:'not_use_id'} 不会使用id做为选择器,防止随机id导致的点击图不能使用。增加触达率图左右滚动的检查,禁止左右滚动触发scroll。增加scrollmap:{collect_url:false}{collect_url:function(){}}的配置。配置false的话,不采集$WebStay也就没有触达率图,配置function的话,会执行fucntion看返回值,返回真就采集,返回假不采集。   | 
| 27 |  | -1.12.2 增加点击图采集数据时候,采集浏览器宽度。调整点击图开始渲染的时间为1秒间隔。   | 
| 28 |  | -1.12.3 去除1.12.1增加的$WebStay的$viewport_left属性导致的埋点管理报错。     | 
| 29 |  | -1.12.5 优化关闭页面前,如果有多次发数据时候的性能,queue_timeout 设置成 0 的时候,不再使用setTimeout 0发送,改成直接发送。会脱离队列数据发送的流程,变为直接发送数据。      | 
| 30 |  | -1.12.6 去掉_nocache的防止静态缓存,默认增加_track_id的防止静态缓存,同时_track_id包含去重的功能,但是必须开启use_client_time。use_client_time如果使用客户端时间的话,会自动增加_flush_time来做客户端时间校准。另外完善ajax的timeout在ie6,7,8,9,10,11,edge下的各种异常处理。修复获取domain异常时候,设置cookie的domain再某些浏览器异常的问题。   | 
| 31 |  | -1.12.7 增加判断heatmap.js和sensorsdata.js版本是否一致的判断,打印log   | 
| 32 |  | -1.12.8 增加了第二版点击图对于opacity=0的元素的判断 | 
| 33 |  | -1.12.9 完善$WebStay对于横向滚动的判断   | 
| 34 |  | -1.12.10 $WebClick采集元素id的改进   | 
| 35 |  | -1.12.11 增加clearAllRegister删除单个cookie的功能   | 
| 36 |  | -1.12.12 trackHeatMap方法增加callback属性,第一版点击图给点击元素的after和before伪元素增加了pointer-events:none属性   | 
| 37 |  | -1.12.13 autoTrackSinglePage修改了当前referrer为url的问题   | 
| 38 |  | -1.12.14 trackHeatMap增加新方法trackAllHeatMap可以采集a,input,button标签   | 
| 39 |  | -1.12.15 referrer_domain参数修改,domain解析库增加ai后缀   | 
| 40 |  | -1.12.16 增加了is_track_latest配置属性,用于控制是否采集$latest相关属性,并且增加了$latest_landing_page用于表示最近一次落地页。      | 
| 41 |  | -1.12.17 修复了获取搜索引擎关键字sogou和so产生的问题    | 
| 42 |  | -1.12.18 增加is_track_single_page 自动采集url切换   | 
| 43 |  | -1.13.1 点击图的优化,增加https里发http请求的错误提示,增加heatmap_url没配置时候自动获取cdn,增加heatmap没配置时候无法查看点击图的错误提示   | 
| 44 |  | -1.13.2 增加渠道类型中自定义付费广告的相关参数 souce_type.utm 配置,修改$latest_landing_page属性取值异常的情况,增加对.top的域名解析 | 
| 45 |  | - | 
| 46 |  | - | 
|  | 13 | +最近更新:  | 
|  | 14 | + | 
|  | 15 | +| 版本号 | 更新内容 | | 
|  | 16 | +| ------ | ------ |  | 
|  | 17 | +|1.11.6 | 优化超时机制,增加自定义域名   | | 
|  | 18 | +|1.11.7 | 使用npm模块引入时候,多次init的判断   | | 
|  | 19 | +|1.11.8| 在1.10.1 - 1.11.7间的版本有这个问题,必须更新!部分浏览器,发送相同数据时,不会发送,导致丢失数据的问题!  | | 
|  | 20 | +1.11.9| heatmap增加了setContent参数,setContent是一个函数,有一个element参数,用户可以对元素内容进行操作,然后返回想要显示的内容,返回的内容会在点击图中的"当前内容"中显示  | | 
|  | 21 | +|1.11.10| 增加autoTrackSinglePage首次可以触发profile_set_once的功能  | | 
|  | 22 | +|1.12.1| 增加点击图第二版,按快捷键z和x,可切换点击图的渲染模式,用于解决某些点击图页面的样式冲突问题。增加配置heatmap:{element_selector:'not_use_id'} 不会使用id做为选择器,防止随机id导致的点击图不能使用。增加触达率图左右滚动的检查,禁止左右滚动触发scroll。增加scrollmap:{collect_url:false}{collect_url:function(){}}的配置。配置false的话,不采集$WebStay也就没有触达率图,配置function的话,会执行fucntion看返回值,返回真就采集,返回假不采集。  | | 
|  | 23 | +|1.12.2| 增加点击图采集数据时候,采集浏览器宽度。调整点击图开始渲染的时间为1秒间隔。  | | 
|  | 24 | +|1.12.3| 去除1.12.1增加的$WebStay的$viewport_left属性导致的埋点管理报错。    | | 
|  | 25 | +|1.12.5| 优化关闭页面前,如果有多次发数据时候的性能,queue_timeout 设置成 0 的时候,不再使用setTimeout 0发送,改成直接发送。会脱离队列数据发送的流程,变为直接发送数据。     | | 
|  | 26 | +|1.12.6| 去掉_nocache的防止静态缓存,默认增加_track_id的防止静态缓存,同时_track_id包含去重的功能,但是必须开启use_client_time。use_client_time如果使用客户端时间的话,会自动增加_flush_time来做客户端时间校准。另外完善ajax的timeout在ie6,7,8,9,10,11,edge下的各种异常处理。修复获取domain异常时候,设置cookie的domain再某些浏览器异常的问题。  | | 
|  | 27 | +|1.12.7| 增加判断heatmap.js和sensorsdata.js版本是否一致的判断,打印log  | | 
|  | 28 | +|1.12.8| 增加了第二版点击图对于opacity=0的元素的判断| | 
|  | 29 | +|1.12.9| 完善$WebStay对于横向滚动的判断|   | 
|  | 30 | +|1.12.10| $WebClick采集元素id的改进  | | 
|  | 31 | +|1.12.11| 增加clearAllRegister删除单个cookie的功能  | | 
|  | 32 | +|1.12.12| trackHeatMap方法增加callback属性,第一版点击图给点击元素的after和before伪元素增加了pointer-events:none属性  | | 
|  | 33 | +|1.12.13| autoTrackSinglePage修改了当前referrer为url的问题  | | 
|  | 34 | +|1.12.14| trackHeatMap增加新方法trackAllHeatMap可以采集a,input,button标签  | | 
|  | 35 | +|1.12.15| referrer_domain参数修改,domain解析库增加ai后缀 |  | 
|  | 36 | +|1.12.16| 增加了is_track_latest配置属性,用于控制是否采集$latest相关属性,并且增加了$latest_landing_page用于表示最近一次落地页。**增加了预置属性,可能需要小版本升级神策分析,改功能默认不开启**| | 
|  | 37 | +|1.12.17| 修复了获取搜索引擎关键字sogou和so产生的问题  |  | 
|  | 38 | +|1.12.18| 增加is_track_single_page 自动采集url切换  | | 
|  | 39 | +|1.13.1| 点击图的优化,增加https里发http请求的错误提示,增加heatmap_url没配置时候自动获取cdn,增加heatmap没配置时候无法查看点击图的错误提示  | | 
|  | 40 | +|1.13.2| 增加渠道类型中自定义付费广告的相关参数 souce_type.utm 配置,修改$latest_landing_page属性取值异常的情况,增加对.top的域名解析| | 
|  | 41 | +|1.13.3| 增加了新版的域名解析系统| | 
|  | 42 | +|1.13.4| 1.增加了获取匿名ID的方法 sensors.quick('getAnonymousID') ,返回匿名 id ; 2.在存储 cookie 时会截取 register 的字符串 max_referrer_string_length 长度;| | 
| 47 | 43 | 
 | 
| 48 | 44 | 
 | 
0 commit comments