Einstieg und Konto
Wo finde ich Site-ID, Schreibschlüssel und Serverschlüssel?
Site-ID und Schreibschlüssel stehen im Portal unter „Einrichtung“ und gehören in den Tracking-Code im Browser. Den Serverschlüssel legst du in der Einrichtung im Reiter „Server Events API“ mit „Serverschlüssel anlegen“ an; er ist geheim, gehört ausschließlich in dein Backend und steht nur beim Anlegen vollständig da. Lese-Schlüssel für Claude und eigene Auswertungen findest du unter „Exporte & KI-Verbindungen“ im Abschnitt „API-Zugang“.
Welcher Schlüssel gehört wohin, und welcher darf öffentlich sein?
| Angabe | Sichtbarkeit | Verwendung |
|---|---|---|
| Site-ID | öffentlich | Tracking-Code, Server Events API |
| Schreibschlüssel | öffentlich sichtbar, an Domains gebunden | Browser: GTM-Tag oder Snippet |
| Serverschlüssel | geheim | Server Events API, Webhooks, HMAC-Signatur |
| Lese-Schlüssel | geheim, kann nur lesen | Lese-API und MCP, angelegt unter „Exporte & KI-Verbindungen“ |
Dass der Schreibschlüssel im Quelltext der Seite steht, ist kein Fehler: Er ist an die freigegebenen Domains gebunden. Eine fremde Website kann ihn im Browser ihrer Besucher nicht verwenden, weil der Collector die Herkunft prüft und mit DOMAIN_NOT_ALLOWED antwortet. Eine Anfrage außerhalb eines Browsers hält diese Prüfung nicht ab: Wer den Schlüssel kopiert, kann damit Ereignisse und auch Käufe melden. Melde Käufe deshalb zusätzlich über deinen Server, mit der Server Events API oder einem Plugin. Dann gelten Wert und Währung vom Server, auch wenn vorher jemand dieselbe Bestellnummer über den Browser gemeldet hat.
Achtung
Der Serverschlüssel darf nie in Browser-Code, in ein Git-Repository oder in einen Tag Manager. Ist er versehentlich sichtbar geworden, erzeuge in der Einrichtung, Reiter „Server Events API“, einen neuen. Der alte Schlüssel wird dabei sofort widerrufen; ein widerrufener Schlüssel bekommt die Antwort SERVER_KEY_INVALID.
Zuletzt geprüft am 17.10.2026
Im Kundenportal
Ebenfalls gefragt
- Ist der Schreibschlüssel geheim?
- Wo finde ich meinen Schlüssel?
- Was ist der Unterschied zwischen Schreibschlüssel und Serverschlüssel?
- Wo lege ich einen Serverschlüssel an?
- Wo finde ich den Lese-Schlüssel für Claude?
Weiterführende Artikel
- Wie rotiere oder widerrufe ich einen Schlüssel?
Was tue ich, wenn ein Schlüssel versehentlich veröffentlicht worden ist?
Schreibschlüssel und Serverschlüssel erneuerst du in der Einrichtung, den Serverschlüssel im Reiter „Server Events API“, wo du ihn auch widerrufst. Lese-Schlüssel widerrufst du unter „Exporte & KI-Verbindungen“ im Abschnitt „API-Zugang“ und legst dort einen neuen an. Ein neuer Schlüssel steht nur einmal vollständig da, und der alte gilt sofort nicht mehr.
- Warum muss ich Domains freigeben?
Was bedeutet DOMAIN_NOT_ALLOWED und wie ergänze ich eine Domain?
Der Schreibschlüssel ist im Quelltext sichtbar; damit ihn keine fremde Website im Browser ihrer Besucher verwenden kann, prüft der Collector die Herkunft der Anfrage. Steht die Domain nicht in der Liste der erlaubten Domains, wird das Event mit DOMAIN_NOT_ALLOWED abgewiesen. Eine Anfrage außerhalb eines Browsers hält diese Prüfung nicht ab, deshalb meldest du Käufe am besten zusätzlich über deinen Server.
- Wie melde ich Conversions serverseitig?
Wie sende ich Events aus meinem Shop, CRM oder Backend?
Über POST /v1/server/events an den Collector, mit dem Serverschlüssel im Authorization-Header. Die Adresse und den fertigen Aufruf für deine Website zeigt das Portal unter „Einrichtung“ im Reiter „Server Events API“. Der Aufruf ist unabhängig vom Browser und damit robust gegenüber Adblockern und kurzlebigen Cookies.
- Wie schließe ich mein eigenes KI-Werkzeug an?
Gibt es einen MCP-Server für Metrunio?
Über den MCP-Server von Metrunio. Er stellt dieselben Lesewerkzeuge bereit wie der Chat im Portal. Claude und ChatGPT melden sich über OAuth an: Du gibst im Portal frei, welches Konto sie lesen. Andere Werkzeuge verwenden einen API-Schlüssel im Bereich „read“, denselben, den auch ein Skript für /v1/data verwenden würde.