@funnel10x/tracking 1.1.0 → 1.2.0

package/README.md

@@ -22,13 +22,15 @@ 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 da pessoa, quando ela os dá** (a 1.1.0, como a
-  HYROS): 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 de qualquer form da página, à saída do campo e no envio. O telefone
+- **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`, `field` ou `form`), cada valor uma vez por página, e
+  `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;
@@ -124,8 +126,14 @@ nova é uma tag nova, nunca `@1` nem `@latest`: o GTM de cada site diz que vers
 corre, e o `tracking_version` de cada evento confirma-o.
 
 **Numa página de um funil do GHL, o form é nativo** (sem `<form>`, cada campo
-com o query key em `data-q`): o snippet escreve nos campos cujo query key é um
-dos valores, e o GHL envia-os. **Um form do GHL embebido noutro site corre num
+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

package/dist/gtm.html

@@ -1,8 +1,8 @@
-<!-- @funnel10x/tracking@1.1.0: 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.1.0/dist/tag.js" integrity="sha384-2ACrLX/l5RYZ+55HKpvkNM5uzAhAqQPoGWoGqj3w4mKUcSAMKYV8glWCJBbSDDD+" 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>