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.