User Agent Info

So nutzt du die automatische User-Agent-Anreicherung in deinem owntag Server Side GTM Container

owntag kann automatisch den User-Agent-Header jeder eingehenden HTTP-Anfrage analysieren und mit strukturierten Geräteinformationen anreichern. Damit kannst du Browser-, Betriebssystem- und Plattformdetails direkt als HTTP-Header in deinem Server Side GTM Container nutzen.

Verfügbare Header

Wenn User Agent Info aktiviert ist, werden folgende Header zu jeder Anfrage hinzugefügt:

HeaderBeschreibungBeispiel
x-owntag-device-mobile"true" wenn das Gerät ein Mobiltelefon ist, "false" andernfalls. Tablets sind "false".true
x-owntag-device-osName des BetriebssystemsWindows, macOS, Android, iOS
x-owntag-device-browserBrowsernameChrome, Safari, Firefox
x-owntag-device-browser-versionVollständige Browser-Versionszeichenfolge120.0.6099.109
x-owntag-device-engineName der Rendering-EngineBlink, WebKit, Gecko
x-owntag-device-engine-versionVersion der Rendering-Engine120.0.6099.109
x-owntag-device-platformPlattformtypdesktop, mobile, tablet

Nutzung im Server Side GTM

Die Geräteinformationen kannst du überall in Tags, Triggern und Variablen nutzen, indem du eine Variable vom Typ “Anfrage-Header” für den jeweiligen Header anlegst.

Zum Beispiel könntest du eine Variable für x-owntag-device-browser konfigurieren und dann als {{header.x-owntag-device-browser}} in deinen Tags oder Triggern nutzen.

Beispielhafte Anwendungsfälle:

  • Analytics-Anreicherung: Sende Browser- und OS-Details als benutzerdefinierte Dimensionen an Google Analytics, ohne auf Googles UA-Parsing angewiesen zu sein
  • Plattformspezifische Trigger: Löse bestimmte Tags nur für mobile Nutzer oder nur für Desktop-Nutzer aus
  • Bedingte Tag-Logik: Variiere das Tag-Verhalten basierend auf dem erkannten Browser oder Betriebssystem
  • Werbeplattform-Optimierung: Übergib Geräteinformationen an Conversion-APIs (Meta CAPI, TikTok Events API) für eine bessere Attribution

Funktionsweise

Die Verarbeitung erfolgt vollständig auf owntag-Servern – es werden keine externen Dienste angefragt und keine Daten an Dritte weitergegeben.

Wenn der User-Agent-Header fehlt oder nicht analysiert werden kann, werden alle Anreicherungs-Header auf leere Zeichenfolgen gesetzt. So können nachgelagerte Systeme immer davon ausgehen, dass die Header vorhanden sind.

Die Genauigkeit der User-Agent-Analyse hängt davon ab, ob der Browser einen aussagekräftigen User-Agent-String sendet. Moderne Browser (insbesondere Chromium-basierte) “frieren” zunehmend Teile des User-Agent-Strings aus Datenschutzgründen ein. Für die genaueste Erkennung könnten in Zukunft auch Client Hints berücksichtigt werden. owntag’s User Agent Info bietet eine solide Grundlage, die mit allen aktuellen Browsern funktioniert.

User Agent Info aktivieren

Du kannst User Agent Info in der owntag Console in den Einstellungen deines Containers aktivieren. Navigiere in der Seitenleiste zu User Agent Info und schalte das Feature ein.