Pliki cookie i identyfikacja użytkowników za pomocą tagu gtag.js

Tag gtag.js używa plików cookie do identyfikowania unikalnych użytkowników podczas różnych sesji przeglądania. Z tego artykułu dowiesz się, jak dostosować ustawienia plików cookie.

W tabeli poniżej podano domyślne wartości pól plików cookie używanych przez tag gtag.js:

Nazwa pola Typ wartości Wartość domyślna
cookie_domain string auto
cookie_expires integer 63072000 (2 lata w sekundach)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

Aby zmienić te wartości, zaktualizuj config w swojej usłudze, aby określić je na liście parametrów. Przykład:

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

Domyślnie tag gtag.js ma włączoną automatyczną konfigurację domeny plików cookie. Po włączeniu tej opcji plik gtag.js będzie zapisywać pliki cookie w domenie najwyższego poziomu. Jeśli na przykład adres witryny to blog.example.com, tag gtag.js utworzy pliki cookie w domenie example.com. Jeśli tag gtag.js wykryje, że uruchomisz serwer lokalnie (np. localhost), automatycznie ustawi cookie_domain na 'none', co spowoduje, że tag gtag.js utworzy pliki cookie z pełną domeną z lokalizacji dokumentu.

Aby wyłączyć automatyczną konfigurację domeny plików cookie, zaktualizuj config w swojej usłudze, aby określić wartość parametru cookie_domain:

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

Aby uniknąć konfliktów z innymi plikami cookie, możesz zmienić prefiks pliku cookie, który będzie dodawany do plików cookie ustawionych przez tag gtag.js. np. domyślna nazwa pliku cookie identyfikatora używanego przez Google Analytics to _ga. Ten kod spowoduje nadanie pliku cookie nazwy example_ga:

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

Przy każdym wczytaniu strony okres ważności plików cookie jest aktualizowany do wartości będącej aktualną godziną powiększoną o wartość pola cookie_expires. Oznacza to, że jeśli data cookie_expires jest ustawiona na tydzień, a użytkownik odwiedzi witrynę w tej samej przeglądarce w ciągu 5 dni, plik cookie będzie dostępny przez dodatkowy tydzień i będzie widoczny w Google Analytics jako ta sama osoba. Jeśli ten sam użytkownik odwiedzi witrynę po wygaśnięciu oryginalnego pliku cookie, zostanie utworzony nowy plik cookie, a jego pierwsze i drugie wizyty będą wyświetlane przez różnych użytkowników w Google Analytics.

Jeśli ustawisz wartość cookie_expires na 0 (zero), sekundy plik cookie stanie się plikiem cookie opartym na sesji i wygaśnie po zakończeniu bieżącej sesji przeglądarki.

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

Jeśli zasada cookie_update ma wartość true (wartość domyślna), tag gtag.js będzie aktualizować pliki cookie przy każdym wczytaniu strony. Spowoduje to zmianę daty ważności pliku cookie względem ostatniej wizyty w witrynie. Jeśli na przykład okres ważności pliku cookie jest ustawiony na tydzień, a użytkownik odwiedzi witrynę w tej samej przeglądarce co 5 dni, okres ten będzie aktualizowany podczas każdej wizyty i tak naprawdę nigdy nie wygaśnie.

Jeśli ma wartość false, pliki cookie nie są aktualizowane podczas każdego wczytywania strony. Efektem jest wygaśnięcie pliku cookie względem pierwszej wizyty użytkownika na stronie.

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

Dodaje do pliku cookie dodatkowe flagi. Flagi muszą być rozdzielone średnikami.

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

Ustaw identyfikator użytkownika

User-ID to unikalny, trwały i nieumożliwiający identyfikacji osoby ciąg znaków, który reprezentuje użytkownika. Umożliwiają analizę grup sesji na różnych urządzeniach. Aby dowiedzieć się, dlaczego warto zaimplementować funkcję User-ID, przeczytaj artykuł Zalety korzystania z funkcji User-ID.

Aby zaimplementować funkcję User-ID za pomocą tagu gtag.js, zaktualizuj właściwość config w swojej usłudze, by ustawić identyfikator User-ID:

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

Możesz skonfigurować tag gtag.js tak, aby nie odczytywał ani nie zapisywał plików cookie, dopóki użytkownik nie wyrazi zgody. Więcej informacji znajdziesz w artykule Dostosowywanie działania tagów na podstawie zgody użytkownika.