Skip to content

Latest commit

 

History

History
170 lines (125 loc) · 16.3 KB

File metadata and controls

170 lines (125 loc) · 16.3 KB

Urgizat · 产品说明书

一句话定位:让做海外获客的个人创业者与小团队,无需开发,几分钟内基于行业模板(或 AI 一句话生成)做出一张投放级落地页,发布到自己的品牌域名,并把「像素追踪 → 留资 → 线索管理 → CRM 推送」整条获客链路跑通。

文档类型 产品说明书(现状版,2026-07-23 同步)
状态 产品已上线生产(https://urgizat.com ,2026-07-16 上线,07-19 生产 smoke 8/8 通过)
面向读者 产品、运营、新成员
关联文档 早期简版 PRD:docs/landing-page-flow-product-overview.md;产品/工程约束:docs/constraints/*;自定义域名架构:docs/custom-domain-publishing.md

一、产品定位

Urgizat 是一个 SaaS 落地页搭建与获客工具(Landing Page Builder / lead-gen 工具),聚焦**海外获客(leadgen)**场景:

  • 品类:自助式落地页搭建器 + 投放追踪 + 线索管理。
  • 转化方式(核心红线:非交易):生成的落地页只引导访客通过 WhatsApp / Telegram / 表单 / 电话 / 邮件 / 预约咨询留资,绝不包含下单、结账、购物车、订单、订阅、退款、货到付款等任何电商交易环节。平台自身向 SaaS 客户收费(订阅套餐 + AI 额度包,Dodo / Creem 双收款渠道),但平台收费与生成页面的能力边界严格分离。
  • 价值主张选模板(或 AI 生成)→ 改内容 → 发布到自有域名,几分钟上线;页面跑在用户自己的品牌域名上,利于品牌、SEO 与投放可信度;像素/CAPI/线索链路开箱即用。

目标用户与 JTBD

  • 主要用户:做海外获客的个人创业者与小型企业(广告投手、独立卖家、本地服务商、小型 Agency)。
  • 要完成的任务:「我要快速上线一张能跑广告、能收线索的落地页,不写代码、不求人;像素归因要配得上,线索要收得到。」
  • 痛点:建站门槛高、改文案要找开发、投放像素与归因难配、上线慢、同模板页面被广告平台判重(同质化风险)。

二、三端架构与角色

路由 面向 职责
官网(marketing) //pricing/anti-ban/templates 潜在用户 营销首页、定价页、反同质化叙事页、公开模板画廊(SEO 获客面,48 套模板列表 + 样稿 live 渲染详情页,深链注册后直达建页);转化为注册用户
admin(租户后台) /admin/* 租户(USER 落地页、线索、分析、域名、素材、账单的自助管理——产品主体;概览含「4 步上线」上手清单
super-admin(平台后台) /super-admin/* 平台运营(SUPER_ADMIN 管理租户/用户、平台设置、数据看板(含注册→建页→域名→发布→首线索激活漏斗与 TTFP 中位数)
  • 认证:NextAuth,邮箱验证码(OTP)免密登录为主 + Google 一键登录(密码登录入口已下线,仅存量兜底);注册即赠 Pro 全功能试用 7 天(复用赠送套餐机制,到期自动回落 Free)。数据按用户隔离,仅本人可见可改。
  • 公开面:已发布落地页在用户自有域名对外公开(按 host 多租户渲染);预览路径 /p/[slug];编辑与后台需登录;未知路由渲染 404。

三、用户旅程(端到端)

访问官网 → 注册/登录 → 建页(模板 / AI 一键生成)→ 编辑(自动保存)→ 预览 → 绑定并验证自有域名 → 发布 → 广告投放(像素 + CAPI 归因)→ 访客留资 → 线索收件箱 / Webhook 推 CRM → 数据看板复盘

步骤 用户做什么 产品提供什么
① 建页 「新建」→ 选行业模板,或 AI 一句话生成整页 30+ 行业模板;AI 生成含文案 + Unsplash 自动配图
② 编辑 可视化调整各区块文案、图片、CTA 自动保存;撤销/重做(Cmd+Z,50 步,AI 生成可一步撤销);区块增删排序;MediaPicker(Unsplash + 上传)
③ 预览 编辑器内手机/桌面实时预览 + 全屏预览 所见即发布后效果;草稿可分享预览链接
④ 发布 选择已验证的自有域名并确认 发布前校验(结构完整性、WhatsApp 占位号拦截等,问题项可点击定位);快照制发布——发布后编辑只改草稿、线上不变,「更新发布」才切新版
⑤ 投放 在 Meta/TikTok/Google 后台配广告 客户端像素 + 服务端 CAPI 回传 + UTM 归因
⑥ 收线索 访客提交表单 / 点 WhatsApp 线索收件箱;Webhook 实时推送 CRM(含签名与重试)
⑦ 复盘 看数据 分析看板:曝光 → CTA 点击 → 线索的转化漏斗

四、核心功能

1. 模板库与 AI 建页

  • 48 套行业模板,分两梯队,全程非交易,高风险品类强制 disclaimer,四档套餐全量开放模板
    • 第一梯队(电商种草留资):6 行业 × 5 子品类共 29 套 + solar/dental 等,主转化走 WhatsApp。
    • 第二梯队(服务与 B2B 线索,2026-07-30 新增 15 套):b2b 5 套(OEM 询价、工业设备选型、定制包装打样、国际物流运价、SaaS demo 预约)、education 4 套(留学咨询、语言培训、职业技能在线课、K12 辅导)、legal 1 套(移民法律)、local-service 5 套(保洁、搬家、暖通空调急修、屋顶外墙翻新、园艺景观),共四个新行业大类。这类品类天然靠表单转化,故主 CTA 可指向页内留资表单(#lead-form 锚点),详见 docs/lead-capture-channels.md
  • AI 一键生成整页:按行业/描述生成文案与结构,自动 Unsplash 配图(含前后对比、头像等素材对),多 LLM 适配(Qwen/Gemini/DeepSeek/OpenRouter)。AI 生成/改写按套餐计额度。

2. 可视化编辑器

  • 12 种可排序内容区块:数据展示、套餐(Offer,纯展示文案无账单语义)、产品、前后对比、服务流程、信任、特性、评价、产品故事、倒计时、常见问题、安全保障;另有 LeadForm 留资表单区块
  • 3 个页面级固定件:首屏 Hero、页脚 Footer(必含合规链接)、悬浮按钮。
  • 自动保存、双重预览(编辑器内实时 + 全屏)、SEO 编辑面板(title/description/OG 等 + JSON-LD 派生)、品牌主题(6 套主题色)。

3. 发布与自有域名

  • 只能发布到用户自己已绑定并验证的域名(平台不提供公共子路径/共享子域名托管;Free 档无域名额度,可在线预览但发布需升级)。
  • 不支持中国大陆管辖域名:添加域名时拦截 .cn 全系(含 .com.cn/.gov.cn 等二级)及大陆 IDN 顶级域(.中国/.中國/.公司/.网络,按 punycode 判断),此类域名受备案与注册局政策影响(实名核验、serverHold 暂停解析),不适合发布出海落地页;前端表单即时提示 + API 兜底(错误码 domain_tld_blocked)。
  • 同域名多路径发布:一个域名可承载多张已发布页,各占一个路径(根路径 / 与最多两级的 /invisalign/services/whitening)。适合诊所、律所、教培等同品牌多服务页的场景。
    • 路径规则:小写字母、数字、连字符,最多两级;/api/_next/robots.txt/sitemap.xml/llms.txt/favicon.ico 为平台保留,不可占用。
    • 一页一位置:一张落地页同一时间只能发布在一个位置;改发到别处会自动释放原位置。需要同内容多处上线请先复制页面。
    • 同一位置重复发布为覆盖式替换(原页面从该位置下线、旧投放链接失效),发布弹窗会就该位置显式二次确认。
    • 根路径需单独发布:只发了 /invisalign 而没发根路径时,直接访问域名会 404(不会回落到任意子页),域名列表会就此显式提示。
    • 未绑定的路径一律 404,不回落到其他页面——回落会让每个错误路径都变成一份重复内容。
  • 发布额度与降档处置:可发布页数 = 套餐的落地页额度(Free 1 / Starter 5 / Pro 20 / Agency 无限),与域名数无关;域名额度限制的是品牌数,不是发布规模。
    • 已发布页数超出额度时(通常因降档或赠送套餐到期),已上线页面不受影响,但无法再发布新页面;已发布页的「更新发布」仍放行。
    • 进入超额状态起 7 天宽限,后台横幅与邮件同时提示。宽限内自行取消发布到达标即自动解除,无需联系客服。
    • 宽限结束后自动取消发布超出的部分:优先保留域名根路径页,其余按发布时间保留最早的。这是 unpublish 不是删除——页面内容完整保留,升级套餐后可一键重新发布。
    • 计时与执行由每日任务对账,精度为天级,故文案写「7 天后」而非精确时刻。
  • 投放风控建议(非系统强制):广告平台的封禁与信誉以域名为单位,把多个不同 offer 放在同一域名下会共担连坐风险。做付费投放时建议仍按「一域名一 offer」组织,用不同域名隔离不同 campaign;同品牌的多个服务页共用一个域名则没有这个问题。
  • 多注册商 DNS 指引、按 host 的多租户渲染、发布前校验、再编辑(快照制:只改草稿,「更新发布」才上线)/取消发布/删除全应用内闭环。

4. 投放追踪与归因

  • 基础像素(四档全含,体验漏斗):1× Meta Pixel 客户端追踪。
  • 多平台追踪 + CAPI(Pro/Agency):Meta / TikTok / Google 客户端追踪 + Meta / TikTok 服务端转化回传(落库入队 + 即时 flush,cron 每日兜底),绕过 iOS/广告拦截提升 ROAS。
  • 事件口径全部 lead-gen 化:Lead / Contact / FormSubmit / WhatsAppClick,无任何 purchase/checkout 事件。
  • 合规:欧盟/EEA/GB 访客 CMP Cookie 同意门控,第一方埋点随同意状态放行。

5. 线索管理与通知

  • 线索收件箱/admin/leads):查看、筛选留资线索。
  • 新线索邮件通知(四档全含,可关):留资实时发送邮件到注册邮箱。
  • 线索 Webhook(Pro/Agency):新线索实时 POST 到用户 CRM / Zapier / Make,含签名与失败重试。
  • 每周获客周报(默认开,可在「设置 → 线索通知」退订):每周一汇总近 7 天各已发布页曝光 / CTA 点击 / 线索与环比;无已发布页或全零用户跳过。
  • 归因:识别线索来自哪个 CTA / 表单 / 渠道。

6. 反同质化(Agency 专属)

  • 更换页面变体种子打散同模板页面的结构指纹,降低被广告平台判重的概率(8 组 salt,明确不做 cloaking)。官网有专门叙事页 /anti-ban。对外统一命名「反同质化」。

7. 分析看板

  • 投放分析页:曝光 → CTA 点击 → 线索的转化漏斗、线索统计、流量数据。

五、套餐与商业化(lib/plans.ts,Dodo / Creem 双收款渠道)

收款货币为美元(2026-07-30 由 CN¥ 切换)。中文面在美元价旁展示「约 ¥xx」参考换算,汇率由 lib/pricing/fx-server.ts 按天取自公开接口、异常时回落常量;换算仅供参考,实际扣款金额以收款渠道产品配置为准。

权益 Free $0 Starter $5.99/月 Pro $19.99/月(主推) Agency $49.99/月
落地页数 1 3 20 无限
自定义域名 0(不可发布) 1 5 无限
AI 整页生成 / 月 3 15 80 300
AI 改写 / 月 10 100 无限 无限
全量模板
基础 Meta Pixel
去品牌水印
多平台追踪 + CAPI
线索 Webhook
反同质化

所有布尔权益均有服务端执行点门控(已于 2026-07-19 全量核验一致);数量限额服务端真实拦截。

补充机制(2026-07-23 同步):

  • 收款渠道抽象:Dodo / Creem 双 provider(lib/billing/),active provider 存于平台设置、super-admin 可切换;webhook 端点各自独立,事件规范化为订阅激活 / 结束 / 周期末取消 / credit 到账四种语义。
  • AI 额度充值包lib/credits.ts):一次性购买,credit 永不过期——50 次 $4.99、200 次 $14.99;仅「AI 整页生成」消耗 credit,改写额度用尽只能等次月或升级(有意的升级驱动)。
  • 注册试用:新用户建号即赠 Pro 7 天(写入 comp_plan,到期由 activeCompPlan 自动回落);与超管赠送同机制,生效套餐 = max(付费档, 赠送档)。
  • 超管赠送:super-admin 可按用户赠送任意档位与期限(永久或定期)。

六、关键约束(硬红线)

  1. 非交易:生成页面的 schema、文案、组件、SEO、埋点事件、模板一律不得引入交易语义(无 PaymentTrust/ShippingInfo 区块,Offer 的 priceText 仅为展示文案)。
  2. 自有域名发布:未绑定验证自有域名不能发布,无公共托管路径。
  3. 线索有效性primaryConversion 必填且指向真实留资路径(URL/电话/邮箱/表单);lead form 至少收集一个可触达联系字段(phone/email/whatsapp/telegram),仅 name 不算线索;每页至多一个 leadForm。
  4. 合规结构:页脚必含合规链接;高风险品类(健康/美容/金融等)支持 disclaimer、避免保证性承诺;欧盟流量走 CMP 同意。
  5. 工程:Tailwind only(无自定义 CSS/内联样式);proxy.ts 做中间件;中文 Conventional Commits。

七、技术形态(简)

  • :Next.js(App Router,部署 Vercel)+ Postgres(Neon,手动 SQL 迁移 node-pg-migrate)+ Vercel Blob(素材)+ NextAuth(OTP + Google)+ Ant Design(后台)/ Tailwind + Radix(编辑器与公开页)+ Dodo / Creem(计费)+ Resend(邮件)+ Sentry / Speed Insights(监控)。
  • 代码分区app/(三端路由 + API)、landing-editor/(编辑器与模板样例)、landing-renderer/(公开页渲染、变体、水印、追踪)、lib/(plans/tracking/capi/leads/proxy 等域逻辑)、types/schema.ts + lib/schema.zod.ts(落地页 schema 单一事实源)。
  • 平台约束:Vercel Hobby 计划 cron 最快每日一次且数量有限——异步投递(CAPI/Webhook)happy-path 靠落库后 after() 即时 flush;兜底与周报合并为单一每日编排器 /api/cron/daily(依次 CAPI 重发、webhook 重投、周报仅周一发送)。

八、现状与路线

已上线(截至 2026-07-23):上述全部核心功能均在生产可用;上线就绪审计已清零,真机全链路走查已完成(07-20/07-22)。07-23 增量:平台激活漏斗埋点与 super-admin 漏斗看板、注册赠 Pro 试用 7 天、admin 上手清单、公开模板画廊 /templates(SEO 获客面 + sitemap)、每周获客周报邮件。

待做 / 路线方向

  • 第二梯队线索类模板已开工(2026-07-30 首批 5 套上线:B2B/OEM、SaaS demo、留学、移民法律、本地保洁);金融、医疗、本地到店等其余品类待排。
  • A/B 测试、退出挽留、实时社会证明等转化优化。
  • 多语言落地页与地域切换、版本历史与回滚、定时发布、团队协作、模板市场、内置数据看板深化。
  • 已明确不做:AI 翻译(已下架)、任何交易/支付类能力(红线)。

九、术语表

术语 含义
租户 admin 端付费用户(角色 USER),只管自己的页面与数据
区块 / 固定件 落地页内容单元:12 种可排序区块 + Hero/Footer/悬浮按钮 3 固定件
primaryConversion 每页必有的主转化路径(whatsapp/表单/电话/邮箱等)
LeadForm 留资表单区块,每页至多一个,webhook 出站需 Pro+
CAPI 服务端转化 API(Meta/TikTok),绕过客户端拦截回传转化
反同质化 Agency 权益:变体种子打散同模板结构指纹,降低判重
草稿 / 已发布 仅已发布页在自有域名对外可访问;线上内容为发布时快照,草稿修改需「更新发布」才生效;草稿可分享预览