🍑 桃子统计帮助文档
专业的网站流量统计分析与在线客服平台
1. 功能概述
桃子统计是专业的网站流量统计分析与在线客服平台，提供三大核心功能模块：
📊 网站统计
实时追踪网站访问量、访客来源、页面浏览等关键指标，数据每30秒自动刷新
💬 在线客服
网页端实时聊天功能，支持AI智能回复、关键词自动回复、微信公众号消息推送
🌐 翻译插件
一键切换网站语言，支持13种语言互译，提升国际化用户体验
2. 快速开始
2.1 注册账号
访问 注册页面 创建账号，填写邮箱和密码即可完成注册。
2.2 创建网站
登录后进入 仪表盘，点击"添加网站"按钮，填写网站域名和名称即可创建。
2.3 获取接入代码
创建网站后，系统会自动生成唯一的 appId，并提供对应的接入代码。
💡 提示： 每个网站对应一个唯一的 appId，请勿泄露或分享给他人。
3. 接入代码
将以下代码添加到您网站的 <head> 标签中即可启用全部功能。
<!-- 桃子统计 - 网站统计 --> <script src="https://s.taozi.cc/Scripts/tracker.js" data-app-id="YOUR_APP_ID"></script> <!-- 桃子统计 - 在线客服 --> <script src="https://s.taozi.cc/Scripts/chat-widget.js" data-app-id="YOUR_APP_ID"></script> <!-- 桃子统计 - 翻译插件 --> <script src="https://s.taozi.cc/Scripts/translate.js" data-app-id="YOUR_APP_ID"></script>
3.1 单独使用某个功能
您可以根据需要只引入特定的脚本：
<!-- 仅启用网站统计 --> <script src="https://s.taozi.cc/Scripts/tracker.js" data-app-id="YOUR_APP_ID"></script> <!-- 仅启用在线客服 --> <script src="https://s.taozi.cc/Scripts/chat-widget.js" data-app-id="YOUR_APP_ID"></script> <!-- 仅启用翻译插件 --> <script src="https://s.taozi.cc/Scripts/translate.js" data-app-id="YOUR_APP_ID"></script>
⚠️ 注意： 请将
https://s.taozi.cc 替换为您的服务器域名，将 YOUR_APP_ID 替换为您的实际 appId。
4. 网站统计
4.1 功能说明
网站统计功能可以追踪以下数据：
- 访问量：页面浏览次数（PV）
- 独立访客：去重后的访客数量（UV）
- 独立IP：去重后的访问IP数量
- 平均停留时间：访客在页面上的平均停留时长
- 实时在线：当前正在浏览网站的访客数量
- 流量来源：搜索引擎、社交媒体、直接访问等
- 访客地域：国家、省份、城市分布
- 设备类型：PC、手机、平板等
- 浏览器：Chrome、Firefox、Safari等
- AI引擎：识别来自AI搜索引擎的流量
4.2 数据发送方式
统计脚本使用以下方式发送数据：
- Image Beacon：优先使用1x1像素图片请求，兼容性好
- navigator.sendBeacon：页面卸载时使用，确保数据不丢失
- XHR：备用方案，确保数据可靠发送
4.3 支持的事件追踪
除了自动追踪页面浏览外，还支持手动追踪自定义事件：
// 手动触发页面浏览追踪
window.Tracker.trackPageView();
// 追踪自定义事件
window.Tracker.trackEvent(category, action, label, value);
// 示例：追踪按钮点击
window.Tracker.trackEvent('click', 'button', '立即购买', 1);
// 获取当前会话ID
var sessionId = window.Tracker.getSessionId();
5. 在线客服
5.1 功能说明
在线客服功能为您的网站添加实时聊天能力：
- 浮动按钮：页面右下角显示客服按钮，点击展开聊天窗口
- AI智能回复：基于大语言模型自动回复访客消息
- 关键词自动回复：配置关键词匹配规则
- 知识库：上传知识库文档，AI优先匹配知识内容
- 微信推送：访客消息实时推送到微信公众号
- 多样式主题：支持10种主题样式
5.2 客服API
// 打开/关闭聊天窗口 window.ChatWidget.toggle(); // 发送文本消息 window.ChatWidget.sendText(); // 发送图片 window.ChatWidget.sendImage(inputElement); // 获取版本号 var version = window.ChatWidget.getVersion();
5.3 样式配置
支持10种主题样式，可在后台管理界面选择：
6. 翻译插件
6.1 功能说明
翻译插件为您的网站添加多语言支持：
- 语言切换：点击按钮选择目标语言
- 即时翻译：无需刷新页面，内容实时翻译
- 13种语言：支持中文、英文、日语、韩语等
- 记忆功能：自动记忆用户选择的语言偏好
- 自定义样式：支持10种主题样式
6.2 支持的语言
6.3 翻译API
// 打开/关闭翻译面板
window.TranslatePlugin.toggle();
// 选择目标语言
window.TranslatePlugin.selectLang('en');
// 执行翻译
window.TranslatePlugin.translate();
// 还原原文
window.TranslatePlugin.restore();
// 获取版本号
var version = window.TranslatePlugin.getVersion();
7. API参考
7.1 统计接口
GET /Handler/Track.ashx?action=pageview&data=JSON_DATA
参数说明：
action: 操作类型（pageview/event/unload）data: JSON格式的追踪数据appId: 网站ID（必需）
7.2 客服接口
// 创建会话 GET /Handler/ChatApi.ashx?action=create&appId=xxx&visitorName=xxx // 发送消息 GET /Handler/ChatApi.ashx?action=send&sessionId=xxx&content=xxx // 轮询消息 GET /Handler/ChatApi.ashx?action=poll&sessionId=xxx&lastId=xxx // 获取设置 GET /Handler/ChatApi.ashx?action=settings&appId=xxx
7.3 数据接口
// 获取统计数据 GET /Handler/DataApi.ashx?action=getStatistics&websiteId=xxx // 翻译接口 GET /Handler/DataApi.ashx?action=translate&text=xxx&target=xxx
8. 常见问题
Q: 统计数据多久更新一次？
A: 实时数据每30秒自动刷新，历史数据按天统计。
Q: 客服消息会保留多久？
A: 聊天记录永久保存，可随时查看历史对话。
Q: 翻译插件会影响网站性能吗？
A: 不会。翻译插件采用按需加载方式，只有用户点击翻译时才会发起请求。
Q: 是否支持HTTPS？
A: 支持。脚本会自动检测当前页面协议，如果是HTTPS会自动使用HTTPS协议加载。
Q: 数据存储在哪里？
A: 数据存储在服务器本地的SQLite数据库中，数据安全可控。
Q: 免费版和付费版有什么区别？
A: 免费版支持1个网站，每月1万次访问，基础数据分析，中英翻译；付费版支持无限网站和访问量，高级分析，全部13种语言翻译。
9. 故障排查
9.1 统计数据不显示
- 检查脚本是否正确引入
- 确认 appId 是否正确
- 查看浏览器控制台是否有报错
- 检查网络请求是否成功（Network面板）
9.2 客服按钮不显示
- 确认网站已启用客服功能
- 检查脚本是否正确引入
- 查看浏览器控制台是否有报错
9.3 翻译功能不生效
- 确认网站已启用翻译功能
- 检查脚本是否正确引入
- 确认当前版本支持所选语言（免费版仅支持中英）
9.4 跨域问题
如果遇到跨域问题，请确保服务器已配置CORS响应头：
Access-Control-Allow-Origin: * Access-Control-Allow-Methods: GET, POST, OPTIONS Access-Control-Allow-Headers: Content-Type
9.5 查看日志
服务器端日志位于：
App_Data/ai_error.log // AI相关日志 App_Data/errors.log // 错误日志
🍑 桃子统计帮助文档 · 版本 1.0
如有问题，请联系客服或查看 帮助文章