script-statistics

脚本高级统计

Acest script nu ar trebui instalat direct. Aceasta este o bibliotecă pentru alte scripturi care este inclusă prin directiva meta a // @require https://update.greasyfork.org/scripts/461573/1162621/script-statistics.js

Autor
CodFrm
Versiune
0.0.1.20230317072508
Creat
10-03-2023
Actualizat
17-03-2023
Licență
N/A

脚本高级统计

这是一个内测中的功能

这是一个类似网站统计工具的库,引入后可以统计你脚本用户的使用情况,例如:脚本版本分布、运行设备分析、用户数等等

演示脚本: 高级统计测试

使用方式

该库需要你在脚本中引入,并执行代码,key可以从脚本统计/高级统计中获取,另外必须设置白名单,非白名单内数据不会收集,库引入方式推荐为指定版本号,否则脚本管理器无法更新库的缓存。

推荐方式

// @require https://scriptcat.org/lib/881/1.2.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.2.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.2.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,// 自定义哈希
});