Este repositório contém scripts personalizados desenvolvidos para serem implementados via Google Tag Manager (GTM). O objetivo principal é garantir a persistência de dados de rastreamento, atribuição de origem (UTMs) e geolocalização, além de manter a consistência desses dados durante a navegação do usuário.
O projeto é composto por dois arquivos HTML principais, cada um com um propósito e momento de disparo específicos dentro do ciclo de vida do GTM.
Este script é o núcleo do rastreamento de sessão e atribuição. Ele gerencia identificadores únicos e garante que os parâmetros de origem acompanhem o usuário.
- Gatilho no GTM:
DOM Ready(Disparado quando o modelo de objeto do documento está pronto). - Domínio de Cookies:
.alemdafotografia.net
- Identificação do Usuário (
index):- Verifica a existência do cookie
index. Se não existir, tenta recuperar dolocalStorageou cria um novo usando a variável do GTM{{event_id}}. - Persiste o ID em Cookie (1 ano),
localStorageesessionStorage.
- Verifica a existência do cookie
- Registro de Data de Entrada (
entry_date):- Salva o timestamp do primeiro acesso do usuário para análises de coorte ou tempo de vida.
- Persistência de UTMs:
- Captura parâmetros UTM (
utm_source,utm_medium, etc.) e identificadores de clique (gclid,fbclid) da URL. - Salva esses valores em cookies de longa duração (2 anos) para garantir atribuição mesmo em visitas futuras diretas (exceto se a fonte for 'organico').
- Captura parâmetros UTM (
- Enriquecimento de Links e Iframes:
- Varre automaticamente todos os links (
<a>) e iframes da página. - Adiciona os parâmetros de rastreamento (
sckpara o ID esrcpara as UTMs) às URLs de destino. Isso garante que o rastreamento não seja perdido ao navegar para outros domínios ou subdomínios controlados.
- Varre automaticamente todos os links (
{{event_id}}: Usado como valor base para o cookieindexse nenhum existir.
Este script foca no enriquecimento de dados do usuário com informações de geolocalização obtidas via API.
- Gatilho no GTM:
visitor-api-success(Deve ser configurado para disparar após o sucesso da chamada a uma API de identificação de visitante, como a VisitorAPI). - Domínio de Cookies:
.alemdafotografia.net
- Define cookies seguros (
Secure,SameSite=None) com duração de 1 ano para:- Cidade: Cookie
LeadCity. - Estado/Região: Cookie
LeadState. - País: Cookie
LeadCountry.
- Cidade: Cookie
{{jsc - city (fb)}}: Para popular o cookieLeadCity.{{dlv - visitorApiRegion}}: Para popular o cookieLeadState.{{dlv - visitorApiCountryCode}}: Para popular o cookieLeadCountry.
- Crie duas tags do tipo HTML Personalizado no Google Tag Manager.
- Copie o conteúdo de
setCookieIndex.htmlpara a primeira tag e configure o acionador para DOM Ready. - Copie o conteúdo de
setCookiesGeoLoc.htmlpara a segunda tag e configure o acionador para o evento personalizado visitor-api-success. - Certifique-se de que as variáveis GTM citadas acima estejam criadas e populadas corretamente no seu contêiner.