랜딩 페이지 런칭
빌드된 랜딩 페이지를 런칭할 준비를 합니다: 호스팅, 페이지 분석, 하나의 콜투액션에 대한 전환 이벤트, 작동하는 리드 폼, 선택적 A/B 테스트, 그리고 런칭 체크리스트를 포함합니다. 이 스킬은 모든 것을 로컬에서 준비하고 테스트합니다. 사용자의 승인 없이는 배포하거나 DNS를 변경하지 않습니다.
Cloudflare 명령어, 구성 키 및 한도는 변경됩니다. 여기에 포함된 내용은 2026-10-04 기준 Cloudflare 문서와 Wrangler 4.147.0으로 실행된 Worker 코드를 확인한 것입니다. 명령어나 한도에 의존하기 전에 현재 Cloudflare 문서에서 확인하고, 이 스킬과 문서가 다를 경우 문서를 신뢰하세요.
입력
먼저 파일을 읽고 사용자가 열어둔 정보에 대해서만 한 번의 메시지로 질문하세요.
| 입력 | 위치 | 누락된 경우 |
|---|---|---|
빌드된 페이지, /thanks/ 및 /form-error/ (폼이 이 스킬의 Worker로 전송될 때) | 빌드 출력 (dist/, public/, 내보내기 폴더), landing-skills:landing-build에 의해 작성됨 | 빌드를 실행합니다. 페이지가 아직 없으면 중단하고 페이지가 먼저 필요하다고 말합니다 (landing-skills:landing-build). |
전환 액션: 폼, 외부 페이지, 폼의 필드, 엔드포인트 상태 (없음 또는 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 정적 자산이 페이지를 제공합니다. 정적 요청은 무제한이며 무료 플랜에서 무료입니다. Cloudflare는 새 프로젝트에 Pages보다 Workers를 권장합니다. 동일한 프로젝트가 폼용 소형 Worker를 실행할 수 있으므로 페이지에 다른 백엔드가 필요하지 않습니다.
- 분석: Cloudflare Web Analytics는 쿠키나 핑거프린팅 없이 트래픽과 Core Web Vitals를 측정합니다. 사용자 지정 이벤트가 없으므로 전환은 동일한 계정의 Workers Analytics Engine에서 Worker가 계산하며, 무료 플랜에서 무료입니다.
- A/B 테스트: 동일한 Worker가 페이지가 제공되기 전에 에지에서 변형을 할당할 수 있습니다. 클라이언트 측 테스트 스크립트, 깜빡임이 없으며 JavaScript가 꺼져 있어도 작동합니다.
비용도 명시하세요: 사용자 지정 도메인은 도메인의 DNS를 Cloudflare에 두어야 하며, Worker를 실행하는 모든 요청은 무료 플랜에서 하루 100,000회로 제한됩니다.
프로세스
-
입력을 읽습니다.
landing/brief.md에서 전환 액션(폼 또는 외부 페이지, 필드, 엔드포인트 상태), 도메인 및 연락처 경로를 가져옵니다. 빌드된 페이지에서 모든 폼(action및 필드 이름)과 모든 콜투액션 링크를 기록합니다. 누락된 항목에 대해서만 질문합니다.그런 다음 케이스를 선택하여 추가할 내용을 결정합니다:
- 폼, 엔드포인트
없음(/api/lead로 전송되며 아직 제공되는 것이 없음): 폼 Worker, 4단계 및 5단계. - 폼, 엔드포인트 있음: 폼 Worker 및 Turnstile이 없습니다. 폼이 해당 엔드포인트로 전송되는지 확인하고 결과 페이지가 반환되는 것과 일치하는지 확인합니다. 유효성 검사 및 스팸 방지가 해당 엔드포인트의 작업임을 기록합니다.
- 외부 페이지 (체크아웃, 예약, 앱 스토어): 처리할 폼이 없습니다. 링크는 실제 URL로 연결되며 클릭은 5단계의 비콘으로 계산됩니다. 체크리스트의 폼 항목은
n/a입니다.
- 폼, 엔드포인트
-
먼저 막다른 길을 수정합니다. 빌드에서 액션이 없거나 제출이 취소된 폼, 감사 메시지만 표시하는 제출 핸들러, 빈
#에 대한 링크, 그리고 해당 섹션에 대한 링크 버튼을 검색합니다. 이러한 각각은 전환이 존재하지 않음을 의미합니다. 폼은 4단계에서 Worker 엔드포인트를 얻습니다. 링크는 사용자의 실제 URL 또는[PLACEHOLDER: ...]와 보류 중인 체크리스트 항목을 얻습니다. -
호스팅 구성. 스택에 맞게
wrangler.jsonc를 작성하고, 프로젝트에 Wrangler를 설치하고, 누락된 경우404.html을 추가하고, 넣을 내용이 있을 때만_headers또는_redirects를 추가합니다.references/hosting.md를 읽으세요. -
폼 엔드포인트 (폼, 엔드포인트
없음). 폼 Worker를 추가합니다: 서버 유효성 검사, Siteverify를 통한 Turnstile 확인, D1 스토리지, JavaScript 및 no-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에서, 링크의 경우 비콘으로. 기존 엔드포인트의 경우 전환은 해당 엔드포인트의 레코드에서 계산되며 비콘은 옵션입니다.
references/analytics.md를 읽으세요. -
A/B 테스트, 요청된 경우에만. 코드를 작성하기 전에 하나의 변경 사항, 기준선, 조치를 취할 가치가 있는 최소 차이 및 샘플 크기에 동의합니다. 그런 다음 변형 파일과 A/B Worker를 추가합니다.
references/ab-testing.md를 읽으세요. -
로컬에서 테스트합니다.
.dev.vars에 Turnstile 테스트 키를 사용하여npx wrangler dev를 실행하고 curl 및 브라우저로 모든 경로를 실행합니다: 유효한 모든 필드 POST, 잘못된 이메일, 각 필드 제한 초과, 실패한 Turnstile, JavaScript 끄기, 테스트의 경우: 할당, 두 번째 요청 시 고정 쿠키, 전환 엔드포인트. 그런 다음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)로 표시하세요. 확인할 수 없는 항목은 done이 아닌 pending입니다. 콜투액션이 외부 페이지인 경우 폼 항목은 n/a입니다.
전환
- 콜투액션이 작동하는 액션으로 이어집니다: 폼이
/api/lead(또는 사용자의 기존 엔드포인트)로 전송되거나 링크가 사용자의 실제 URL로 연결됩니다.href="#", 자체 앵커, 가짜 성공이 없습니다. - 폼이 제출하는 모든 필드
name에 길이 제한과leads컬럼이 있는FIELDS항목이 있습니다. 처리되지 않은 필드는 통과가 아닌 실패입니다. - 기존 엔드포인트의 경우:
Accept: application/json에 대해 JSON으로ok를 응답하고 그렇지 않으면/thanks/또는/form-error/로 리디렉션하거나 결과 페이지가 반환되는 것과 일치합니다. 유효성 검사 및 스팸 방지는 해당 엔드포인트의 작업으로 기록됩니다. - 폼이 이 스킬의 Worker로 전송되는 경우:
/thanks/및/form-error/가 존재하고(빌드 자체 페이지, 덮어쓰지 않음),/form-error/는 브리프의 연락처 경로를 제공합니다. 기존 엔드포인트의 경우 페이지는 반환되는 것과 일치합니다. 외부 링크의 경우n/a입니다. - 폼이 로컬에서 테스트됨: 유효한 POST, 잘못된 이메일, 실패한 Turnstile, JavaScript 끄기(
/form-error/에 도달). - 전송 중에 버튼이 비활성화됩니다. 성공 및 오류는
role="status"요소에 공지됩니다. - 허니팟은 시각 및 보조 기술에서 숨겨집니다.
- 배포 후 라이브 폼이 한 번 테스트됨. 행이 D1에 있습니다.
- 사용자가 이메일을 보낼 방법이 없는 한 확인 이메일을 약속하지 않습니다.
측정
- 모든 페이지에 실제 토큰이 있는 Web Analytics 스니펫이 라이브입니다 (보류: 스니펫이 토큰이 존재할 때까지 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을 나열하는 사이트맵이 있습니다. 결과 페이지 및 미리보기는noindex입니다. - 파비콘이 있습니다.
- 개인정보 고지가 폼 옆과 푸터에 연결되어 있으며 Turnstile(Cloudflare 스크립트) 및 폼이 저장하는 모든 필드를 이름별로 명명하고 연락처 세부 정보(이메일, 전화 또는 대상이 실제로 사용하는 메시징 채널)와 사이트 운영자를 포함합니다.
- "쿠키 없음" 진술이 여전히 사실입니다 (A/B 테스트가 쿠키를 설정하는 동안에는 사실이 아님).
- 모든
[PLACEHOLDER: ...]가 해결됨: 실제 사진 및 스크린샷이 제자리에 있고 가격 및 날짜가 확인됨.
계정 및 비밀
- 프로덕션 호스트 이름에 대해 Turnstile 위젯이 생성됨. 실제 사이트키가 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: 스택별 구성, 명령어, dry run, 사용자 정의 도메인,_redirects및_headers, 캐싱, 404, 미리보기. 3단계에서 읽으십시오.references/forms.md: 폼 마크업, 테스트된 폼 Worker, Turnstile 테스트 키를 사용한 로컬 테스트, 프로덕션 설정. 페이지에 폼이 있을 때 4단계에서 읽으십시오.references/analytics.md: Web Analytics 설정, Analytics Engine의 전환 이벤트, 쿼리, 개인정보 보호 진술, 배포 후 확인할 사항. 5단계에서 읽으십시오.references/ab-testing.md: 무료 플랜의 비용, 테스트된...
…[번역을 위해 잘림]