Documentação

SDK Web

Instale pageviews, eventos e Error Tracking com uma chave pública restrita às origens do seu site.

Instalação e pageviews

Crie uma chave na área Analytics do projeto, cadastre origens completas como https://cliente.com e cole o snippet antes de </body>. O SDK registra o carregamento inicial e navegações SPA.

HTML

<script src="https://SEU-DOMINIO/sdk/v1.js" data-key="pk_nextfy_..." data-capture-errors="true" data-environment="production" data-release="2026.09.02" async></script>

Para inicialização explícita, use:

JavaScript

nextfy.init({
  key: 'pk_nextfy_...',
  endpoint: 'https://SEU-DOMINIO/api/v1/analytics',
  captureErrors: true,
  environment: 'production',
  release: '2026.09.02'
});

Eventos customizados

Use nomes estáveis e propriedades pequenas. Não envie e-mail, telefone, documento, endereço, token ou conteúdo digitado pelo usuário.

JavaScript

nextfy.track('agendamento_iniciado', {
  service: 'corte',
  value: 50
});

nextfy.track('agendamento_concluido', {
  service: 'corte'
});

Error Tracking

A captura automática observa erros globais e promises rejeitadas quando captureErrors está ativo. A captura explícita adiciona contexto controlado. Release e environment ajudam a separar implantações.

JavaScript

try {
  await confirmarAgendamento();
} catch (error) {
  nextfy.captureException(error, {
    feature: 'agendamento'
  });
}

Opt-out, DNT e privacidade

Por padrão, Do Not Track e o opt-out bloqueiam toda coleta. O SDK não lê cookies, formulários ou corpos de requisição e não usa fingerprinting. Remova parâmetros sensíveis das URLs antes de instrumentar.

JavaScript

nextfy.optOut(); // interrompe e limpa a fila local
nextfy.optIn();  // reativa, se sua base legal permitir

A organização que opera o site é responsável por definir base legal, consentimento e aviso adequado. Consulte também a nota de privacidade do produto.