Lançamento de página de destino
Prepare uma página de destino para lançamento: hospedagem, análise de página, um evento de conversão para sua única chamada para ação, um formulário de lead funcional, um teste A/B opcional e uma lista de verificação de lançamento. A habilidade prepara e testa tudo localmente. Ela nunca implanta ou altera DNS sem a autorização do usuário.
Comandos do Cloudflare, chaves de configuração e limites mudam. Os fornecidos aqui foram verificados com a documentação do Cloudflare em 2026-10-04 e o código do Worker foi executado com Wrangler 4.147.0. Antes de confiar em um comando ou limite, confirme-o na documentação atual do Cloudflare e confie na documentação onde ela discorda desta habilidade.
Entradas
Leia os arquivos primeiro e pergunte ao usuário apenas o que ele deixar em aberto, em uma única mensagem.
| Entrada | Onde | Se ausente |
|---|---|---|
A página criada, e /thanks/ e /form-error/ quando o formulário envia para o Worker desta habilidade | a saída da build (dist/, public/, uma pasta de exportação), escrita por landing-skills:landing-build | Execute a build. Se ainda não houver página, pare e diga que a página vem primeiro (landing-skills:landing-build). |
A ação de conversão: formulário ou página externa, os campos do formulário, o status do endpoint (nenhum ainda ou uma URL), ou a URL externa | Conversion action em landing/brief.md | Leia da página: o action do formulário e o name de cada campo, ou o link principal. Confirme com o usuário em uma pergunta. |
Cada name de campo que o formulário envia, e o status do endpoint | a entrega da build; caso contrário, os atributos name do formulário criado | Leia-os do formulário criado. |
| Domínio | Domain em landing/brief.md | Pergunte. Se permanecer unknown, use o endereço workers.dev e marque os itens de domínio como pendentes. |
Rotas de contato, para /form-error/ e o rodapé | Contact routes em landing/brief.md | Pergunte. Até que seja respondido, um [PLACEHOLDER: ...] visível, item pendente. |
| Mensagens do formulário, agradecimento e erro | landing/copy.md | Escreva mensagens curtas e simples no idioma da página e liste-as para o usuário aprovar. |
| Escolha de hospedagem | o usuário | Recomende Cloudflare (abaixo). Se recusar, vá para Não usando Cloudflare. |
| Aviso de privacidade | o rodapé da página e o formulário | Peça ao usuário; até lá, um [PLACEHOLDER: ...] visível, item pendente. Nunca invente um. |
O que esta habilidade escreve: configuração de hospedagem, o Worker do formulário quando necessário, o snippet de análise e evento de conversão, e landing/launch.md com a lista de verificação. Ela não escreve cópia nem reescreve as páginas da build.
Identifique a stack (HTML simples, Astro, Vite com React, Next.js) e sua pasta de saída antes de escrever qualquer configuração.
Recomendação
Sugira Cloudflare para todas as três tarefas e explique por que nestes termos:
- Hospedagem: Workers static assets servem a página; requisições estáticas são gratuitas e ilimitadas no plano Free, e o Cloudflare recomenda Workers em vez de Pages para novos projetos. O mesmo projeto pode executar um Worker pequeno para o formulário, então a página não precisa de outro backend.
- Análise: Cloudflare Web Analytics conta tráfego e Core Web Vitals sem cookies ou fingerprinting. Não tem eventos personalizados, então a conversão é contada pelo Worker no Workers Analytics Engine, na mesma conta, gratuito no plano Free.
- Teste A/B: o mesmo Worker pode atribuir variantes na borda antes da página ser servida. Nenhum script de teste no lado do cliente, sem flicker, e funciona com JavaScript desligado.
Informe também os custos: um domínio personalizado precisa do DNS do domínio no Cloudflare, e cada requisição que executa o Worker conta contra 100.000 por dia no plano Free.
Processo
-
Leia as entradas. De
landing/brief.md, pegue a ação de conversão (formulário ou página externa, seus campos, o status do endpoint), o domínio e as rotas de contato. Da página criada, observe cada formulário com seuactione nomes de campo, e cada link de chamada para ação. Pergunte apenas o que ainda está faltando.Em seguida, escolha o caso, que decide o que você adiciona:
- Formulário, endpoint
nenhum ainda(ele envia para/api/lead, que nada serve ainda): o Worker do formulário, etapas 4 e 5. - Formulário, endpoint existe: nenhum Worker de formulário e nenhum Turnstile. Verifique se o formulário envia para esse endpoint e se as páginas de resultado correspondem ao que ele retorna, e registre que a validação e proteção contra spam são responsabilidade desse endpoint.
- Página externa (checkout, reserva, app store): nenhum formulário para manipular. O link vai para a URL real e o clique é contado com o beacon na etapa 5; os itens do formulário na lista de verificação são
n/a.
- Formulário, endpoint
-
Corrija os becos sem saída primeiro. Pesquise na build por um formulário cujo action não leva a lugar nenhum ou cujo submit é cancelado, um manipulador de submit que apenas mostra uma mensagem de agradecimento, links para um
#vazio e botões que linkam para a seção em que estão. Cada um desses significa que a conversão não existe. Um formulário recebe o endpoint do Worker na etapa 4; um link recebe a URL real do usuário ou um[PLACEHOLDER: ...]visível e um item pendente na lista de verificação. -
Configuração de hospedagem. Escreva
wrangler.jsoncpara a stack, instale Wrangler no projeto, adicione404.htmlse ausente e adicione_headersou_redirectsapenas quando houver algo para colocar neles. Leiareferences/hosting.md. -
Endpoint do formulário (formulário, endpoint
nenhum ainda). Adicione o Worker do formulário: validação do servidor, verificação Turnstile com Siteverify, armazenamento D1 e os caminhos de resposta com e sem JavaScript. Adicione o widget Turnstile ao formulário da build; mantenha a marcação e o script de aprimoramento da build. Verifique se/thanks/e/form-error/existem e se/form-error/oferece uma rota de contato do brief. Crie uma página de resultado apenas se estiver faltando e nunca substitua uma existente:landing-skills:landing-buildas possui. Leiareferences/forms.md.Cada campo é tratado. Liste cada
namede campo que o formulário envia e dê a cada um uma entrada na tabelaFIELDSdo Worker (obrigatório ou não, um limite de comprimento, uma verificação de formato onde for significativo, caso contrário texto com um limite), uma coluna na tabelaleadse umMAX_BYTESque os comporte. Nada é armazenado sem validação. Um campo enviado que o Worker não trata faz a lista de verificação falhar; o Worker recusa tal post comunknown_field, o que torna a lacuna visível no teste, mas o envio do visitante ainda é perdido até que o campo seja adicionado. -
Análise e o evento de conversão. Adicione o snippet Web Analytics a todas as páginas e registre a conversão no Analytics Engine: no Worker do formulário quando você adicionou um, ou por beacon para um link. Com um endpoint existente, a conversão é contada a partir dos registros desse endpoint, e o beacon é uma opção. Leia
references/analytics.md. -
Teste A/B, apenas se solicitado. Combine a única mudança, a linha de base, a menor diferença que vale a pena agir e o tamanho da amostra antes de escrever qualquer código. Em seguida, adicione o arquivo de variante e o Worker A/B. Leia
references/ab-testing.md. -
Teste localmente. Execute
npx wrangler devcom chaves de teste Turnstile em.dev.varse exercite cada caminho com curl e um navegador: post válido com todos os campos, email inválido, cada campo acima do limite, Turnstile falho, JavaScript desligado e, para um teste: atribuição, o cookie fixo em uma segunda requisição, o endpoint de conversão. Em seguida, executenpx wrangler deploy --dry-rune verifique a contagem e o tamanho dos assets. Execuções locais não precisam de conta. Corrija o que falhar antes de prosseguir. -
Pare para autorização. Implantar, criar uma preview, adicionar um domínio personalizado ou rota, criar um banco de dados D1, executar
d1 execute --remote, definir um segredo, criar o widget Turnstile e adicionar o site ao Web Analytics alteram a conta Cloudflare do usuário, e uma implantação ou mudança de DNS é visível ao público imediatamente. O usuário pode estar em meio a uma revisão, o domínio pode ainda servir um site antigo, e uma mudança de DNS errada pode derrubar um site ao vivo. Portanto, liste cada etapa externa com seu comando exato e o que ela mudará, e execute cada uma apenas quando o usuário disser sim a ela naquele momento. Um sim para uma etapa não é um sim para a próxima. Se o usuário preferir executá-las, entregue os comandos em ordem. -
Após a implantação (com o usuário). Envie o formulário ao vivo uma vez, confirme a linha no D1 e a conversão no Analytics Engine, confirme que o Web Analytics mostra a visita e verifique os itens na lista de verificação que só podem ser verificados ao vivo.
-
Escreva
landing/launch.md. Registre a configuração de hospedagem, a ação de conversão e como ela é contada, o plano A/B se houver, os comandos para as etapas externas e a lista de verificação de lançamento com cada item marcado comodone,pending,failoun/ae o motivo para cada um que não sejadone. Mostre a lista de verificação ao usuário.
Lista de verificação de lançamento
Copie isso para landing/launch.md e marque cada linha como done, pending (razão), fail (razão) ou n/a (razão). Um item que você não pôde verificar é pendente, nunca feito. Os itens do formulário são n/a quando a chamada para ação é uma página externa.
Conversão
- A chamada para ação leva a uma ação funcional: o formulário envia para
/api/lead(ou o endpoint existente do usuário), ou o link vai para a URL real do usuário. Nenhumhref="#", auto-âncora ou sucesso falso. - Cada
namede campo que o formulário envia tem uma entradaFIELDScom um limite de comprimento e uma colunaleads. Qualquer campo não tratado é uma falha, nunca uma aprovação. - Com um endpoint existente: ele responde JSON com
okparaAccept: application/jsone redireciona para/thanks/ou/form-error/caso contrário, ou as páginas de resultado correspondem ao que ele retorna; validação e proteção contra spam são registradas como sua responsabilidade. - Quando o formulário envia para o Worker desta habilidade:
/thanks/e/form-error/existem (as próprias páginas da build, não substituídas), e/form-error/oferece uma rota de contato do brief. Com um endpoint existente, as páginas correspondem ao que ele retorna; com um link externo,n/a. - Formulário testado localmente: post válido, email inválido, Turnstile falho, JavaScript desligado (cai em
/form-error/). - O botão desabilita enquanto envia; sucesso e erro são anunciados em um elemento
role="status". - O honeypot está oculto da vista e da tecnologia assistiva.
- Formulário ao vivo testado uma vez após a implantação; a linha está no D1.
- Nenhuma promessa de email de confirmação, a menos que o usuário tenha uma maneira de enviar um.
Medição
- Snippet Web Analytics ao vivo com o token real em todas as páginas (pendente: o snippet está em um comentário HTML até que o token exista), incluindo
/thanks/,/form-error/e404.html. - A conversão é escrita no Analytics Engine, e uma conversão de teste ao vivo aparece na consulta SQL.
- Web Analytics mostra a visita ao vivo.
- Durante um teste A/B: contagens de visitantes e conversões por variante aparecem, e o tamanho da amostra e a regra de encerramento são escritos em
landing/launch.md.
Hospedagem
-
npx wrangler deploy --dry-runpassa; arquivos de asset abaixo de 20.000, nenhum acima de 25 MiB. - Domínio personalizado serve a página via HTTPS;
workers_devdefinido como o usuário deseja. - Redirecionamentos em
_redirectstestados ao vivo. - Caminhos desconhecidos retornam o
404.htmlpersonalizado com status 404.
Página
- Tags de título, meta descrição, URL canônica e Open Graph e cartão social presentes; a imagem do cartão carrega da URL ao vivo e a visualização parece correta quando o link é colado em um depurador de compartilhamento ou aplicativo de chat.
-
robots.txte um sitemap que lista a URL ao vivo; páginas de resultado e previews sãonoindex. - Favicon presente.
- Aviso de privacidade vinculado próximo ao formulário e no rodapé, nomeando Turnstile (um script do Cloudflare) e cada campo que o formulário armazena, pelo nome; detalhes de contato (email, telefone ou o canal de mensagens que o público realmente usa) e quem administra o site.
- Qualquer declaração "sem cookies" ainda é verdadeira (não é enquanto um teste A/B define seu cookie).
- Todo
[PLACEHOLDER: ...]resolvido: fotos e screenshots reais no lugar, preços e datas confirmados.
Contas e segredos
- Widget Turnstile criado para o hostname de produção; a sitekey real está no HTML.
-
TURNSTILE_SECRETdefinido comwrangler secret put(nunca commitado);.dev.vars*e.wrangler/no.gitignore. - Cada etapa externa foi confirmada pelo usuário antes de ser executada.
Não usando Cloudflare
A build é saída estática simples: HTML, CSS, JavaScript e assets em uma pasta. Qualquer host estático ou o próprio servidor do usuário pode servir como está.
Se o usuário não quiser Cloudflare, não adicione arquivos Cloudflare: nenhum wrangler.jsonc, nenhum Worker, nenhum Turnstile, nenhum snippet Web Analytics, nenhum .dev.vars. Remova qualquer um que você tenha adicionado anteriormente na sessão. Em seguida, vá direto para a lista de verificação de lançamento e trabalhe nos itens que não nomeiam um produto Cloudflare. Para o formulário e a conversão, os itens da lista de verificação ainda se aplicam: o formulário precisa de um endpoint real no servidor ou serviço do usuário, validado no servidor, e a conversão precisa de uma maneira de ser contada. Nomeie o que está faltando, marque como pendente e deixe a escolha da ferramenta para o usuário. Esta habilidade não fornece receitas para outros hosts.
Autoverificação
Antes de relatar:
- Nada foi implantado, previewado, roteado ou criado na conta do usuário sem um sim para essa etapa.
- Cada mudança de configuração passou
npx wrangler deploy --dry-run, e as verificações curl locais deram os códigos de status esperados. - Nenhum arquivo afirma que o Web Analytics conta cliques ou conversões.
- Nenhum segredo, token ou id de conta é escrito em um arquivo commitado.
landing/launch.mdexiste, e cada linha da lista de verificação está marcada, com uma razão para cada uma que não sejadone, e nenhum campo de formulário enviado fica sem tratamento.
Referências
references/hosting.md: configuração por stack, comandos, dry run, domínio personalizado,_redirectse_headers, cache, 404, previews. Leia na etapa 3.references/forms.md: a marcação do formulário, o Worker do formulário testado, testes locais com chaves de teste Turnstile, configuração de produção. Leia na etapa 4 quando a página tiver um formulário.references/analytics.md: configuração do Web Analytics, o evento de conversão no Analytics Engine, a consulta, declarações de privacidade, o que verificar após a implantação. Leia na etapa 5.references/ab-testing.md: o custo no plano Free, o testado
… [truncado para tradução]