Servir le tracker depuis votre propre domaine
Transmettez deux chemins de votre domaine à Glyphex, pour que les requêtes bloquées ne masquent plus de vraies visites.
Pourquoi
Les listes de blocage et les protections des navigateurs bloquent certaines requêtes d'analytique tierces. Les visiteurs qui les utilisent lisent quand même vos pages, mais leurs visites ne sont pas comptées. Quand le tracker et ses requêtes passent par votre propre domaine, vos chiffres restent plus proches de la réalité.
Glyphex fonctionne sans cookies et ne stocke aucune donnée personnelle : le servir depuis votre domaine ne change donc rien à vos obligations de consentement. Do Not Track et Global Privacy Control restent respectés : ces visiteurs ne sont pas comptés.
Les deux chemins
Choisissez un nom de chemin neutre. Ce guide utilise /gx :
/gx/jsrenvoie vershttps://glyphex.io/t/YOUR_SITE_ID.js/gx/eventrenvoie vershttps://glyphex.io/api/flow
Évitez les mots que les listes de blocage recherchent, comme /stats, /analytics, /tracker ou /collect.
Créer une clé d'envoi
Les requêtes qui passent par votre proxy viennent de votre serveur : Glyphex verrait la même adresse pour chaque visiteur, avec un nombre de visiteurs et des localisations faux. Le chemin des événements envoie donc l'IP du visiteur dans un en-tête, signé avec une clé de votre site.
- Dans Glyphex, ouvrez les paramètres de votre site, puis Clés API.
- Créez une clé avec la portée Envoyer les accès d'agents.
- Conservez-la sur votre serveur, par exemple dans la variable d'environnement
GLYPHEX_INGEST_KEY.
La clé reste sur le serveur. Ne la mettez jamais dans la balise script ni dans du code exécuté par le navigateur.
Une clé transmet jusqu'à 6 000 requêtes par minute. Au-delà, les requêtes sont traitées comme sans clé : elles partagent l'adresse de votre serveur et sa limite de débit, donc certaines peuvent ne pas être comptées.
Configurer le proxy
Next.js
Réécrivez le chemin du script dans next.config :
// next.config.ts (or .js)
async rewrites() {
return [{ source: "/gx/js", destination: "https://glyphex.io/t/YOUR_SITE_ID.js" }];
},Transmettez le chemin des événements depuis proxy.ts (Next.js 16) ou middleware.ts (Next.js 15, exportez middleware). Il ajoute la clé et l'IP du visiteur, et retire les cookies.
// proxy.ts (Next 16) or middleware.ts (Next 15: export function middleware)
import { NextResponse, type NextRequest } from "next/server";
export function proxy(request: NextRequest) {
if (request.nextUrl.pathname === "/gx/event") {
const headers = new Headers(request.headers);
// Cloudflare in front of Glyphex refuses (403) a request that carries cf-* headers.
for (const name of Array.from(headers.keys())) if (name.startsWith("cf-")) headers.delete(name);
headers.delete("cookie");
headers.delete("authorization");
headers.delete("x-glyphex-client-ip");
// Visitor IP from the header your host sets and overwrites (never one the browser can send):
// nginx in front (proxy_set_header X-Real-IP $remote_addr): "x-real-ip".
// Vercel: "x-real-ip". Cloudflare straight to the app: "cf-connecting-ip".
const ip = request.headers.get("x-real-ip");
const key = process.env.GLYPHEX_INGEST_KEY;
if (ip && key) {
headers.set("authorization", `Bearer ${key}`);
headers.set("x-glyphex-client-ip", ip);
}
return NextResponse.rewrite(new URL("https://glyphex.io/api/flow"), { request: { headers } });
}
// ...your existing proxy / middleware code
return NextResponse.next();
}
// Add "/gx/event" to your matcher. Keep /gx/ out of locale redirects.
export const config = { matcher: ["/gx/event"] };Lisez l'IP du visiteur dans un en-tête que votre hébergeur définit et écrase, jamais dans un en-tête qu'un navigateur peut envoyer : x-real-ip derrière nginx (proxy_set_header X-Real-IP $remote_addr) et sur Vercel, cf-connecting-ip quand Cloudflare parle directement à l'application. Si vous utilisez un middleware de langue, excluez /gx/ de ses redirections.
nginx
Ajoutez deux blocs location à votre bloc server et collez votre clé.
location = /gx/js {
proxy_pass https://glyphex.io/t/YOUR_SITE_ID.js;
proxy_ssl_server_name on;
}
location = /gx/event {
proxy_pass https://glyphex.io/api/flow;
proxy_ssl_server_name on;
proxy_set_header Cookie "";
# Cloudflare in front of Glyphex refuses (403) a request that carries CF-Connecting-IP.
proxy_set_header CF-Connecting-IP "";
proxy_set_header Authorization "Bearer glx_YOUR_INGEST_KEY";
# Behind Cloudflare use $http_cf_connecting_ip instead of $remote_addr.
proxy_set_header X-Glyphex-Client-IP $remote_addr;
}Derrière Cloudflare, utilisez $http_cf_connecting_ip au lieu de $remote_addr. Gardez proxy_ssl_server_name on : sans cette ligne, la connexion TLS avec glyphex.io échoue.
Cloudflare Worker
Créez un Worker avec une route pour yourdomain.com/gx/* et ajoutez la clé comme secret GLYPHEX_INGEST_KEY.
// Cloudflare Worker routed at yourdomain.com/gx/*
// Secret: npx wrangler secret put GLYPHEX_INGEST_KEY
export default {
async fetch(request, env) {
const url = new URL(request.url);
if (url.pathname === "/gx/js") {
return fetch("https://glyphex.io/t/YOUR_SITE_ID.js");
}
if (url.pathname === "/gx/event") {
const headers = new Headers(request.headers);
for (const name of Array.from(headers.keys())) if (name.startsWith("cf-")) headers.delete(name);
headers.delete("cookie");
headers.set("authorization", `Bearer ${env.GLYPHEX_INGEST_KEY}`);
headers.set("x-glyphex-client-ip", request.headers.get("cf-connecting-ip") ?? "");
return fetch("https://glyphex.io/api/flow", { method: request.method, headers, body: request.body });
}
return new Response("Not found", { status: 404 });
},
};Mettre à jour la balise script
Remplacez votre balise actuelle. src charge le tracker depuis votre domaine, data-api envoie les requêtes à votre domaine.
<script defer src="/gx/js" data-api="/gx/event" data-site-id="YOUR_SITE_ID"></script>
Remplacez YOUR_SITE_ID, dans les règles du proxy ci-dessus et dans la balise, par l'identifiant affiché dans les paramètres de votre site.
Vérifier
- Ouvrez les paramètres de votre site dans Glyphex.
- Allez à la section Servir le tracker depuis votre domaine.
- Saisissez votre URL de base, par exemple
https://yourdomain.com/gx, puis cliquez sur Vérifier le proxy.
La vérification appelle /js et /event via votre domaine. Si l'un des deux échoue, elle indique la règle à corriger. Elle ne vérifie pas la clé : après quelques visites, les localisations doivent correspondre à votre audience, pas à votre serveur.