上一主题 下一主题
ScriptCat,新一代的脚本管理器脚本站,与全世界分享你的用户脚本油猴脚本开发指南教程目录
返回列表 发新帖

【内测】高级统计库

[复制链接]
  • TA的每日心情
    擦汗
    前天 09:38
  • 签到天数: 141 天

    [LV.7]常住居民III

    226

    主题

    2729

    回帖

    2924

    积分

    管理员

    积分
    2924

    荣誉开发者喜迎中秋热心会员活跃会员突出贡献三好学生管理员油中2周年

    发表于 2023-3-17 15:24:07 | 显示全部楼层 | 阅读模式

    如何使用? 库问题反馈 给库评分 查看代码

    脚本高级统计

    这是一个内测中的功能

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

    演示脚本: 高级统计测试

    使用方式

    该库需要你在脚本中引入,并执行代码,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,// 自定义哈希
    });
    上不慕古,下不肖俗。为疏为懒,不敢为狂。为拙为愚,不敢为恶。/ 微信公众号:一之哥哥

    发表回复

    本版积分规则

    快速回复 返回顶部 返回列表