D01 · DOCUMENTATIONSCANFENCE / DOCUMENTATIONQUICKSTART · API · RECIPES
工作 原理。
配置指南、API 参考、集成方案。先从快速上手开始，准备就绪后再深入技术参考。
目录
1. 入门指南
1.1 创建账户
- 访问 GeoTrack 注册页面 /signup
- 选择订阅套餐（Basic、Starter 或 Professional）
- 输入邮箱地址并设置安全密码
- 点击“创建账户”
- 系统会自动登录并跳转至你的仪表盘
注意：所有套餐均含 7 天免费试用。试用结束前不会扣款。
1.2 首次登录
首次登录时，你会看到：
- 带有快速统计数据的仪表盘（当前均为零）
- 左侧导航菜单，列出可用功能
- 一条欢迎信息，提示你创建第一个二维码
1.3 了解套餐限额
Basic 套餐（$4.99/月）
- 20 个二维码
- 每月 5,000 次扫描
- 1 名团队成员
- 7 天数据保留
- 邮件支持（48 小时响应）
Starter 套餐（$14.99/月）
- 100 个二维码
- 每月 25,000 次扫描
- 2 名团队成员
- 30 天数据保留
- 优先邮件支持（24 小时）
Professional 套餐（$44.99/月）
- 500 个二维码
- 每月 250,000 次扫描
- 10 名团队成员
- 90 天数据保留
- 优先支持 + API 访问
2. 仪表盘概览
2.1 仪表盘组成
仪表盘显示：
关键指标：
• 二维码总数：你已创建的二维码数量
• 扫描总数：所有二维码的历史累计扫描次数
• 活跃地理围栏：当前处于活跃状态的地理围栏数量
• 本月扫描：当前自然月内记录的扫描次数
3. 创建二维码
3.1 标准二维码
用途：重定向到单个 URL 的简单二维码。
步骤：
- 在导航菜单中进入“二维码”
- 点击“新建二维码”
- 选择“标准”作为类型
- 为二维码命名（例如“产品手册”）
- 输入目标 URL
- 点击“创建二维码”
适用场景：
- 产品信息页面
- 活动报名
- 联系方式
- 社交媒体主页
3.2 地理围栏二维码
用途：根据用户的实际位置将其重定向到不同的 URL。
步骤：
- 进入“二维码” → “新建二维码”
- 选择“地理围栏”作为类型
- 为二维码命名
- 输入默认 URL（当用户不在任何地理围栏内时使用）
- 点击“创建二维码”
- 进入“地理围栏”菜单，点击“创建地理围栏”
- 选择你的二维码，设置位置和半径
- 输入该位置的重定向 URL
适用场景：
- 多门店零售
- 区域内容分发
- 针对特定位置的优惠
- 活动场馆导航
3.3 多地点二维码
用途：从预设列表中自动将用户重定向到最近的位置。
工作原理：
- 用户扫描二维码
- 系统检测用户的 GPS 坐标
- 计算到所有位置的距离
- 重定向到最近的一处
适用场景：
- 加盟连锁企业
- 连锁餐厅
- 拥有多个办事处的服务商
- 门店查找
3.4 添加基于时间的规则
你可以为任意二维码添加基于时间的路由，根据用户扫描的时间进行重定向。
配置项：
- 星期：选择此规则适用于哪几天
- 时间范围：设置开始和结束时间（24 小时制）
- 日期范围：可选的特定日期范围
- 优先级：数字越大优先级越高
- 目标 URL：该时间段内的重定向地址
示例：
- 餐厅菜单（早餐、午餐、晚餐）
- 营业时间与非营业时间信息
- 季节性内容
- 针对特定活动的重定向
3.5 设置扫描次数上限
通过扫描次数上限营造稀缺感和紧迫感。
适用场景：
- 限时优惠（“前 100 名顾客享 20% 折扣”）
- 专属访问码
- 活动人数管理
- 促销活动
4. 管理地理围栏
4.1 创建地理围栏
- 在导航中进入“地理围栏”
- 点击“创建地理围栏”
- 选择要设置地理围栏的二维码
- 输入位置信息（地址或坐标）
- 设置半径，单位为米（默认：100m）
- 输入该地理围栏的重定向 URL
- 点击“创建地理围栏”
4.2 地理围栏最佳实践
半径选择：
- 城区：50-100 米（GPS 精度高）
- 郊区：100-300 米（精度中等）
- 乡村：300-1000 米（GPS 精度较低）
重叠的地理围栏：
- 当地理围栏重叠时，系统采用最近的中心点
- 使用优先级设置来控制行为
- 在地理围栏重叠的区域充分测试
5. 分析与报表
5.1 分析仪表盘
概览指标：
- 扫描总数（历史累计）
- 独立扫描数
- 本月扫描数
- 扫描增长百分比
图表：
- 扫描时间线（按日/周/月）
- 地理分布
- 设备构成（移动端与桌面端）
- 浏览器统计
5.2 扫描地图
交互式地图会显示：
- 每个扫描位置的标记点
- 当附近有多次扫描时的聚合标记
- 点击标记查看扫描详情
- 缩放和平移以浏览各区域
5.3 导出数据
步骤：
- 进入分析页面
- 设置所需的筛选条件
- 点击“导出数据”
- 选择格式（CSV）
- 下载文件
导出数据包含：
- 时间戳、二维码名称、位置
- 设备类型、浏览器、操作系统
- User agent 字符串
6. 团队管理
6.1 团队角色
管理员
• 拥有所有功能的完全权限
• 邀请/移除团队成员
• 管理计费
• 查看全部分析数据
• 访问设置
经理
• 创建/管理二维码
• 创建/管理地理围栏
• 查看全部分析数据
• 不能管理团队
• 不能访问计费
现场用户
• 创建二维码
• 仅查看自己的二维码
• 有限的分析访问权限
• 不能管理地理围栏
• 不能访问计费
6.2 邀请团队成员
- 在导航中进入“团队”（须为管理员）
- 点击“邀请团队成员”
- 输入对方的邮箱地址
- 选择其角色（管理员、经理或现场用户）
- 点击“发送邀请”
- 受邀者会收到带有接受链接的邮件
注意：你只能在套餐允许的名额内邀请成员（Basic：1，Starter：2，Professional：10）
7. 订阅与计费
7.1 查看订阅状态
状态标识：
- 活跃：订阅正常且处于生效状态
- 试用：处于 7 天试用期内
- 逾期：扣款失败，正在重试
- 已取消：已取消，但在本计费周期结束前仍有效
- 已过期：订阅已结束
7.2 升级套餐
- 进入“定价”页面或仪表盘
- 在所需套餐上点击“升级”
- 查看新套餐的功能和限额
- 确认升级
- 立即按比例收取费用
- 新限额立即生效
8. 高级功能
8.1 组合地理围栏与时间规则
示例场景：连锁餐厅
- 创建一个多地点二维码
- 为每家餐厅位置添加地理围栏
- 为菜单添加基于时间的规则（早餐、午餐、晚餐）
优先级机制：
- 地理围栏 + 时间规则同时匹配 = 最高优先级
- 仅地理围栏匹配 = 中等优先级
- 仅时间规则匹配 = 低优先级
- 无匹配 = 默认 URL
8.2 动态 URL 参数
将本次扫描的信息传递到你的目标 URL：
可用参数：
{scan_id}– 唯一扫描标识符{qr_code_id}– 二维码标识符{timestamp}– Unix 时间戳{lat}– 纬度{lng}– 经度
https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}9. 故障排查
9.1 二维码无法扫描
可能原因：
- 二维码图像质量过低
- 光线条件不佳
- 相机对焦问题
- 二维码过小或过大
解决方法：
- 下载更高分辨率的二维码（300×300 或 500×500）
- 确保对比度良好（浅底深码）
- 打印时保持至少 2cm x 2cm 的尺寸
9.2 定位错误
原因：
- 设备已关闭 GPS
- 室内定位（GPS 信号弱）
- 设备 GPS 精度低
- 用户拒绝了定位权限
解决方法：
- 提示用户开启定位服务
- 室内使用时增大地理围栏半径
- 为定位失败提供备用 URL
9.3 地理围栏不生效
检查清单：
- 地理围栏是否处于活跃状态？（在仪表盘查看状态）
- 二维码类型是否设为“地理围栏”？
- 半径是否适合该区域？
- 是否在已开启定位的设备上测试过？
- 坐标是否正确？（在地图上核对）
10. 最佳实践
10.1 二维码设计
✓ 应做：
- 使用高对比度（黑底白字最理想）
- 在二维码周围留出空白（静区）
- 批量打印前先测试
- 配上清晰的行动号召文案
✗ 勿做：
- 使用降低对比度的颜色
- 把二维码做得太小（最小 2cm x 2cm）
- 贴在弯曲表面上
- 使用低分辨率图像
10.2 地理围栏策略
规划：
- 先梳理出所有位置
- 为每处确定合适的半径
- 考虑各区域的 GPS 精度
- 测试重叠场景
优化：
- 先设较大半径，测试后再收窄
- 用分析数据验证地理围栏的准确性
- 根据真实扫描数据进行调整
10.3 安全与隐私
保护你的账户：
- 使用高强度、唯一的密码
- 启用双重身份验证（即将推出）
- 不要共享登录凭据
- 定期审查团队成员的访问权限
用户隐私：
- 仅收集必要的位置信息
- 遵守 GDPR/隐私法规
- 用 HTTPS 保护目标 URL