Este artigo faz parte da série Adapte seu banner a cada versão do seu site. Antes de seguir o guia abaixo, certifique-se de ter lido o artigo de apresentação geral Escolha o método adequado para carregar o banner Axeptio correto.
A geolocalização permite carregar automaticamente a configuração mais adequada de acordo com a localização do visitante, determinada através de seu endereço IP.
Isso é particularmente útil quando seu site precisa aplicar regulamentações diferentes dependendo dos países (RGPD, CCPA, Lei 25…) e a localização é um critério mais relevante do que o idioma ou a estrutura da URL.
A geolocalização é ativada no nível do projeto como um todo. Uma vez ativada, ela sempre tem prioridade sobre qualquer direcionamento por script (parâmetro cookiesVersion) ou por regras de URL de página, em todos os sites que carregam este projeto Axeptio.
Como funciona?
Se você restringiu a visibilidade do banner a certos países (veja mais abaixo neste artigo), essa verificação é realizada em primeiro lugar: para um visitante localizado em um país não autorizado, nenhum banner será exibido, independentemente da ordem de prioridade descrita abaixo.
Quando a geolocalização está ativada, o Axeptio seleciona a configuração a ser carregada de acordo com a seguinte ordem de prioridade:
Direcionamento por subdivisão — se uma ou mais configurações direcionam diretamente a subdivisão do visitante (ex. Quebec, Califórnia), elas se tornam candidatas prioritárias. Este direcionamento é configurado no nível de cada configuração, independentemente da geolocalização.
Direcionamento por país — na falta de direcionamento por subdivisão, se uma ou mais configurações direcionam diretamente o país do visitante, elas se tornam candidatas.
Regulamentação do país do visitante — na falta de direcionamento direto, o Axeptio detecta o endereço IP do visitante e identifica a regulamentação associada ao seu país (ex. RGPD para um visitante da Espanha). Todas as configurações correspondentes a essa regulamentação se tornam candidatas.
Configuração padrão (fallback) — se nenhuma configuração for candidata em nenhum dos níveis anteriores, o Axeptio carrega a configuração padrão que você definiu.
Assim que um nível produz várias configurações candidatas, o idioma do navegador do visitante decide: o Axeptio retém aquela cujo idioma corresponde; caso contrário, a primeira configuração candidata é usada.
O Axeptio usa o idioma do navegador do visitante, não o idioma do site (veja cenário 2 abaixo).
A configuração padrão deve ser publicada para estar ativa.
Exemplo
Os cenários abaixo ilustram os níveis 3 (regulamentação) e 4 (fallback) da ordem de prioridade: nenhuma das configurações neste exemplo direcionam diretamente um país ou uma subdivisão.
Configuração
Configurações publicadas, nesta ordem: RGPD FR, RGPD EN, RGPD ES, RGPD IT, RGPD DE
Configuração padrão: RGPD FR
Nenhuma dessas 5 configurações direciona diretamente um país ou uma subdivisão
Para os cenários 1 a 5 abaixo, nenhuma outra regulamentação (CCPA, Lei 25…) é configurada no projeto. O cenário 6 adiciona uma configuração adicional a este projeto base.
O IP detectado nem sempre corresponde à localização real do visitante: uma VPN, um proxy corporativo ou um IP não reconhecido podem distorcer essa detecção (veja cenário 5 abaixo).
Cenário 1 — uma configuração corresponde
Variável | Valor |
Localização real do visitante | Espanha |
IP detectado | Espanha |
Regulamentação associada a este IP | RGPD |
Idioma do navegador | Espanhol |
Resultado: a configuração RGPD ES é carregada.
Por quê:
O Axeptio detecta um IP espanhol e associa a regulamentação RGPD a ele.
As 5 configurações RGPD são candidatas.
Como o idioma do navegador é espanhol, a configuração RGPD ES é retida entre as candidatas.
Cenário 2 — o navegador não está no idioma do site
Variável | Valor |
Localização real do visitante | França |
IP detectado | França |
Regulamentação associada a este IP | RGPD |
Idioma do navegador | Inglês |
Resultado: a configuração RGPD EN é carregada, mesmo em uma página /fr/.
Por quê:
O Axeptio detecta um IP francês e associa a regulamentação RGPD a ele.
As 5 configurações RGPD são candidatas.
Como o navegador está em inglês, a configuração RGPD EN é retida entre as candidatas. O banner segue o idioma do navegador, não a URL nem o idioma exibido do site.
Cenário 3 — a regulamentação não corresponde a nenhuma configuração
Variável | Valor |
Localização real do visitante | Estados Unidos |
IP detectado | Estados Unidos |
Regulamentação associada a este IP | CCPA |
Idioma do navegador | Inglês |
Resultado: a configuração padrão, RGPD FR, é carregada.
Por quê:
O Axeptio detecta um IP americano e associa a regulamentação CCPA a ele.
O projeto não contém nenhuma configuração CCPA (apenas configurações RGPD): nenhuma configuração é candidata.
Sem configuração candidata, a etapa de detecção do idioma do navegador nunca ocorre.
Cenário 4 — a regulamentação corresponde, mas nenhum idioma candidato corresponde
Variável | Valor |
Localização real do visitante | Polônia |
IP detectado | Polônia |
Regulamentação associada a este IP | RGPD |
Idioma do navegador | Polonês |
Resultado: a configuração RGPD FR é carregada, mas não porque está definida como banner padrão.
Por quê:
O Axeptio detecta um IP polonês e associa a regulamentação RGPD a ele.
As 5 configurações RGPD são candidatas.
Nenhuma dessas configurações está em polonês: nenhuma corresponde ao idioma do navegador.
Na falta de correspondência de idioma, o Axeptio retém a primeira configuração candidata na ordem do projeto — aqui RGPD FR, porque é a primeira na lista das 5 configurações RGPD. O banner padrão não intervém em nenhum momento neste cenário: é usado apenas quando nenhuma configuração compartilha a regulamentação do visitante (veja cenários 3 e 5). Se RGPD FR não fosse a primeira configuração RGPD do projeto, outro banner RGPD seria carregado, mesmo que RGPD FR permanecesse como banner padrão.
Cenário 5 — uma VPN mascara a verdadeira localização
Variável | Valor |
Localização real do visitante | França |
IP detectado | Estados Unidos (VPN ativa) |
Regulamentação associada a este IP | CCPA |
Idioma do navegador | Francês |
Resultado: a configuração padrão, RGPD FR, é carregada, embora o RGPD devesse ter se aplicado.
Por quê:
O Axeptio vê apenas o IP americano fornecido pela VPN e associa a regulamentação CCPA a ele.
O projeto não contém nenhuma configuração CCPA: nenhuma configuração é candidata.
O visitante é na verdade um residente europeu a quem o RGPD deveria se aplicar, mas o Axeptio não tem como saber: apenas o IP conta.
Cenário 6 — uma configuração direciona diretamente o país do visitante
Além das 5 configurações RGPD acima, o projeto contém uma configuração CCPA que direciona diretamente o país "Estados Unidos", independentemente de sua regulamentação. Este é o caso mais frequente na prática: por exemplo, um site com um banner RGPD padrão para o resto do mundo e um banner dedicado explicitamente direcionado a um país específico (Estados Unidos, Canadá…).
Variável | Valor |
Localização real do visitante | Estados Unidos |
IP detectado | Estados Unidos |
Direcionamento direto por país | Uma configuração direciona "Estados Unidos" |
Idioma do navegador | Inglês |
Resultado: a configuração que direciona diretamente os Estados Unidos é carregada.
Por quê:
Uma configuração direciona diretamente o país do visitante (nível 2 da ordem de prioridade): ela se torna candidata antes mesmo da regulamentação ser avaliada.
Nenhuma outra configuração direciona diretamente os Estados Unidos: é a única candidata neste nível, é retida imediatamente, sem nem mesmo olhar para a regulamentação nem as 5 configurações RGPD.
O direcionamento direto por subdivisão (nível 1, ex. Quebec ou Califórnia) funciona exatamente da mesma forma, com uma prioridade ainda mais alta: uma configuração direcionando uma subdivisão prevalece sobre uma configuração direcionando todo o país.
Ativar a geolocalização
A geolocalização é configurada a partir da lista de configurações do produto em questão, para Brands (Banners de cookies) ou Publishers (Banner de cookies TCF).
Vá para Meus banners do produto em questão.
Abra uma configuração.
Clique no botão Exibição geolocalizada no canto superior direito da página.
Na modal Geolocalização, ative o toggle Ativar exibição baseada em localização.
Selecione um banner padrão na seção Parâmetros padrão do banner — essa configuração será usada se nenhuma outra corresponder à localização do visitante.
Se desejar restringir a exibição do banner a certos países apenas, ative o toggle Visibilidade do banner e selecione os países relacionados. Essa restrição é verificada antes da seleção por geolocalização: um visitante localizado em um país não selecionado não verá nenhum banner, mesmo que uma configuração o corresponderia de outra forma.
Clique em Salvar e Publicar para que as alterações entrem em vigor.