Instalar o snippet

O snippet é uma linha de JavaScript (menos de 5 KB) que:

• lê o código de indicação da URL (?ref=CODIGO, ou o parâmetro que você configurou no programa) e guarda num cookie do seu domínio pela janela de atribuição (60 dias por padrão);
• registra o clique;
• expõe Filiafy.convert() para você registrar o cadastro de quem chegou indicado.

Copie o código pronto em Integrações → Snippet de rastreamento: ele já vem com o endereço do seu programa. Os exemplos abaixo usam seu-programa.

HTML

Cole antes de </head> em todas as páginas do site e do app:

<script async src="https://filiafy.com.br/t.js?p=seu-programa"></script>

Google Tag Manager

Crie uma tag do tipo HTML personalizado com o mesmo código, acionada em Todas as páginas, e publique o contêiner.

Next.js

No layout raiz (app/layout.tsx):

import Script from 'next/script'

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="pt-BR">
      <body>
        {children}
        <Script src="https://filiafy.com.br/t.js?p=seu-programa" strategy="afterInteractive" />
      </body>
    </html>
  )
}

React (Vite, Create React App)

Cole a tag do HTML no index.html do projeto, dentro de <head>. Não é preciso nenhum pacote.

Bubble

Em Settings → SEO / metatags → Script/meta tags in header, cole a tag do HTML. Para registrar o cadastro, use um elemento HTML ou o plugin Toolbox para rodar o JavaScript abaixo depois do "Sign the user up".

Registrar o cadastro

Quando alguém criar conta no seu app, chame:

window.Filiafy?.convert({
  email: usuario.email,
  externalId: usuario.id, // opcional: o id do cliente no seu sistema
})

Se a pessoa não chegou por indicação, a chamada não faz nada. Prefere fazer do seu servidor? Use POST /api/v1/leads (veja a API).

Verificar a instalação

Em Integrações, clique em Verificar instalação: abrimos seu site com ?filiafy_verificar=1 e, quando o snippet responde, o card mostra "Instalado" com o domínio de onde veio o sinal.

Consentimento de cookies (LGPD)

Se o seu site pede consentimento antes de cookies, defina window.filiafyConsent = false antes do snippet e chame Filiafy.setConsent(true) depois do aceite. Até lá o snippet não grava nada nem envia dados.