Primeiros passos

Objetivos personalizados

Rastrear ações específicas de usuários além das visualizações de página

Flowsery Analytics permite monitorar acoes especificas dos usuarios alem das visualizacoes de pagina, 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 previsoes de receita e os funis de conversao

Voce pode rastrear objetivos usando tres metodos:

Metodo nº1: Rastreamento do lado do cliente com JavaScript

Chame a funcao flowsery() e passe o nome do seu objetivo como argumento. Coloque o trecho JavaScript onde a conversao acontece (por exemplo, em uma pagina de agradecimento apos o cadastro, quando um usuario clica em um botao, etc.).

window?.flowsery("signup");

Regras para goal_name:

  • Use letras minusculas
  • Numeros, sublinhados (_) e hifens (-) sao permitidos
  • Maximo de 64 caracteres

Uso avancado com parametros personalizados

Anexe um objeto com parametros personalizados aos seus objetivos para analises mais ricas no Journey:

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

Regras para parametros personalizados:

  • Nomes de propriedades: apenas letras minusculas, numeros, sublinhados (_) e hifens (-). Maximo de 64 caracteres.
  • Valores de propriedades: qualquer string, maximo de 255 caracteres.
  • Maximo de 10 parametros personalizados por evento.

Garantir rastreamento confiavel (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>

Metodo nº2: Rastreamento do lado do cliente com atributos data HTML

Rastreie objetivos automaticamente quando os usuarios clicam em qualquer elemento com o atributo data-fs-goal. Esta e a abordagem mais simples para rastrear cliques em botoes.

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

Neste exemplo, Flowsery Analytics envia um objetivo chamado initiate_checkout.

Uso avancado com parametros personalizados

Adicione atributos data-fs-goal-* adicionais para incluir parametros personalizados:

Objetivo por atributo data com parametros
<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 parametros personalizados.

Regras para valores de atributos data:

  • Nomes de objetivos: mesmas regras do metodo JavaScript (letras minusculas, numeros, sublinhados, hifens, max 64 caracteres)
  • Nomes de parametros: 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 parametros: qualquer string, max 255 caracteres (automaticamente higienizado)
  • Maximo de 10 parametros personalizados por evento

Limitacoes do rastreamento do lado do cliente

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

Metodo 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 maxima precisao.

  • Obtenha uma chave API: Acesse as Configuracoes do seu site > aba API e gere uma chave API para autenticar suas requisicoes.
  • Envie dados do objetivo: Use o endpoint da API Goal para enviar informacoes do objetivo a partir do seu backend sempre que um usuario concluir a acao desejada.

Rastreamento de receita

Para rastrear receita especificamente (por ex., compras concluidas), use a configuracao dedicada de atribuicao de receita em vez de objetivos personalizados para pagamentos. Isso fornece analises financeiras mais detalhadas atraves da integracao com Stripe, LemonSqueezy ou Polar.

Visualizando parametros personalizados no seu painel

Quando voce passa parametros personalizados para um objetivo (usando qualquer um dos metodos acima), eles ficam visiveis diretamente no seu painel.

  • Navegue ate o seu painel de analises
  • Passe o mouse sobre qualquer objetivo no cartao de Objetivos
  • Clique no icone de parametros para expandir o detalhamento

Voce vera um detalhamento de cada valor de parametro e quantos visitantes corresponderam. Por exemplo, se voce rastreia um objetivo initiate_checkout com um parametro plan, voce pode ver quantos visitantes fizeram checkout em cada plano (starter, pro, premium, etc.).

Isso funciona com qualquer parametro personalizado que voce enviar: e-mails de usuarios, nomes de produtos, tipos de plano, moedas ou qualquer outra coisa que voce escolher rastrear.

Faturamento

Faturamento baseado em uso

Os objetivos personalizados contam para o seu uso mensal do Flowsery Analytics. Certifique-se de rastrear apenas o necessario. Voce pode revisar seu uso nas configuracoes de faturamento do Flowsery Analytics.