getting-started

Flowsery Analytics permite monitorar ações específicas dos usuários além das visualizações de página, chamadas de Objetivos (cadastro, assinatura de newsletter, checkout iniciado, etc.).

  • Obtenha visibilidade sobre o que os visitantes fazem no seu site
  • Desbloqueie a funcionalidade Journey
  • Melhore as previsões de receita e os funis de conversão

Você pode rastrear objetivos usando três métodos:

Método nº1: Rastreamento do lado do cliente com JavaScript

Chame a função flowsery() e passe o nome do seu objetivo como argumento. Coloque o trecho JavaScript onde a conversão acontece (por exemplo, em uma página de agradecimento após o cadastro, quando um usuário clica em um botão, etc.).

window?.flowsery("signup");

Regras para goal_name:

  • Use letras minúsculas
  • Números, sublinhados (_) e hifens (-) são permitidos
  • Máximo de 64 caracteres

Uso avançado com parâmetros personalizados

Anexe um objeto com parâmetros personalizados aos seus objetivos para análises mais ricas no Journey:

Objetivo com parâmetros personalizados
window?.flowsery("initiate_checkout", {
  name: "Elon Musk",
  email: "elon@x.com",
  product_id: "prod_123",
});

Regras para parâmetros personalizados:

  • Nomes de propriedades: apenas letras minúsculas, números, sublinhados (_) e hifens (-). Máximo de 64 caracteres.
  • Valores de propriedades: qualquer string, máximo de 255 caracteres.
  • Máximo de 10 parâmetros personalizados por evento.

Garantir rastreamento confiável (recomendado)

Adicione este trecho ao seu HTML <head> para garantir que os eventos sejam capturados mesmo que sejam disparados antes do carregamento do script principal:

Trecho de fila de eventos
<script id="flowsery-queue">
  window.flowsery = window.flowsery || function() {
    window.flowsery.q = window.flowsery.q || [];
    window.flowsery.q.push(arguments);
  };
</script>

Método nº2: Rastreamento do lado do cliente com atributos data HTML

Rastreie objetivos automaticamente quando os usuários clicam em qualquer elemento com o atributo data-fs-goal. Esta e a abordagem mais simples para rastrear cliques em botões.

<button data-fs-goal="initiate_checkout">Buy Now</button>

Neste exemplo, Flowsery Analytics envia um objetivo chamado initiate_checkout.

Uso avançado com parâmetros personalizados

Adicione atributos data-fs-goal-* adicionais para incluir parâmetros personalizados:

Objetivo por atributo data com parâmetros
<button
  data-fs-goal="initiate_checkout"
  data-fs-goal-price="49"
  data-fs-goal-currency="USD"
  data-fs-goal-plan-type="pro">
    Subscribe to Pro Plan
</button>

Neste exemplo, Flowsery Analytics envia um objetivo chamado initiate_checkout com { price: '49', currency: 'USD', plan_type: 'pro' } como parâmetros personalizados.

Regras para valores de atributos data:

  • Nomes de objetivos: mesmas regras do método JavaScript (letras minúsculas, números, sublinhados, hifens, max 64 caracteres)
  • Nomes de parâmetros: derivados do nome do atributo e convertidos de kebab-case para snake_case (por ex., data-fs-goal-product-id torna-se product_id)
  • Valores de parâmetros: qualquer string, max 255 caracteres (automaticamente higienizado)
  • Máximo de 10 parâmetros personalizados por evento

Limitações do rastreamento do lado do cliente

Embora simples de implementar, o rastreamento do lado do cliente pode ser menos preciso devido a bloqueadores de anúncios ou problemas de rede. Para maior confiabilidade, considere o rastreamento do lado do servidor.

Método nº3: Rastreamento do lado do servidor (mais preciso)

Rastreie objetivos enviando dados diretamente do seu servidor via a API Flowsery Analytics. Esta e a abordagem recomendada para máxima precisão.

  • Obtenha uma chave API: use uma chave API de website em Tokens de API > Chaves de Website para uma integração server-side de um único site, ou um token API de workspace em API Tokens para acesso API/MCP no nível do workspace.
  • Envie dados do objetivo: Use o endpoint da API Goal para enviar informações do objetivo a partir do seu backend sempre que um usuário concluir a ação desejada.

Rastreamento de receita

Para rastrear receita especificamente (por ex., compras concluidas), use a configuração dedicada de atribuição de receita em vez de objetivos personalizados para pagamentos. Isso fornece análises financeiras mais detalhadas através da integração com Stripe, LemonSqueezy ou Polar.

Visualizando parâmetros personalizados no seu painel

Quando você passa parâmetros personalizados para um objetivo (usando qualquer um dos métodos acima), eles ficam visiveis diretamente no seu painel.

  • Navegue até o seu painel de análises
  • Passe o mouse sobre qualquer objetivo no cartão de Objetivos
  • Clique no ícone de parâmetros para expandir o detalhamento

Você vera um detalhamento de cada valor de parâmetro e quantos visitantes corresponderam. Por exemplo, se você rastreia um objetivo initiate_checkout com um parâmetro plan, você pode ver quantos visitantes fizeram checkout em cada plano (starter, pro, premium, etc.).

Isso funciona com qualquer parâmetro personalizado que você enviar: e-mails de usuários, nomes de produtos, tipos de plano, moedas ou qualquer outra coisa que você escolher rastrear.

Faturamento

Uso mensal

Os objetivos personalizados contam para o seu uso mensal do Flowsery Analytics. Certifique-se de rastrear apenas o necessário. Você pode revisar seu uso nas configurações de faturamento do Flowsery Analytics.