文档目录
Velotrak 里的落地页
更新于 2026年11月17日
落地页要么是 Velotrak 在 /lp/<id>/ 上提供的文件,要么是一个外部 URL。上传不超过 25 MiB 的 ZIP,或在文件接口里编辑 HTML、CSS 和 JS。把 index.html 放在根上,落地页地址才有页面。
创建落地页
选择 hosted 或 external。外部落地页的 path_or_url 必须是 http 或 https。托管落地页把文件存在数据目录里。状态是 active、paused 或 draft。暂停的落地页不会再分给新点击。可以打开 inject_js,它会追加追踪脚本 /velotrak.js。
LP Protect(protect_enabled)是 Pro 功能,Founder 与 Pro 相同。Free 会拒绝这个开关。打开后,点击会带一个绑定 IP 和 User-Agent 的短期 vt_lp 令牌(5 分钟)。有效访问随后得到 2 小时的会话 cookie。其他人收到空白的 403 页面。纯 HTTP 上的预览可能加载不出该页的 CSS 和 JS。操作员能上传页面之前,给后台单独的主机名;在后台主机上打开的落地页会被放进沙箱,但单独的后台域名才是服务器文档里的隔离方式。
上传 ZIP
POST /api/landers/{id}/upload 读取一个 multipart 文件。压缩包可以到 25 MiB。请求本身最多读到 26 MiB。解压允许去掉垃圾文件后最多 500 项、每项 25 MiB、未压缩合计 100 MiB。含 .. 的路径、符号链接和目录项会被拒绝。__MACOSX 和 .DS_Store 会被去掉。只有一层文件夹的 ZIP 会被展开。
/lp/<id>/ 提供落地页根上的 index.html。文件名区分大小写。ZIP 里没有 index.html 时,上传响应包含 warning: no_index 以及它找到的 HTML 文件。
编辑文件
文件接口是 /api/landers/{id}/files 和 /api/landers/{id}/files/<路径> 上的 GET、PUT、DELETE。文本扩展名是 .html、.htm、.css、.js、.json、.txt、.svg、.xml、.md。单个文件最多 2 MiB。同样的调用也是 MCP 工具(list_lander_files、read_lander_file、write_lander_file、delete_lander_file)。写入和删除会先要求确认 diff。见 MCP。
宏和预览
落地页 URL 带 click_id 时,HTML 里这些记号会被替换:click_id、campaign_id、flow_id、lander_id、offer_id、country、device、os、browser、token1–token10、zone 和 {offer_link}。{offer_link} 变成 /go 或 /go?cid=...。
预览是 POST /api/landers/{id}/preview-link。相对地址使用 click_id=preview 和示例值(国家 US、设备 Mobile、系统 iOS、浏览器 Safari),打开了 LP Protect 时还会带 vt_lp。
公开页面是 GET /lp/<落地页 id>/<路径>。缺文件则 404。活动如何路由见概念。