@funnel10x/tracking 1.0.1 → 1.2.0

package/README.md

@@ -22,6 +22,18 @@ O que faz numa página:
   e nos links do checkout;
 - **o identify pelo id do contacto** num link de email ou de SMS
   (`?contact_id={{contact.id}}`);
+- **o email e o telefone que a pessoa envia** (desde a 1.1.0, como a HYROS;
+  só no envio desde a 1.2.0): do URL, quando o funil os passa à página seguinte
+  (`email`, `phone`, `phoneNumber`, `phone_number`, `tel`, `telefone`), e dos
+  campos de email e de telefone do form que ela envia (o `submit` de um
+  `<form>`, ou o botão de enviar do form nativo do GHL). O de um form que ela
+  não enviou não sai do browser. O telefone
+  ganha o indicativo do seletor de país (o intl-tel-input), que é o que um
+  seletor costuma esconder. Vão num evento `contact_captured` (com
+  `contact_source`: `url` ou `form`), cada valor uma vez por página, e
+  só com o PostHog a medir. Não vão ao perfil (`$set`), que passaria o browser
+  a pessoa identificada, o escalão mais caro do PostHog: o perfil recebe-os do
+  identify do servidor, uma vez por contacto;
 - **a versão do snippet em cada evento** (`tracking_version`), e, num site
   `direct`, **a versão da página e o teste** (`page_version`, `ab_test`), o
   **interruptor de consentimento** do `site.json`, e a guarda das
@@ -113,7 +125,16 @@ condições de consentimento da tag no GTM, se o site tiver um banner). Uma vers
 nova é uma tag nova, nunca `@1` nem `@latest`: o GTM de cada site diz que versão
 corre, e o `tracking_version` de cada evento confirma-o.
 
-**O form do GHL corre num iframe** de outro domínio, onde o script da página
+**Numa página de um funil do GHL, o form é nativo** (sem `<form>`, cada campo
+com o query key em `data-q`), e **um campo escondido só se enche pelo URL com
+que a página carrega**: o GHL lê o query key quando a app arranca, e envia o
+estado dele, a que o campo não está ligado (medido a 2026-10-07: um valor
+escrito no campo depois, mesmo com o evento `input`, não chega ao envio, e a tag
+do *Head tracking code* corre já depois do arranque). Por isso, num funil do
+GHL, a ponte entre o dispositivo e o contacto é o email que a pessoa envia (o
+`contact_captured`), que o admin liga ao contacto criado nesse momento; o campo
+`ph_anon_id` só se enche quando o id já vem no URL. **Um form do GHL embebido noutro site corre num
+iframe** de outro domínio, onde o script da página
 não chega. O snippet passa ao iframe, pelo URL dele, os ids e os parâmetros do
 anúncio, e os campos escondidos do form lêem-nos de lá (cada campo com o
 *query key* igual ao nome). Se o form não os ler do URL, a mesma tag entra no

package/dist/gtm.html

@@ -1,8 +1,8 @@
-<!-- @funnel10x/tracking@1.0.1: a tag do GTM (Custom HTML, em All Pages). Só se muda a chave; uma versão nova é um ficheiro novo. -->
+<!-- @funnel10x/tracking@1.2.0: a tag do GTM (Custom HTML, em All Pages). Só se muda a chave; uma versão nova é um ficheiro novo. -->
 <script>
   window.f10xTracking = {
     key: '{{PostHog project key}}',
     checkoutHosts: []
   }
 </script>
-<script src="https://cdn.jsdelivr.net/npm/@funnel10x/tracking@1.0.1/dist/tag.js" integrity="sha384-TAV0wuwYZm3WbN/Lo9h2OzbAV0v6n3YnnyezN4+GuNeHWOaCDb+puCe0BRHE1rBx" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/@funnel10x/tracking@1.2.0/dist/tag.js" integrity="sha384-HBEVk3iHklebWrwCgMWKmqvpecTCfdlKHwUh1ic9eiqkpraFHWtDpGguHg+5mxw/" crossorigin="anonymous"></script>