dl= Parameter – Google Analytics 4 Request
dl= Parameter in GA4
Der dl-Parameter ist einer der zentralsten Bestandteile eines jeden Tracking-Requests in Google Analytics 4 (GA4), wenn dieser über den Browser versendet wird. Er steht für die sogenannte Document Location – also die vollständige URL der Seite, auf der das Event ausgelöst wurde.
Bedeutung des dl= Parameters in GA4
dl ist die Abkürzung für Document Location. Der Parameter übermittelt die komplette URL (inkl. Protokoll, Domain, Pfad, Query-Parameter und Fragment), auf der sich der Nutzer zum Zeitpunkt des Events befindet.
Beispiel:
/g/collect?v=2&tid=A1B2C3D4E5&dl=https%3A%2F%2Fthebigc-agency.de%2F
Der dl Parameter würde in der lesbaren Form so aussehen:
https://thebigc-agency.de/
Der Parameter übermittelt per default auch Parameter und Folder:
/g/collect?v=2&tid=A1B2C3D4E5&dl=https%3A%2F%2Fthebigc-agency.de%2Fleistungen%2F%3Flang%3Dde
für die URL:
https://thebigc-agency.de/leistungen/?lang=de
Welche Funktion hat der dl= Parameter?
Der dl-Parameter liefert Google Analytics die tatsächliche URL, die der Nutzer im Browser aufgerufen hat. Diese Information ist für eine Vielzahl von Berichten und Funktionen essenziell – sie ermöglicht die Zuordnung von Seitenaufrufen, Events, Trafficquellen und Navigationspfaden.
Aufgaben des dl-Parameters:
- Dient zur Identifikation der Seite, auf der ein Event ausgelöst wurde.
- Wird in den Berichten zu Seitenpfaden und Einstiegsseiten verwendet.
- Ist Grundlage für Pfadanalyse und Traffic-Zuordnung.
- Unterstützt die korrekte URL-Auflösung bei Canonicals, Redirects oder internen Referrern.
Typische Ausprägungen des dl= Parameters
Der dl-Parameter enthält die vollständige URL im URL-encoded Format. Er wird typischerweise vom Browser automatisch gesetzt, entweder über document.location.href oder durch den Google Tag Manager.
Typische Beispiele:
dl=https%3A%2F%2Fthebigc-agency.de%2F
dl=https%3A%2F%2Fthebigc-agency.de%2Fleistungen%2F%3Flang%3Dde
dl=https%3A%2F%2Fthebigc-agency.de%2F%23about
Decoded Versions:
https://thebigc-agency.de/
Leistungen
https://thebigc-agency.de/#about
Typische Fehler bei der Verwendung des dl Parameters
Fehlender dl-Parameter:
Wenn der Parameter fehlt, kann GA4 die Seite, auf der das Event ausgelöst wurde, nicht korrekt zuordnen. Besonders bei page_view-Events führt das dazu, dass diese nicht oder falsch in Berichten erscheinen.
Statische oder harte Kodierung falscher URLs:
Wenn der dl-Wert hart im Tag hinterlegt wird (z. B. als Platzhalter https://yourdomain.com), tauchen viele Seitenaufrufe in GA4 unter einem einzigen, generischen Pfad auf – was die Analyse unbrauchbar macht.
Falsches Encoding oder manipulierter Wert:
Ein fehlerhaft codierter dl-Wert (z. B. doppelt encodiert oder mit fehlerhaftem Protokoll) kann dazu führen, dass die URL in den Berichten nicht lesbar oder vollständig falsch dargestellt wird.
Fehlende Aktualisierung bei SPAs:
Bei Single Page Applications (SPA), bei denen die URL per JavaScript wechselt, aber kein vollständiger Seitenreload erfolgt, muss sichergestellt werden, dass der aktuelle dl-Wert manuell aktualisiert und beim Event korrekt mitgesendet wird. Sonst werden alle Events der falschen URL zugeordnet.
Interessante Fakten zum dl Parameter
- Der dl-Parameter war bereits in Universal Analytics (collect?v=1) und sogar in der Urchin-Zeit (vor GA) ein fester Bestandteil der Webtracking-Struktur. In Universal Analytics hatte er dieselbe Funktion – dort wurde er jedoch zusammen mit dp (Page Path) und dh (Host) verarbeitet, um verschiedene Teile der URL getrennt auswertbar zu machen.
- Mit GA4 wurde dieser Parameter vereinfacht, indem alle Informationen gebündelt in dl geliefert werden. Es gibt keine separate Aufschlüsselung mehr – die Zerlegung erfolgt bei Bedarf auf der Reporting-Ebene.
- Die Vereinfachung macht den dl-Parameter umso kritischer, da er die einzig vollständige Quelle für URL-basierte Analysen im Protokoll ist.