[{"data":1,"prerenderedAt":420},["ShallowReactive",2],{"navigation-zh-CN":3,"doc-zh-CN-/features/analytics":81,"surround-zh-CN-/features/analytics":415},[4,23,45,67],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"开始使用","i-lucide-rocket","/getting-started","1.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"认识 TraceVista","/getting-started/introduction","1.getting-started/1.introduction",{"title":15,"path":16,"stem":17},"5 分钟快速接入","/getting-started/quick-start","1.getting-started/2.quick-start",{"title":19,"path":20,"stem":21},"核心概念","/getting-started/concepts","1.getting-started/3.concepts",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"产品能力","i-lucide-blocks","/features","2.features",[29,33,37,41],{"title":30,"path":31,"stem":32},"功能总览","/features/overview","2.features/1.overview",{"title":34,"path":35,"stem":36},"性能指标与优化","/features/performance","2.features/2.performance",{"title":38,"path":39,"stem":40},"前端错误监控","/features/errors","2.features/3.errors",{"title":42,"path":43,"stem":44},"访问分析与业务事件","/features/analytics","2.features/4.analytics",{"title":46,"icon":47,"path":48,"stem":49,"children":50,"page":22},"SDK 接入","i-lucide-code-xml","/sdk","3.sdk",[51,55,59,63],{"title":52,"path":53,"stem":54},"安装浏览器 SDK","/sdk/installation","3.sdk/1.installation",{"title":56,"path":57,"stem":58},"SDK 配置","/sdk/configuration","3.sdk/2.configuration",{"title":60,"path":61,"stem":62},"SDK API 参考","/sdk/api","3.sdk/3.api",{"title":64,"path":65,"stem":66},"隐私、安全与采集边界","/sdk/privacy","3.sdk/4.privacy",{"title":68,"icon":69,"path":70,"stem":71,"children":72,"page":22},"网站与额度","i-lucide-folder-cog","/account","4.account",[73,77],{"title":74,"path":75,"stem":76},"管理监控网站","/account/projects","4.account/1.projects",{"title":78,"path":79,"stem":80},"免费接收量与用量规则","/account/quota","4.account/2.quota",{"id":82,"title":42,"body":83,"description":408,"extension":409,"links":410,"meta":411,"navigation":412,"path":43,"seo":413,"stem":44,"__hash__":414},"docs_zh_cn/2.features/4.analytics.md",{"type":84,"value":85,"toc":401},"minimal",[86,90,94,97,116,120,141,144,148,164,180,183,186,196,288,291,367,370,373,380,388,391,397],[87,88,89],"p",{},"访问分析描述用户如何进入和浏览网站，业务事件描述用户是否完成产品中的关键动作。两者结合，才能把体验质量和业务结果联系起来。",[91,92,93],"h2",{"id":93},"页面访问数据",[87,95,96],{},"SDK 自动记录页面 URL、标题、来源、访客与会话标识，并补充：",[98,99,100,104,107,110,113],"ul",{},[101,102,103],"li",{},"视口和屏幕尺寸、设备像素比",[101,105,106],{},"语言、时区",[101,108,109],{},"导航类型",[101,111,112],{},"网络有效类型、往返时延、下行速度和省流模式（浏览器支持时）",[101,114,115],{},"SDK 版本",[91,117,119],{"id":118},"pvuv-与会话","PV、UV 与会话",[98,121,122,129,135],{},[101,123,124,128],{},[125,126,127],"strong",{},"PV","：页面访问次数。SPA 的有效路由变化也会产生新的页面访问。",[101,130,131,134],{},[125,132,133],{},"UV","：按浏览器本地访客标识估算的独立访客数。",[101,136,137,140],{},[125,138,139],{},"会话","：同一标签页会话存储范围内的一组访问。",[87,142,143],{},"UV 是技术标识下的估算值。用户清理本地存储、更换浏览器或设备后会形成新的访客标识；不同设备也不会自动合并为同一个人。",[91,145,147],{"id":146},"spa-自动追踪","SPA 自动追踪",[87,149,150,151,155,156,159,160,163],{},"SDK 会监听 ",[152,153,154],"code",{},"history.pushState","、",[152,157,158],{},"history.replaceState"," 和 ",[152,161,162],{},"popstate","。URL 发生变化时，它会：",[165,166,167,170,177],"ol",{},[101,168,169],{},"提交上一页面已经采集的性能指标。",[101,171,172,173,176],{},"创建新的 ",[152,174,175],{},"page_view_id","。",[101,178,179],{},"记录新的页面访问和来源关系。",[87,181,182],{},"如果你的应用只改变页面内容而不改变 URL，需要主动设计业务事件，或让路由产生可区分的路径。",[91,184,185],{"id":185},"业务事件",[87,187,185,188,191,192,195],{},[125,189,190],{},"不会自动采集","。平台无法猜测哪些动作对你的产品重要，需要你在代码中明确调用 ",[152,193,194],{},"track()"," 来触发：",[197,198,203],"pre",{"className":199,"code":200,"language":201,"meta":202,"style":202},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","window.TraceVista.track('search_submitted', {\n    result_count: 18,\n    category: 'docs'\n})\n","js","",[152,204,205,245,262,279],{"__ignoreMap":202},[206,207,210,214,218,221,223,227,230,233,237,239,242],"span",{"class":208,"line":209},"line",1,[206,211,213],{"class":212},"sndM8","window",[206,215,217],{"class":216},"s86vT",".",[206,219,220],{"class":212},"TraceVista",[206,222,217],{"class":216},[206,224,226],{"class":225},"swgpB","track",[206,228,229],{"class":212},"(",[206,231,232],{"class":216},"'",[206,234,236],{"class":235},"sIEYB","search_submitted",[206,238,232],{"class":216},[206,240,241],{"class":216},",",[206,243,244],{"class":216}," {\n",[206,246,248,252,255,259],{"class":208,"line":247},2,[206,249,251],{"class":250},"sd2Uz","    result_count",[206,253,254],{"class":216},":",[206,256,258],{"class":257},"smPcV"," 18",[206,260,261],{"class":216},",\n",[206,263,265,268,270,273,276],{"class":208,"line":264},3,[206,266,267],{"class":250},"    category",[206,269,254],{"class":216},[206,271,272],{"class":216}," '",[206,274,275],{"class":235},"docs",[206,277,278],{"class":216},"'\n",[206,280,282,285],{"class":208,"line":281},4,[206,283,284],{"class":216},"}",[206,286,287],{"class":212},")\n",[87,289,290],{},"也可以指定自定义页面路径：",[197,292,294],{"className":199,"code":293,"language":201,"meta":202,"style":202},"window.TraceVista.track(\n    'checkout_completed',\n    { order_type: 'subscription' },\n    { path: '/checkout/success' }\n)\n",[152,295,296,311,323,343,362],{"__ignoreMap":202},[206,297,298,300,302,304,306,308],{"class":208,"line":209},[206,299,213],{"class":212},[206,301,217],{"class":216},[206,303,220],{"class":212},[206,305,217],{"class":216},[206,307,226],{"class":225},[206,309,310],{"class":212},"(\n",[206,312,313,316,319,321],{"class":208,"line":247},[206,314,315],{"class":216},"    '",[206,317,318],{"class":235},"checkout_completed",[206,320,232],{"class":216},[206,322,261],{"class":216},[206,324,325,328,331,333,335,338,340],{"class":208,"line":264},[206,326,327],{"class":216},"    {",[206,329,330],{"class":250}," order_type",[206,332,254],{"class":216},[206,334,272],{"class":216},[206,336,337],{"class":235},"subscription",[206,339,232],{"class":216},[206,341,342],{"class":216}," },\n",[206,344,345,347,350,352,354,357,359],{"class":208,"line":281},[206,346,327],{"class":216},[206,348,349],{"class":250}," path",[206,351,254],{"class":216},[206,353,272],{"class":216},[206,355,356],{"class":235},"/checkout/success",[206,358,232],{"class":216},[206,360,361],{"class":216}," }\n",[206,363,365],{"class":208,"line":364},5,[206,366,287],{"class":212},[87,368,369],{},"事件名称最长 100 个字符，自定义数据序列化后不能超过 10 KB，超限会被服务端拒绝。",[91,371,372],{"id":372},"命名建议",[87,374,375,376,379],{},"推荐使用稳定的 ",[152,377,378],{},"对象_动作"," 格式和小写下划线：",[197,381,386],{"className":382,"code":384,"language":385,"meta":202},[383],"language-text","signup_started\nsignup_completed\nsearch_submitted\ncheckout_completed\nreport_exported\n","text",[152,387,384],{"__ignoreMap":202},[87,389,390],{},"避免把按钮文案、页面标题或时间戳写进事件名。变化的信息应该放在事件数据中，这样事件才容易聚合。",[392,393,394],"warning",{},[87,395,396],{},"自定义事件内容由接入方决定。请不要上报密码、Cookie、访问 Token、银行卡、完整身份证件、医疗信息或其他不必要的个人敏感信息。",[398,399,400],"style",{},"html pre.shiki code .sndM8, html code.shiki .sndM8{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s86vT, html code.shiki .s86vT{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swgpB, html code.shiki .swgpB{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sIEYB, html code.shiki .sIEYB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sd2Uz, html code.shiki .sd2Uz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .smPcV, html code.shiki .smPcV{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":202,"searchDepth":264,"depth":247,"links":402},[403,404,405,406,407],{"id":93,"depth":247,"text":93},{"id":118,"depth":247,"text":119},{"id":146,"depth":247,"text":147},{"id":185,"depth":247,"text":185},{"id":372,"depth":247,"text":372},"理解 PV、UV、会话、来源、环境分析和自定义事件，以及如何建立清晰的事件命名规范。","md",null,{},true,{"title":42,"description":408},"LvP6sm3znQ",[416,418],{"title":38,"path":39,"stem":40,"description":417,"children":-1},"了解自动捕获的错误类型、上下文、去重和限流机制，以及如何主动报告业务异常。",{"title":52,"path":53,"stem":54,"description":419,"children":-1},"通过 Script 标签接入 TraceVista，并了解自动采集的启动时机。",1789572469086]