APIs de geolocalização por IP e conteúdo localizado

15 de maio de 2023PersonalizaçãoPor Catherine Meira

Personalizar a jornada do usuário é uma prioridade para os melhores profissionais de marketing e CRO. Por isso, muitas empresas coletam dados do seu público-alvo para criar abordagens bem-sucedidas.

As APIs de geolocalização por IP são a melhor opção para personalizar o conteúdo do seu site com base na localização dos seus usuários. Nesse post, vamos falar sobre as APIs mais populares do mercado e te dar um passo-a-passo de como utilizá-las.

PlaybookUma nova alternativa para APIs de geolocalização por IP

Conheça uma nova forma de utilizar localização sem implementar múltiplas APIs e serviços.

Saiba mais

Como APIs de geolocalização por IP funcionam

APIs de geolocalização por IP são utilizadas para acessar dados de geolocalização associados a um IP. Uma empresa que utiliza essa ferramenta pode coletar informações como país, região e cidade de um usuário diretamente do seu próprio banco de dados.

Elas funcionam da seguinte maneira:

A API mapeia o endereço de IP obtido dos acessos ao servidor
A API busca por regiões correspondentes em sua base de dados
A API analisa a base de dados para encontrar padrões e correlações entre os endereços de IP utilizando algoritmos. Enquanto algumas APIs apenas informam a região de um IP, outras mais avançadas conseguem determinar até mesmo o CEP do usuário.

Adicionar uma API ao seu site requer uma integração HTTP. Os resultados e análises são trazidos em JSON.

A eficiência das APIs depende dos provedores de dados que elas utilizam para coletar informações de IP com precisão.

Escolhendo a melhor API para seu negócio

APIs de geolocalização por IP te ajudam a melhorar as estratégias de geomarketing da sua empresa e até a prevenir fraudes.

Esses são alguns dos pontos que você deve considerar ao escolher sua API:

Precisão

As APIs de geolocalização por IP foram criadas para priorizar dados precisos e atualizados. Ainda assim, você pode encontrar discrepâncias entre diferentes serviços. Isso acontece principalmente em regiões onde ainda há poucos dados disponíveis para uso.

A localização geográfica de um IP pode ser determinada através de várias fontes, como bancos de dados governamentais, provedores de internet e dados compartilhados por usuários. As empresas que criam APIs estabelecem o que chamamos de "parcerias de dados" com provedores locais, o que aumenta a confiabilidade dessas informações. Por esse motivo, uma API de geolocalização por IP pode oferecer resultados melhores no país onde está localizada.

Um bom exemplo é a API da MaxMind, que acessa dados adaptados exclusivamente para os EUA. A empresa faz parcerias locais e também recebe dados compartilhados por usuários, o que torna seu banco de dados muito mais preciso do que em outros países onde atua.

Coletar dados em locais onde há maior demanda por essas informações é muito mais fácil, pois existem mais bancos de dados à disposição. Mesmo assim, talvez isso não seja suficiente para corresponder às preferências da sua audiência. Na hora de escolher a melhor API para o seu negócio, sempre considere as que realizam buscas em diferentes áreas e atualizem seu banco de dados frequentemente.

APIs e privacidade de dados

As leis de proteção de dados online estão cada vez mais severas. Por isso, fontes como third-party cookies estão sendo descontinuadas. Essas leis consideram endereços de IP como informações pessoalmente identificáveis (PII), o que quer dizer que você precisa de atenção redobrada ao lidar com esses dados.

Se você usa uma API de geolocalização por IP, é importante garantir que não haja vulnerabilidades no seu site e na sua biblioteca de dados. Outra dica é sempre atualizar sua política de privacidade e deixá-la acessível e visível para seus clientes e visitantes. Esclareça como sua empresa usa os endereços de IP coletados e como guarda essas informações para que os usuários possam aceitar essas condições com segurança.

Proxy e VPN

Se o seu site for voltado para o consumidor final (B2C), o uso de proxys e VPNs provavelmente não será um problema. Isso porque a maioria dos visitantes usa dispositivos com redes locais, como 3G, 4G ou 5G. No entanto, muitas pessoas usam VPNs para trabalhar, o que pode mascarar sua localização e outros dados coletados pela API.

Frequência de atualização do banco de dados

A frequência das atualizações varia entre os provedores de API, mas recomendamos que você atualize o seu banco de dados pelo menos uma vez por semana. Isso garante que você tenha as informações mais recentes para planejar seu conteúdo.

APIs mais populares

Muitas APIs de geolocalização por IP são conhecidas no mercado por sua confiabilidade e banco de dados extensos. Aqui estão as cinco mais populares em 2023:

1. MaxMind GeoIP2

A Maxmind é uma das APIs de geolocalização por IP mais famosas graças à sua precisão e ao seu serviço de detecção de fraudes. A empresa também oferece um banco de dados extenso, com atualizações semanais e cobertura em diversos países. A biblioteca da MaxMind é integrável com várias plataformas de cyber security, o que é um destaque para desenvolvedores.

2. IP2Location

Se você quer uma API com um banco de dados extenso e atributos adicionais, como fuso horário, provedores de internet e domínios, a IP2 location é sua melhor opção. A empresa realiza atualizações mensais com filtros avançados, como clima, velocidade de rede e código de área, além de integração com recursos de geolocalização em aplicativos, sites ou sistemas.

3. GeoNames

A GeoNames possui um banco de dados comunitário. A empresa têm parceria com diversas organizações independentes e governamentais ao redor do mundo e oferece dados de localização, nomes, coordenadas geográficas, população e divisões administrativas, tudo de forma gratuita. A GeoNames também permite que os desenvolvedores obtenham dados de forma programática, devido à sua integração com aplicativos e serviços de dados populares.

4. IPinfo

A IPinfo afirma ter os dados de endereço de IP mais confiáveis e precisos do mercado. Eles refinam 20 terabytes de dados mensalmente usando algoritmos exclusivos por meio de cinco etapas: coleta e limpeza, aprendizado, verificação, atualização e análise.

Eles também permitem que você faça download e explore bancos de dados no site.

5. Telize

A Telize oferece uma API REST que permite obter o endereço de IP do visitante e buscar informações a partir dele. Ela oferece suporte tanto ao cross-origin resource sharing (CORS) quanto ao JSONP.

Embora sua API pública tenha sido permanentemente desativada em 2015, você ainda pode se inscrever em um dos planos pagos disponíveis no site para obter informações importantes sobre suas audiências.

Como integrar uma API em seu site

Para o passo-a-passo de como integrar uma API de localização por IP em seu site, vamos usar a GeoIP2 da MaxMind como exemplo. Ela fornece o banco de dados para download e integração da biblioteca.

Usando o banco de dados

Você pode criar seu próprio serviço de API e usar o banco de dados da MaxMind para recuperar dados de localização. Esses são os passos para integrar a biblioteca deles ao seu site:

1. Instale a biblioteca do cliente

No momento, é possível integrar a biblioteca em C#, Java, Node, PHP, Python e Ruby.

2. Configure um leitor de banco de dados

Configure o leitor de banco de dados deixando o arquivo acessível no sistema.

3. Consulte o banco de dados

Para isso, você precisa consultar o tipo de dado (“cidade” ou “país”, por exemplo) e adicionar o endereço de IP que quer pesquisar.

4. Analise a resposta da sua consulta

Se a consulta for bem-sucedida, a chamada do método retornará uma resposta com várias informações associadas ao IP fornecido.

5. Atualize seu banco de dados

Para isso, é essencial criar um processo de atualização para o seu banco de dados. Você pode, por exemplo, fazer isso criando um cron job diário, semanal ou mensal.

Depois de usar a API para coletar dados, você terá todas as informações que precisa para criar conteúdo personalizado para os seus usuários.

Usando a API

Para implementar a API, você pode usar uma integração server-side ou client-side. Aqui está um exemplo simples de integração client-side usando JavaScript.

É importante lembrar que implementações client-side podem deixar seu site vulnerável a ataques. Como essas APIs têm variação de preço por solicitação, você pode acabar com resultados indesejados se suas credenciais vazarem.

Para fazer a implementação em JavaScript, você precisa registrar seu domínio, adicionar uma linha de código em JavaScript em seu site, fazer a chamada ao serviço da API desejado e fornecer callbacks para todos os cenários.

1. Inscreva-se e obtenha uma chave de API

Entre no site da MaxMind e crie uma conta. Você vai receber uma chave de API para autenticar suas solicitações.

2. Adicione uma linha de código em JavaScript ao seu site

Este é o JavaScript para a API GeoIP2:

1
<script src="//geoip-js.com/js/apis/geoip2/v2.1/geoip2.js" type="text/javascript"></script>

3. Faça um request para conseguir os dados de localização

Siga as instruções da API para recuperar dados de localização. Você pode extrair informações específicas como país, cidade, latitude e longitude, etc.

4. Personalize seu site com base na localização do usuário

Agora você já tem informações suficientes para usar conteúdo dinâmico no seu site, adaptando a comunicação à cidade, região ou país dos usuários.

Aqui está um exemplo de JavaScript para personalizar seu conteúdo localizado com a GeoIP2:

1234567891011121314
<html>
  <head>
    <title>Which city am I in?</title>
    <script src="//geoip-js.com/js/apis/geoip2/v2.1/geoip2.js"></script>
    <!-- make sure this is after the geoip2.js file -->
    <script src="/example.js"></script>
  </head>

  <body>
    <p>
      You are currently in <span id="city"></span>.
    </p>
  </body>
</html>

E esse é o arquivo example.js:

12345678910111213141516171819202122232425262728293031
var fillInPage = (function() {
  var updateCityText = function(geoipResponse) {

    /*
     * It's possible that we won't have any names for this city, so you should provide a fallback result for cases like this.
     * For language codes with a special character such as pt-BR, replace names.en with names['pt-BR'].
    */
    var cityName = geoipResponse.city.names.en || 'your city';

    document.getElementById('city').innerHTML = cityName
  };

  var onSuccess = function(geoipResponse) {
    updateCityText(geoipResponse);
  };

  // If we get an error, we will display an error message
  var onError = function(error) {
    document.getElementById('city').innerHTML = 'an error!  Please try again..'
  };

  return function() {
    if (typeof geoip2 !== 'undefined') {
      geoip2.city(onSuccess, onError);
    } else {
      document.getElementById('city').innerHTML = 'a browser that blocks GeoIP2 requests'
    }
  };
}());

fillInPage();

Alternativas para APIs de geolocalização por IP

Se você chegou até aqui, deve estar procurando alternativas para personalizar o conteúdo do seu site com base em geolocalização.

APIs de geolocalização por IP precisam de manutenção constante e atualizações no banco de dados. Você também vai precisar integrar essa API ao seu CMS para que o time de marketing personalize o site com facilidade. Em alguns casos, você precisará atualizar o código fonte em cada mudança realizada.

Caso o time de marketing queira realizar testes AB, a atualização é ainda mais demorada.

Por isso, a Croct criou um headless CMS com personalização por localização geográfica e testes AB. Se você quiser saber como funciona, consulte nossa documentação para ter uma rápida visão geral e um guia simples de introdução. Experimente, é gratuito.

Conclusão

APIs de geolocalização por IP usam bancos de dados para acessar informações como país, região e cidade associadas ao IP do usuário.

Nesse artigo, você aprendeu como usar esses dados para personalizar o conteúdo do seu site, criar estratégias de marketing segmentadas e melhorar a experiência do usuário.

No entanto, se você busca por uma opção low-code e segura, a Croct é a melhor alternativa para uma integração sem a dificuldade de implementar uma API.

Crie sua conta hoje mesmo e descubra o poder da personalização por localização.

Explore:

Como fazer Localização