登陸頁面上線
準備一個已建置的登陸頁面上線:主機託管、頁面分析、針對其唯一行動呼籲的轉換事件、一個可運作的潛在客戶表單、可選的 A/B 測試,以及一個上線檢查清單。此技能會在本機端進行準備和測試。未經使用者同意,絕不進行部署或變更 DNS。
Cloudflare 指令、配置鍵和限制會有所變更。此處的內容已根據 Cloudflare 2026-10-04 的文件進行過檢查,Worker 程式碼使用 Wrangler 4.147.0 執行。在依賴任何指令或限制之前,請先確認當前 Cloudflare 文件中的內容,若文件與此技能有不一致之處,請以文件為準。
輸入
首先讀取檔案,僅在一則訊息中向使用者詢問他們未提供的資訊。
| 輸入 | 來源 | 若缺失 |
|---|---|---|
已建置的頁面,以及表單提交到此技能的 Worker 時所需的 /thanks/ 和 /form-error/ | 建置輸出(dist/、public/、匯出資料夾),由 landing-skills:landing-build 寫入 | 執行建置。如果還沒有頁面,則停止並說明頁面應該優先準備(landing-skills:landing-build)。 |
轉換動作:表單或外部頁面、表單欄位、端點狀態(none yet 或 URL),或外部 URL | landing/brief.md 中的 Conversion action | 從頁面讀取:表單的 action 和每個欄位的 name,或主要連結。用一個問題與使用者確認。 |
表單提交的每個欄位 name 以及端點狀態 | 建置的交接資訊;否則為已建置表單的 name 屬性 | 從已建置的表單中讀取。 |
| 網域 | landing/brief.md 中的 Domain | 詢問。如果仍是 unknown,則使用 workers.dev 位址,並將網域相關項目標記為待處理。 |
聯絡途徑,用於 /form-error/ 和頁尾 | landing/brief.md 中的 Contact routes | 詢問。在獲得回覆前,顯示一個可見的 [PLACEHOLDER: ...],項目標記為待處理。 |
| 表單、感謝和錯誤訊息 | landing/copy.md | 使用頁面語言撰寫簡短、平實的訊息,並列出供使用者批准。 |
| 主機託管選擇 | 使用者 | 推薦 Cloudflare(如下)。如果他們拒絕,則轉到「不使用 Cloudflare」。 |
| 隱私權聲明 | 頁面的頁尾和表單 | 向使用者詢問;在此之前顯示一個可見的 [PLACEHOLDER: ...],項目標記為待處理。切勿自行編造。 |
此技能會寫入的內容:主機託管配置、必要時的表單 Worker、分析程式碼片段和轉換事件,以及包含檢查清單的 landing/launch.md。它不會撰寫文案或改寫已建置頁面的內容。
在撰寫任何配置之前,先識別技術棧(純 HTML、Astro、使用 React 的 Vite、Next.js)及其輸出資料夾。
建議
建議將所有三項工作交給 Cloudflare,並使用以下說詞解釋原因:
- 主機託管: Workers 靜態資產用來服務頁面;靜態請求在 Free 方案下是免費且無限制的,而且 Cloudflare 建議新專案使用 Workers 而非 Pages。同一個專案可以為表單運行一個小型 Worker,因此頁面無需其他後端。
- 分析: Cloudflare Web Analytics 不需要 Cookie 或指紋辨識即可計算流量和 Core Web Vitals。它沒有自訂事件,因此轉換由同一個帳戶中的 Workers Analytics Engine(也屬於 Free 方案,免費使用)中的 Worker 進行計算。
- A/B 測試: 同一個 Worker 可以在頁面提供之前,在邊緣端分配變體。不需要客戶端測試腳本、不會有閃爍問題,且在 JavaScript 關閉時也能運作。
同時說明成本:自訂網域需要將該網域的 DNS 託管在 Cloudflare 上,而且每個運行 Worker 的請求都會計入 Free 方案每天 100,000 次的上限。
流程
-
讀取輸入。 從
landing/brief.md擷取轉換動作(表單或外部頁面、其欄位、端點狀態)、網域和聯絡途徑。從已建置的頁面中,記錄每個表單及其action和欄位名稱,以及每個行動呼籲連結。僅詢問仍缺失的資訊。然後根據情況選擇,這將決定你要新增的內容:
- 表單,端點
none yet(表單提交至/api/lead,但尚無任何服務提供此端點):表單 Worker,步驟 4 和 5。 - 表單,端點已存在: 不需要表單 Worker 和 Turnstile。檢查表單是否提交到該端點,以及結果頁面是否與其回傳的內容相符,並記錄驗證和垃圾郵件防護是該端點的工作。
- 外部頁面(結帳、預訂、應用程式商店):無需處理表單。連結指向真實 URL,並在步驟 5 中使用信標計算點擊次數;檢查清單中的表單項目標記為
n/a。
- 表單,端點
-
先修復死胡同。 在建置中搜尋 action 沒有指向任何地方或提交動作被取消的表單、僅顯示感謝訊息的提交處理器、指向純
#的連結,以及連結到其所在區塊的按鈕。這些都表示轉換不存在。表單將在步驟 4 中取得 Worker 端點;連結則取得使用者的真實 URL,或一個可見的[PLACEHOLDER: ...]和一個待處理的檢查清單項目。 -
主機託管配置。 為該技術棧撰寫
wrangler.jsonc,在專案中安裝 Wrangler,若缺少則新增404.html,並且僅在有內容需要放置時才新增_headers或_redirects。閱讀references/hosting.md。 -
表單端點(表單,端點
none yet)。 新增表單 Worker:伺服器端驗證、使用 Siteverify 進行的 Turnstile 驗證、D1 儲存,以及 JavaScript 和非 JavaScript 回應路徑。在建置的表單中新增 Turnstile 小工具;保留建置的標記和增強腳本。檢查/thanks/和/form-error/是否存在,以及/form-error/是否提供簡報中的聯絡途徑。僅在缺少結果頁面時才建立,且絕不覆蓋:它們屬於landing-skills:landing-build。閱讀references/forms.md。每個欄位都需處理。 列出表單提交的每個欄位
name,並在 Worker 的FIELDS表中為每個欄位建立一個條目(是否必填、長度上限、有意義的格式檢查,否則為帶有上限的文字)、在leads表中建立一個欄位,以及一個能容納它們的MAX_BYTES。未經驗證的資料不儲存。Worker 未處理的已提交欄位將導致檢查清單失敗;Worker 會以unknown_field拒絕此類 POST,這使得差距在測試中顯而易見,但在該欄位被新增之前,訪客的提交仍然會遺失。 -
分析和轉換事件。 在每個頁面中新增 Web Analytics 程式碼片段,並在 Analytics Engine 中記錄轉換:如果你新增了表單 Worker,則在該 Worker 中記錄;如果是連結,則透過信標記錄。對於已存在的端點,轉換會根據該端點的記錄進行計算,而信標則是一個選項。閱讀
references/analytics.md。 -
A/B 測試,僅在被要求時進行。 在撰寫任何程式碼之前,先就一項變更、基準線、值得採取行動的最小差異以及樣本量達成一致。然後新增變體檔案和 A/B Worker。閱讀
references/ab-testing.md。 -
在本機端進行測試。 使用 Turnstile 測試金鑰在
.dev.vars中執行npx wrangler dev,並使用 curl 和瀏覽器測試每個路徑:包含所有欄位的有效 POST、無效的電子郵件、每個欄位超過其上限、Turnstile 驗證失敗、JavaScript 關閉時的情況;以及測試:變體分配、第二次請求時的黏性 Cookie、轉換端點。然後執行npx wrangler deploy --dry-run並檢查資產數量和大小。本機端運行不需要帳戶。在繼續之前修復任何失敗的問題。 -
等待用戶許可。 部署、建立預覽、新增自訂網域或路由、建立 D1 資料庫、執行
d1 execute --remote、設定密碼、建立 Turnstile 小工具,以及將站點新增到 Web Analytics 都會變更使用者的 Cloudflare 帳戶,而部署或 DNS 變更會立即對公眾可見。使用者可能正在審查中,網域可能仍在服務舊站點,錯誤的 DNS 變更可能導致即時站點下線。因此,列出每個面向外部的步驟,包含確切指令及其將變更的內容,並且僅在使用者在該時刻對該步驟表示同意時才執行。對一個步驟的同意不代表對下一個步驟的同意。如果使用者更喜歡自己執行,則依序提供指令。 -
部署後(與使用者一起)。 提交即時表單一次,在 D1 中確認資料列,在 Analytics Engine 中確認轉換,確認 Web Analytics 顯示了訪問,並檢查檢查清單中僅能在即時環境下檢查的項目。
-
撰寫
landing/launch.md。 記錄主機託管設定、轉換動作及其計算方式、A/B 計畫(如果有)、面向外部步驟的指令,以及上線檢查清單,每個項目標記為done、pending、fail或n/a,並為每個不是done的項目提供原因。向使用者展示檢查清單。
上線檢查清單
將此內容複製到 landing/launch.md 中,並將每一行標記為 done、pending (reason)、fail (reason) 或 n/a (reason)。你無法檢查的項目標記為待處理,絕非已完成。當行動呼籲是外部頁面時,表單項目為 n/a。
轉換
- 行動呼籲導向一個可運作的動作:表單提交到
/api/lead(或使用者現有的端點),或者連結指向使用者的真實 URL。不能有href="#"、不能是自身錨點、不能是假的成功。 - 表單提交的每個欄位
name都在FIELDS表中有一個包含長度上限的條目,並在leads表中有一個欄位。任何未處理的欄位都是失敗,絕非通過。 - 對於已存在的端點:它針對
Accept: application/json回傳包含ok的 JSON,否則重新導向到/thanks/或/form-error/,或者結果頁面與其實際回傳的內容相符;驗證和垃圾郵件防護被記錄為其工作。 - 當表單提交到此技能的 Worker 時:
/thanks/和/form-error/存在(建置自身的頁面,未被覆寫),並且/form-error/提供簡報中的聯絡途徑。對於已存在的端點,頁面需與其回傳的內容相符;對於外部連結,則為n/a。 - 表單已在本機端測試:有效 POST、無效電子郵件、Turnstile 驗證失敗、JavaScript 關閉(導向
/form-error/)。 - 按鈕在發送期間被禁用;成功和錯誤透過
role="status"元素進行宣告。 - 蜜罐欄位從視覺和輔助技術中隱藏。
- 部署後即時表單已測試一次;資料列存在於 D1 中。
- 除非使用者有發送確認郵件的方式,否則不要承諾發送確認郵件。
衡量
- Web Analytics 程式碼片段已使用真實權杖(token)存在於每個頁面(待處理:在權杖存在之前,程式碼片段位於 HTML 註解中),包括
/thanks/、/form-error/和404.html。 - 轉換已寫入 Analytics Engine,並且即時測試轉換出現在 SQL 查詢中。
- Web Analytics 顯示即時訪問。
- 在 A/B 測試期間:每個變體的訪客數和轉換數會出現,並且樣本量和結束規則會寫在
landing/launch.md中。
主機託管
-
npx wrangler deploy --dry-run通過;資產檔案少於 20,000 個,沒有任何一個超過 25 MiB。 - 自訂網域透過 HTTPS 提供頁面服務;
workers_dev按使用者意願設定。 -
_redirects中的重新導向已在即時環境中測試。 - 未知路徑回傳自訂的
404.html,狀態碼為 404。
頁面
- 標題、中繼描述、權威 URL 以及 Open Graph 和社交卡片標籤已存在;卡片圖片從即時 URL 載入,並且在將連結貼入分享偵錯工具或聊天應用程式時,預覽看起來正確。
- 存在
robots.txt和一個列出即時 URL 的 Sitemap;結果頁面和預覽為noindex。 - 網站圖示存在。
- 隱私權聲明已連結在表單旁和頁尾,指明 Turnstile(一個 Cloudflare 腳本)以及表單儲存的每個欄位(按名稱)。聯絡資訊(電子郵件、電話或目標受眾實際使用的訊息渠道)以及網站經營者。
- 任何「無 Cookie」的陳述仍然為真(當 A/B 測試設定其 Cookie 時則不然)。
- 每個
[PLACEHOLDER: ...]都已解決:使用真實照片和螢幕截圖,價格和日期已確認。
帳戶和密碼
- 已為生產環境主機名稱建立 Turnstile 小工具;真實的 Sitekey 存在於 HTML 中。
-
TURNSTILE_SECRET已使用wrangler secret put設定(絕不提交);.dev.vars*和.wrangler/在.gitignore中。 - 每個面向外部的步驟在執行前都已獲得使用者確認。
不使用 Cloudflare
建置結果是純靜態輸出:所有 HTML、CSS、JavaScript 和資產在一個資料夾中。任何靜態主機或用戶自己的伺服器都可以直接提供服務。
如果使用者不希望使用 Cloudflare,則不要新增任何 Cloudflare 檔案:不新增 wrangler.jsonc、不新增 Worker、不新增 Turnstile、不新增 Web Analytics 程式碼片段、不新增 .dev.vars。移除你在本次工作階段中先前新增的任何此類檔案。然後直接跳到上線檢查清單,並處理那些沒有提及 Cloudflare 產品的項目。對於表單和轉換,檢查清單項目仍然適用:表單需要一個在使用者伺服器或服務上的真實端點,並在伺服器端進行驗證,而轉換需要一個可以被計算的方式。指出缺少的內容,將其標記為待處理,並將工具的選擇留給使用者。此技能不為其他主機提供配方。
自我檢查
在報告之前:
- 未經該步驟的同意,沒有部署、預覽、路由或在使用者帳戶中建立任何內容。
- 每個配置變更都通過了
npx wrangler deploy --dry-run,並且本機 curl 檢查提供了預期的狀態碼。 - 沒有任何檔案聲稱 Web Analytics 會計算點擊或轉換。
- 沒有將密碼、權杖或帳戶 ID 寫入已提交的檔案中。
landing/launch.md已存在,並且檢查清單的每一行都已標記,每個不是done的項目都有原因,且沒有提交的表單欄位未被處理。
參考資料
references/hosting.md:各技術棧的配置、指令、試運行、自訂網域、_redirects和_headers、快取、404、預覽。在步驟 3 時閱讀。references/forms.md:表單標記、經過測試的表單 Worker、使用 Turnstile 測試金鑰進行的本機測試、生產環境設定。在頁面有表單的步驟 4 時閱讀。references/analytics.md:Web Analytics 設定、Analytics Engine 中的轉換事件、查詢、隱私權聲明、部署後應檢查的內容。在步驟 5 時閱讀。references/ab-testing.md:Free 方案的成本、經過測試的
…
[truncated for translation]