skill-short-link · 短链与 UTM 追踪

给内容/投放链接拼接 UTM 追踪参数(来源/媒介/活动)并缩短,便于在小红书、抖音、公众号等渠道追踪流量来源与活动效果。
走免 key 公共短链服务(TinyURL / is.gd / v.gd),纯标准库实现无依赖。支持三种操作:只拼 UTM、只缩短、一步到位拼 UTM 并缩短;is.gd / v.gd 支持自定义短码。
调用示例:在聊天框中说"给这个商品链接生成小红书投放用的短链,活动名 618"。
产品详解
定位
skill-short-link 是投放链接的追踪工具:给链接拼 UTM 参数并缩短,让每个渠道的流量可归因。它解决"链接从哪来、效果如何"的问题,不做数据分析本身。
核心能力
- UTM 参数拼接:utm_source / medium / campaign / term / content,遵循 GA 通用追踪标准。
- 短链缩短:TinyURL(默认,最稳)、is.gd / v.gd(支持
--alias自定义短码)。 - 三种操作:
utm只拼参数、short只缩短、both一步到位。 - 纯标准库实现:无第三方依赖。
- 多素材 A/B:
--content区分同活动多素材(如"视频A"/"图文B")。
工作流程
- 提供落地页/商品/表单链接
- 指定 UTM 三要素:source(来源平台)、medium(媒介)、campaign(活动名)
- 运行
shortlink.py(both最常用),得到带参数的短链 - 多平台投放:每个平台生成独立短链(source 不同),分平台归因
输入与输出
| 输入 | 必填 | 说明 |
|---|---|---|
| URL | 是 | 落地页/商品/表单链接 |
| source | UTM 时必填 | 来源平台,如 xiaohongshu / douyin / wechat |
| medium | UTM 时必填 | 媒介,如 social / video / cpc |
| campaign | UTM 时必填 | 活动名,如 618 / newproduct |
| provider | 否 | tinyurl(默认)/ isgd / vgd |
输出:带 UTM 参数的短链。
与相邻 skill 的区别
- 本 skill 负责链接层面的来源标记;投放效果的计算与评价见 roi-calculator;发布排期与记录见 skill-publish-scheduler / skill-publish-log。
适用场景
- 多平台投放时区分各渠道流量来源
- 小红书/抖音/公众号等不便于放长链的场景
- 同活动多素材的 A/B 效果对比
- 给 KOL/KOC 分发带身份标记的推广链接
使用前准备
- 无需 API key,用免 key 公共短链服务。
- 规则:每个投放渠道生成独立短链(utm_source 区分),否则无法分平台归因;campaign 用统一命名规范,方便后续聚合。
- 注意:短链服务为第三方公共服务,重要投放建议自建短链域名;is.gd / v.gd 对部分域名有黑名单。
skill-short-link 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。