脚本高级统计
这是一个内测中的功能
这是一个类似网站统计工具的库,引入后可以统计你脚本用户的使用情况,例如:脚本版本分布、运行设备分析、用户数等等
演示脚本: 高级统计测试
使用方式
该库需要你在脚本中引入,并执行代码,key可以从脚本统计/高级统计中获取,另外必须设置白名单,非白名单内数据不会收集,库引入方式推荐为指定版本号,否则脚本管理器无法更新库的缓存。
推荐方式
// @require https://scriptcat.org/lib/881/1.1.0/script-statistics.js
// @grant GM_setValue
// @grant GM_getValue
// @antifeature tracking
try {
new SC_Statistic({
key: "高级统计key",
});
} catch (e) {
console.warn("statistic failed: ", e);
}
最简洁的方式
// @require https://scriptcat.org/lib/881/1.1.0/script-statistics.js
// @antifeature tracking
try {
new SC_Statistic({
key: "高级统计key",
});
} catch (e) {
console.warn("statistic failed: ", e);
}
如果不设置请求方式参数,会默认按照xhr、GM_xhr的方式进行请求,可能有以下几种情况:
使用ajax的方式收集数据(优先)
这种方式在某些网站下运行可能会因为CSP策略无法提交数据,但是无需声明GM权限
使用GM_xhr的方式收集数据
当ajax方式错误时,会使用此方式,此方式需要声明GM权限,但是可以无视网站的CSP策略,如果都不支持数据将无法收集
// @connect scriptcat.org
// @require https://test.scriptcat.org/lib/881/1.1.0/script-statistics.js
// @grant GM_setValue
// @grant GM_getValue
// @grant GM_xmlhttpRequest
// @antifeature tracking
用户识别方式
GM方式(推荐)
在脚本头信息中声明GM_get/setValue权限,能够获取更加准确的用户识别
// @grant GM_setValue
// @grant GM_getValue
网站localStorage方式
无需声明GM权限,但是也无法准确识别用户,每一个域将会产生一个用户
自定义
可以自定义使用以下方式,由脚本来确定唯一用户
try {
new SC_Statistic({
key: "高级统计key",
customHash(){
return "customHash";
}
});
} catch (e) {
console.warn("statistic failed: ", e);
}
退出数据收集
退出时数据收集使用navigator.sendBeacon
实现,效果欠佳,类似于ajax方式受CSP限制,并且无法准确收集,后续可能更新替换其它更好的方法
参数声明
new SC_Statistic({
key: "高级统计key",// 必须,统计key
whitelist: ["scriptcat.org"],// 在白名单内的域名才会统计,为空将会自动拉取后端配置
banFrame: false,// 不收集iframe中的数据
enableGM: true,// 开启GM请求
enableXML: true,// 开启ajax请求
customHash: undefind,// 自定义哈希
});