Geoloc API

Vue d’ensemble

Le Geoloc API vous permet d’enrichir les données de trafic de votre site web avec des informations géographiques sur vos visiteurs — sans avoir besoin du support de votre équipe technique. Ce service fournit des attributs de localisation précis tels que :

• Code de continent

• Code pays

• Région

• Ville

• Code postal

• Latitude et longitude

Note : Geoloc est une fonctionnalité optionnelle et facturable. Veuillez contacter votre représentant commercial Commanders Act pour obtenir les détails tarifaires.

---

Fonctionnement

Pour récupérer les données de geoloc, notre système envoie une requête vers l’endpoint suivant :

https://api.commander1.com/geoloc?token=XXX&site=XXX

Paramètres :

Paramètre	Description
token	API token fourni par l’équipe support Commanders Act
site	ID du site (workspace Commanders Act) demandant geoloc

L’API renvoie un objet JSON contenant les détails géographiques du visiteur.

Exemple de réponse

{
  "continentCode": "EU",
  "countryCode": "FR",
  "region": "Île-de-France",
  "longitude": 2.3333,
  "latitude": 48.8667,
  "city": "Paris",
  "postalCode": "75001"
}

---

Utilisation de Geoloca dans votre bloc personnalisé JavaScript

Voici un exemple simple montrant comment appeler l’API et stocker le résultat dans tC.internalvars pour une utilisation dans TMS. Vous pouvez utiliser ce code dans votre bloc JavaScript personnalisé.

Exemple de script

function httpGet(url) {
  var xmlHttp = new XMLHttpRequest();
  xmlHttp.open("GET", url, false); // requête synchrone
  xmlHttp.send(null);
  return JSON.parse(xmlHttp.responseText);
}

tC.internalvars.geoloc = httpGet("https://api.commander1.com/geoloc/?site={YOUR SITE ID}&token={YOUR TOKEN}");

Une fois attribué, vous pouvez utiliser n’importe quel champ directement via internalvars

tC.internalvars.geoloc.continentCode  // "EU"
tC.internalvars.geoloc.countryCode    // "FR"
tC.internalvars.geoloc.region         // "Île-de-France"
tC.internalvars.geoloc.longitude      // 2.3399
tC.internalvars.geoloc.latitude       // 48.8718
tC.internalvars.geoloc.city           // "Paris"
tC.internalvars.geoloc.postalCode     // "75009"

Ces variables peuvent désormais être utilisées pour créer vos propres règles personnalisées, comme afficher un bandeau de confidentialité pour différents pays.