短链接
TanStack Ship 短链接系统，支持可追踪 URL、点击分析、UTM 集成、自定义别名和二维码生成。
概述
TanStack Ship 的短链接系统提供品牌化、可追踪的短 URL，可在营销活动、社交媒体和线下材料中使用。每个链接追踪点击次数、唯一访客、地理数据和 UTM 归因——为您提供链接效果的完整可见性。
作为 TanStack Ship 平台的一部分，短链接与 UTM 追踪系统（活动归因）、活动和优惠系统（分发）以及分析仪表板（点击报告）集成。
设计流程
短链接系统管理从创建到重定向再到分析报告的完整链接生命周期：
核心能力
链接创建与管理
从管理面板创建短链接（/dashboard/admin/short-links）：
- 自定义别名 — 定义自己的短路径（例如
go.yourdomain.com/summer） - 自动生成 — 系统自动生成唯一的短代码
- 目标 URL — 要重定向到的完整 URL
- UTM 参数 — 内置 UTM 构建器，用于活动归因
- 过期时间 — 可选链接过期，用于限时活动
示例 — 在 React 中创建短链接：
import { useMutation } from '@tanstack/react-query'
function CreateShortLink() {
const mutation = useMutation({
mutationFn: async (data: { url: string; alias?: string }) => {
const res = await fetch('/api/links', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(data),
})
if (!res.ok) throw new Error('创建链接失败')
return res.json()
},
})
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault()
const form = new FormData(e.target as HTMLFormElement)
mutation.mutate({ url: form.get('url') as string })
}
return (
<form onSubmit={handleSubmit}>
<input name="url" placeholder="输入目标 URL" />
<button type="submit">创建短链接</button>
{mutation.data && <p>短链接: {mutation.data.shortUrl}</p>}
</form>
)
}
点击分析
每个短链接提供全面的分析：
- 总点击数 — 链接整个生命周期的聚合点击计数
- 唯一访客 — 基于 IP 和会话的独立访客计数
- 点击时间线 — 随时间变化的点击量（日、周、月视图）
- 来源数据 — 点击来源（直接、社交、邮件等）
- 地理数据 — 访客国家和城市分布
二维码生成
每个短链接内置二维码生成器，适用于：
- 印刷材料（传单、海报、名片）
- 活动标识和广告牌
- 产品包装和店内展示
设计理念
默认可追踪
每个短链接创建时即内置分析能力——无需额外配置。从链接创建的那一刻起，点击次数、唯一访客、地理分布和来源数据被自动收集和聚合。这种零配置方法确保营销团队不会因为忘记启用追踪而丢失归因数据。分析结果在专用仪表板视图中呈现，支持时间范围筛选和活动分段。
活动归因优先
短链接被设计为一等活动分发载体。内置的 UTM 构建器确保每个链接携带活动归因参数，使每次点击都可追溯到其活动来源。与 Bitly 等通用 URL 缩短器不同（它们通常会剥离 UTM 参数或要求付费计划才能使用分析功能），该系统在整个重定向链中保留并丰富归因上下文——且无需额外成本。这使得归因分析仪表板的报告更加准确。
多渠道分发
系统通过二维码生成桥接在线和离线营销渠道。单个短链接可通过邮件、社交媒体、印刷材料和活动标识分发——所有渠道的数据汇聚到同一个分析视图。这种统一衡量方法使营销团队能够全面了解活动效果，无论使用何种分发渠道。
最佳实践
易记别名
为在线下或口头环境分享的链接使用简短、易记的别名（例如 yourbrand.com/launch）。为程序化使用保留自动生成的代码。
活动专用链接
为每个活动创建唯一的短链接，以实现准确归因。跨活动重复使用同一链接会稀释分析数据。
监控点击模式
定期审查点击分析以识别流量模式。突然的峰值可能表示病毒式传播；突然下降可能表示链接失效。
常见问题
短链接的基准 URL 是什么？
基准 URL 通过 VITE_SHORT_LINK_BASE_URL 环境变量配置。默认格式为 go.yourdomain.com。
创建后能否编辑短链接？ 可以。您可以从管理面板更新现有短链接的目标 URL、UTM 参数和别名。
点击数据保留多长时间？ 点击数据永久保留以供历史分析。仪表板提供时间范围筛选以聚焦报告。
配置
在 .dev.vars 中设置短链接的基准 URL：
VITE_SHORT_LINK_BASE_URL=https://go.yourdomain.com
链接完全从管理面板管理。无需数据库迁移——短链接 schema 已包含在标准迁移中。