Personalize e teste com Croct

Profissionais de marketing gerenciam experiências e experimentos no dashboard (app.croct.com). Seu trabalho como agente é:

Planejar: transformar o objetivo do usuário em uma experiência (quem / onde / o que) e, quando ele quiser comprovação, um experimento (hipótese, meta, alocação, variantes).
Escrever o código: garantir que cada área segmentada seja um slot, a conversão seja rastreada como um evento goalCompleted e os dados que a audiência precisa sejam coletados.
Escrever a audiência: uma condição CQL. Para sintaxe além das receitas aqui, carregue a skill croct-cql.
Interpretar resultados: ler os dashboards com os limiares documentados; nunca declare um vencedor que o dashboard não suporte.

Não diga ao usuário que são necessárias alterações de código para iniciar, alterar ou encerrar um experimento. Uma vez que o slot e a meta existam, todo o resto é configuração.

Modelo mental

Conceito	O que é	Regras
Experiência	Conteúdo mostrado a uma audiência em um ou mais slots	Definida por quem (audiências), onde (slots), o que (conteúdo). Várias audiências permitidas; dê a cada uma seu próprio conteúdo usando grupos de conteúdo.
Audiência	Uma condição CQL avaliada contra o contexto atual do usuário	Pode segmentar todos os usuários ou um segmento restrito.
Prioridade	Classificação única por experiência	Quando as audiências se sobrepõem no mesmo slot, a experiência com prioridade mais alta vence. Sem empates.
Experimento	Um teste A/B/n dentro de uma experiência	Um por experiência por vez. Herda a audiência e os slots da experiência. De 2 a 5 variantes.
ID da meta principal	A conversão que o experimento otimiza	Deve corresponder ao `goalId` de um evento `goalCompleted` rastreado.
Alocação de tráfego	% de usuários elegíveis que entram no experimento	O restante vê o conteúdo da experiência.

Quem vê o que para um determinado slot:

Usuário	Vê
Não está na audiência de nenhuma experiência	Conteúdo padrão do slot
Está na audiência, não alocado para o experimento	Conteúdo da experiência
Está na audiência, alocado	Conteúdo da variante atribuída
Corresponde a várias experiências no mesmo slot	A de maior prioridade

A atribuição é determinística: o ID do visitante é combinado com a chave do experimento, então uma recarga nunca altera a variante. A exposição é rastreada automaticamente. Para usuários identificados, o ID do usuário é a chave de atribuição, então a variante pode acompanhá-los entre dispositivos (usuários anônimos não podem).

Decida o que construir

O usuário quer...	Construa
Conteúdo diferente para um segmento conhecido	Experiência com uma audiência, sem experimento
Provar que uma mudança funciona antes de lançá-la	Experiência (geralmente "todos os usuários") + experimento
Testar texto, imagens, layout ou uma seção	Experimento de conteúdo em um slot (uma URL, renderizado no servidor quando possível)
Testar para onde um link leva	Experimento de CTA: o slot contém o destino do link
Mostrar ou ocultar um elemento (banner promocional)	Avaliação (`evaluate`/`useEvaluation`) no código apenas para lógica fixa que o desenvolvedor possui; caso contrário, um slot com um atributo booleano mais uma experiência, para que os profissionais de marketing controlem quem vê. Consulte a regra de avaliação da skill `croct-integrate-sdk`
Testar funcionalidade ou um fluxo, não conteúdo visível	Experimento de feature flag: um slot com um atributo booleano, ramificado no servidor
Testar duas páginas genuinamente separadas (página reconstruída, outro template, landing page de outra ferramenta)	Experimento de redirecionamento. Prefira experimentos de conteúdo quando apenas o conteúdo diferir
Vários limites ou segmentos em uma campanha (frete grátis por estado)	Uma experiência, várias audiências, grupos de conteúdo
Uma campanha que inicia, pausa ou retoma em um horário definido	Agendamento (complemento), opcionalmente no fuso horário da audiência

Checklist de implementação

Toda experiência ou experimento precisa destes itens no código antes de ser configurado:

Um slot para cada área que muda. Se faltar: npx croct@latest add slot <slot-id>@1 e renderize-o com o SDK (veja as skills croct-use-cli e croct-integrate-sdk). Sem um slot, nenhuma experiência pode alterar a área.
Um evento goalCompleted para a conversão (obrigatório para experimentos). O ID da meta deve ser igual ao ID da meta principal do experimento. Se a meta for nova, implante-a antes de iniciar o experimento.
Eventos de conversão mais ricos quando relevante: orderPlaced, leadGenerated, userSignedUp preenchem widgets de receita, lead e inscrição junto com a meta.
Os dados que a audiência lê. Parâmetros UTM, localização e dados de sessão são automáticos; receitas baseadas em posts, interesses, pedidos, leads ou inscrições exigem o rastreamento desses eventos (veja a skill croct-track-events).
Identificação do usuário se as variantes precisarem permanecer consistentes entre dispositivos.

Monitore a meta

// components/HomeHero.tsx (React; @croct/plug-next é idêntico com 'use client')
import type {ReactElement} from 'react';
import {useContent, useCroct} from '@croct/plug-react';

export function HomeHero(): ReactElement {
  const {content} = useContent('home-hero@1');
  const croct = useCroct();

  function handleClick(): void {
    croct.track('goalCompleted', {
      goalId: 'hero-cta-click',
    });
  }

  return (
    <div>
      <h1>{content.title}</h1>
      <p>{content.subtitle}</p>
      <a href={content.button.link} onClick={handleClick}>{content.button.label}</a>
    </div>
  );
}

// JavaScript puro
import croct from '@croct/plug';

croct.track('goalCompleted', {goalId: 'sign-up'});

O evento também aceita value e currency opcionais ({goalId: 'signup', currency: 'USD', value: 50}). Em stacks PHP renderizadas no servidor, monitore no navegador com o helper de template (@croct ... @endcroct em Blade, {% apply croct %} ... {% endapply %} em Twig).

Monitore a meta onde a conversão realmente acontece, no navegador. Para um experimento de redirecionamento, monitore-a em ambas as páginas. Quando a conversão é concluída apenas no servidor (webhook de pagamento, inscrição no backend), use o track independente do SDK JavaScript de @croct/plug/api com uma chave de API: o exemplo da sua documentação é exatamente um evento goalCompleted enviado de um servidor ou script isolado (veja a skill croct-track-events). Ele aceita um userToken opcional; a documentação não diz como um evento enviado sem ele é atribuído ao experimento.

Fluxo de trabalho de experiência (dashboard)

Relate estas etapas ao usuário; você não pode clicá-las sozinho.

Página de Experiências > Nova experiência, nomeie-a.
Aba Audiência > Nova audiência > cole os critérios CQL. Várias audiências permitidas.
Aba Slot > selecione um ou mais slots (combine slots entre páginas para uma jornada consistente).
Aba Conteúdo > edite o conteúdo por slot (e por grupo de conteúdo quando as audiências diferirem).
Aba opcional Experimento (veja abaixo).
Revise as alterações do rascunho, depois Publique (ou agende) — ou Visualize primeiro.

Durante o desenvolvimento, uma audiência como property welcome of page's query is "true" permite que o usuário alterne a experiência com ?welcome=true. Substitua-a por uma audiência real para produção.

Detalhes sobre status, prioridade, agendamento, alterações de rascunho e conteúdo: references/experiences.md.

Fluxo de trabalho de experimento

Escreva a hipótese: a mudança, a métrica que ela move e por quê.
Escolha o ID da meta principal (o dashboard sugere IDs já rastreados). Confirme se ele dispara.
Defina a alocação de tráfego. Use 100% para audiências de nicho. Mantenha-a estável durante todo o teste.
Crie 2 a 5 variantes, geralmente uma é o controle. Uma variante pode copiar o conteúdo do slot ou herdar o conteúdo da experiência em vez de duplicá-lo.
Defina o conteúdo de cada variante (e grupos de conteúdo, se necessário).
Ative a consistência entre dispositivos se os usuários forem identificados e devem manter sua variante.
Visualize cada variante, publique, depois verifique: sessões por variante correspondem à divisão, e uma conversão de teste aparece sob a meta correta.

Nunca altere a distribuição de tráfego ou adicione/remova variantes durante o teste; isso pode invalidar os resultados.

Detalhes, feature flags e redirecionamentos: references/experiments.md e references/flag-and-redirect-experiments.md.

Lendo resultados

O dashboard do experimento mostra um indicador no topo. Aja com base nele:

Indicador	Significado	Faça
Monitore sua meta	Nenhum evento de conclusão de meta registrado	Corrija o rastreamento; nada mais é significativo
Experimento em andamento	Ainda não está estável	Espere. Estável requer cada variante ≥ 1.000 visitantes, cada variante ≥ 25 conversões e ≥ 1 semana em execução
Vencedor recomendado	Estável, e uma variante tem PBB > 95% e perda potencial < 0,1%	Aplique o conteúdo vencedor à experiência e pare o experimento
Nenhum vencedor claro	Estável, variantes muito semelhantes	Encerre sem um vencedor ou teste uma nova hipótese

Antes de ler qualquer métrica, verifique sessões por variante em relação à divisão configurada. Um desequilíbrio persistente significa que a atribuição ou o registro está descartando uma classe de usuários.

Probabilidade de ser a melhor (PBB) e perda potencial vêm de inferência bayesiana com uma distribuição Beta por variante e simulação de Monte Carlo, computadas em tempo real sem amostragem. Explicações, fórmulas e todos os widgets do dashboard: references/analytics.md.

Receitas

Guias condensados (ABM, leitores de blog, clientes, frete grátis, formulários HubSpot, interesses, leads, localização, campanhas de marketing, intenção orgânica, termos de busca), cada um com sua audiência CQL, pré-requisitos de rastreamento e slots sugeridos: references/playbooks.md.

Faça / Não faça

Faça implemente e verifique o evento de meta antes de publicar um experimento. Sem ele, o experimento coleta exposições, mas nenhuma conversão.
Faça aloque 100% para audiências de nicho para que o teste possa atingir validade estatística.
Faça prefira uma URL com conteúdo orientado por slot em vez de redirecionamentos; redirecionamentos adicionam um carregamento de página e distorcem os resultados.
Faça mantenha os redirecionamentos temporários (302/307) e proteja contra loops.
Faça remova slots obsoletos de feature flag do código após o término de um teste.
Não faça declare um vencedor enquanto o dashboard disser "Experimento em andamento", ou apenas com base em contagens brutas (total de pedidos, total de inscrições).
Não faça edite a alocação ou a lista de variantes durante o teste.
Não faça espere consistência entre dispositivos para usuários anônimos; ela precisa de um usuário identificado.
Não faça redirecione para um domínio diferente: o visitante é reconhecido por domínio, então a conversão nunca é atribuída. Para subdomínios, compartilhe a sessão primeiro.
Não faça pré-renderize completamente ou armazene em cache uma página que renderiza um slot de experimento; uma variante em cache seria servida a todos.

Documentação ao vivo

Índice: https://docs.croct.com/llms.txt
Qualquer página como markdown: acrescente .md, ex.: https://docs.croct.com/explanation/experiment.md
Pesquisa: https://docs.croct.com/api/search.md?term=<termos>

croct-tech/agent-skills

O que é agent-skills?

Perguntar na sua IA favorita

Documentação