Cookies und Nutzeridentifikation mit gtag.js

Bei gtag.js werden Cookies verwendet, um einzelne Nutzer über verschiedene Browsersitzungen hinweg zu identifizieren. Auf dieser Seite wird erläutert, wie die Cookie-Einstellungen angepasst werden.

In der folgenden Tabelle sehen Sie die Standardwerte für Cookie-Felder, die von gtag.js verwendet werden:

Feldname Werttyp Standardwert
cookie_domain string auto
cookie_expires integer 63072000 (zwei Jahre in Sekunden)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

Wenn Sie einen dieser Werte ändern möchten, aktualisieren Sie den config für Ihr Attribut, um ihn in der Parameterliste anzugeben. Beispiel:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

Bei gtag.js ist die automatische Konfiguration der Cookie-Domain standardmäßig aktiviert. Wenn diese Option aktiviert ist, werden Cookies von gtag.js auf der Domain der höchsten Ebene gesetzt, die möglich ist. Wenn Ihre Websiteadresse beispielsweise blog.example.com lautet, setzt gtag.js Cookies in der Domain example.com. Wenn gtag.js erkennt, dass Sie einen Server lokal ausführen (z. B. localhost), wird cookie_domain automatisch auf 'none' gesetzt. Dadurch werden von gtag.js Cookies mit der vollständigen Domain des Dokumentspeicherorts gesetzt.

Wenn Sie die automatische Konfiguration der Cookie-Domain deaktivieren möchten, geben Sie für das Attribut config einen Wert für den Parameter cookie_domain an:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

Um Konflikte mit anderen Cookies zu vermeiden, müssen Sie möglicherweise das Cookie-Präfix ändern, das Cookies vorangestellt wird, die von gtag.js gesetzt werden. Der Standardname des von Google Analytics verwendeten ID-Cookies ist beispielsweise _ga. Dieser Code führt dazu, dass das Cookie stattdessen den Namen example_ga erhält:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

Bei jedem Seitenaufbau wird die Ablaufzeit des Cookies auf die aktuelle Zeit plus den Wert des Felds cookie_expires aktualisiert. Wenn also cookie_expires auf eine Woche festgelegt ist und ein Nutzer die Website innerhalb von fünf Tagen mit demselben Browser besucht, bleibt das Cookie eine weitere Woche lang verfügbar und wird in Google Analytics als derselbe Besucher angezeigt. Besucht derselbe Nutzer stattdessen die Website, nachdem das ursprüngliche Cookie abgelaufen ist, wird ein neues Cookie erstellt, und der erste und zweite Besuch wird in Google Analytics so angezeigt, als kämen sie von einzelnen Besuchern.

Wenn Sie den Wert cookie_expires auf 0 (null) Sekunden setzen, wird das Cookie in ein sitzungsbasiertes Cookie umgewandelt und läuft ab, sobald die aktuelle Browsersitzung endet.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

Wenn cookie_update auf true (Standardwert) gesetzt ist, werden die Cookies über gtag.js bei jedem Seitenaufbau aktualisiert. Dadurch wird die Gültigkeitsdauer von Cookies relativ zum letzten Besuch auf der Website festgelegt. Wenn die Gültigkeitsdauer von Cookies beispielsweise auf eine Woche festgelegt ist und ein Nutzer die Website alle fünf Tage über denselben Browser besucht, wird die Gültigkeitsdauer von Cookies bei jedem Besuch aktualisiert und läuft somit nie ab.

Ist sie auf false gesetzt, werden Cookies nicht bei jedem Seitenaufbau aktualisiert. Die Gültigkeit von Cookies richtet sich in diesem Fall danach, wann ein Nutzer die Website zum ersten Mal besucht hat.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

Wenn dieser Parameter festgelegt ist, werden zusätzliche Flags an das Cookie angehängt. Flags müssen durch Semikolons getrennt werden.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

User-ID festlegen

Eine User-ID ist ein eindeutiger, dauerhafter und nicht personenidentifizierbarer ID-String, der einen Nutzer repräsentiert. Es ermöglicht die Analyse von Sitzungsgruppen geräteübergreifend. Unter Vorteile der User-ID-Funktion erfahren Sie, warum Sie die User-ID implementieren sollten.

Wenn Sie die User-ID mit gtag.js implementieren möchten, müssen Sie config für Ihre Property aktualisieren, um die User-ID festzulegen:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

Sie können gtag.js so konfigurieren, dass Cookies erst gelesen oder geschrieben werden, wenn der Nutzer seine Einwilligung erteilt hat. Weitere Informationen