Tracker über die eigene Domain ausliefern
Leiten Sie zwei Pfade Ihrer Domain an Glyphex weiter, damit blockierte Anfragen keine echten Besuche mehr verstecken.
Warum
Blocklisten und Browser-Schutzfunktionen blockieren manche Analytics-Anfragen von Drittanbietern. Besucher, die sie nutzen, lesen Ihre Seiten trotzdem, aber ihre Besuche werden nicht gezählt. Kommen Tracker und Anfragen von Ihrer eigenen Domain, bleiben Ihre Zahlen näher an der Wirklichkeit.
Glyphex arbeitet ohne Cookies und speichert keine personenbezogenen Daten. Die Auslieferung über Ihre Domain ändert deshalb nichts an Ihren Einwilligungspflichten. Do Not Track und Global Privacy Control werden weiterhin beachtet: Diese Besucher werden nicht gezählt.
Die zwei Pfade
Wählen Sie einen neutralen Pfadnamen. Diese Anleitung verwendet /gx:
/gx/jsleitet weiter anhttps://glyphex.io/t/YOUR_SITE_ID.js/gx/eventleitet weiter anhttps://glyphex.io/api/flow
Vermeiden Sie Wörter, nach denen Blocklisten suchen, etwa /stats, /analytics, /tracker oder /collect.
Ingest-Schlüssel erstellen
Anfragen über Ihren Proxy kommen von Ihrem Server. Glyphex sähe also für jeden Besucher dieselbe Adresse, mit falschen Besucherzahlen und Standorten. Der Event-Pfad sendet deshalb die IP des Besuchers in einem Header, signiert mit einem Schlüssel Ihrer Website.
- Öffnen Sie in Glyphex die Website-Einstellungen und dort API-Schlüssel.
- Erstellen Sie einen Schlüssel mit dem Bereich Agent-Zugriffe senden.
- Speichern Sie ihn auf Ihrem Server, zum Beispiel als Umgebungsvariable
GLYPHEX_INGEST_KEY.
Der Schlüssel bleibt auf dem Server. Setzen Sie ihn nie in das Script-Tag oder in Code, der im Browser läuft.
Ein Schlüssel trägt bis zu 6.000 Anfragen pro Minute. Darüber hinaus werden Anfragen wie ohne Schlüssel behandelt: Sie teilen sich die Adresse Ihres Servers und dessen Ratenlimit, daher werden manche womöglich nicht gezählt.
Proxy einrichten
Next.js
Leiten Sie den Script-Pfad in next.config um:
// next.config.ts (or .js)
async rewrites() {
return [{ source: "/gx/js", destination: "https://glyphex.io/t/YOUR_SITE_ID.js" }];
},Leiten Sie den Event-Pfad in proxy.ts (Next.js 16) oder middleware.ts (Next.js 15, Export middleware) weiter. Dabei kommen Schlüssel und Besucher-IP hinzu, Cookies werden entfernt.
// 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"] };Lesen Sie die Besucher-IP aus einem Header, den Ihr Host setzt und überschreibt, nie aus einem, den ein Browser senden kann: x-real-ip hinter nginx (proxy_set_header X-Real-IP $remote_addr) und auf Vercel, cf-connecting-ip, wenn Cloudflare direkt mit der App spricht. Wenn Sie eine Sprach-Middleware nutzen, nehmen Sie /gx/ von deren Weiterleitungen aus.
nginx
Fügen Sie Ihrem server-Block zwei location-Blöcke hinzu und setzen Sie Ihren Schlüssel ein.
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;
}Hinter Cloudflare verwenden Sie $http_cf_connecting_ip statt $remote_addr. Behalten Sie proxy_ssl_server_name on: Ohne diese Zeile schlägt die TLS-Verbindung zu glyphex.io fehl.
Cloudflare Worker
Erstellen Sie einen Worker mit einer Route für yourdomain.com/gx/* und hinterlegen Sie den Schlüssel als 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 });
},
};Script-Tag anpassen
Ersetzen Sie Ihr bisheriges Tag. src lädt den Tracker von Ihrer Domain, data-api schickt die Anfragen an Ihre Domain.
<script defer src="/gx/js" data-api="/gx/event" data-site-id="YOUR_SITE_ID"></script>
Ersetzen Sie YOUR_SITE_ID in den Proxy-Regeln oben und im Tag durch die ID aus Ihren Website-Einstellungen.
Prüfen
- Öffnen Sie die Website-Einstellungen in Glyphex.
- Gehen Sie zum Abschnitt Tracker über Ihre eigene Domain bereitstellen.
- Geben Sie Ihre Basis-URL ein, zum Beispiel
https://yourdomain.com/gx, und klicken Sie auf Proxy prüfen.
Die Prüfung ruft /js und /event über Ihre Domain auf. Schlägt einer der beiden fehl, nennt sie die Regel, die Sie korrigieren müssen. Den Schlüssel prüft sie nicht: Nach einigen Besuchen sollten die Standorte zu Ihrem Publikum passen, nicht zu Ihrem Server.