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. Na tej stronie dowiesz się, jak dostosować ustawienia plików cookie.

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

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

Aby zmienić dowolną z tych wartości, zaktualizuj config swojej usługi, aby wskazać ją na liście parametrów. Na 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. Gdy ta opcja jest włączona, tag gtag.js ustawia pliki cookie w domenie najwyższego poziomu, na jaką pozwala. Jeśli np. adres witryny to blog.example.com, tag gtag.js utworzy pliki cookie w domenie example.com. Jeśli tag gtag.js wykryje, że serwer działa lokalnie (np.localhost), automatycznie ustawi w tagu cookie_domain wartość 'none'. Spowoduje to, że gtag.js będzie tworzyć pliki cookie z wykorzystaniem pełnej domeny z lokalizacji dokumentu.

Aby wyłączyć automatyczną konfigurację domeny plików cookie, zaktualizuj config swojej usługi, podając wartość parametru cookie_domain:

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

Aby uniknąć konfliktów z innymi plikami cookie, może być konieczna zmiana prefiksu pliku cookie, który zostanie dodany do plików cookie ustawianych przez gtag.js. Na przykład domyślna nazwa pliku cookie z identyfikatorem używanego przez Google Analytics to _ga. Ten kod sprawi, że plik cookie nosi nazwę example_ga:

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

Przy każdym wczytaniu strony okres ważności plików cookie jest aktualizowany na czas bieżący i wynosi wartość pola cookie_expires. Oznacza to, że jeśli parametr cookie_expires jest ustawiony 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 ten sam użytkownik. Jeśli ten sam użytkownik odwiedzi stronę po wygaśnięciu oryginalnego pliku cookie, zostanie utworzony nowy plik cookie, a jego pierwsza i druga wizyta będą wyświetlane w Google Analytics jako pochodzące od różnych użytkowników.

Jeśli ustawisz wartość cookie_expires na 0 (zero) s, plik cookie zmieni się w plik cookie powiązany z sesją i straci ważność po zakończeniu bieżącej sesji przeglądarki.

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

Jeśli dla parametru cookie_update ustawiona jest wartość true (wartość domyślna), tag gtag.js będzie aktualizować pliki cookie przy każdym wczytaniu strony. Powoduje to ustawianie okresu ważności plików cookie odpowiednio do ostatniej wizyty w witrynie. Jeśli np. okres ważności pliku cookie jest ustawiony na tydzień, a użytkownik odwiedza witrynę w tej samej przeglądarce co 5 dni, pliki cookie będą aktualizowane po każdej wizycie i w konsekwencji nigdy nie stracą ważności.

Jeśli ma wartość false, pliki cookie nie są aktualizowane po każdym wczytaniu strony. Okres ważności pliku cookie będzie więc zależał od terminu pierwszej wizyty użytkownika w witrynie.

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

Dzięki zdefiniowaniu tego parametru możesz dołączać 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 identyfikację osoby ciąg identyfikatora, który reprezentuje użytkownika. Umożliwia analizę grup sesji na różnych urządzeniach. Aby dowiedzieć się, dlaczego warto zaimplementować funkcję User ID, przeczytaj artykuł o zaletach korzystania z funkcji User-ID.

Aby zaimplementować funkcję User-ID za pomocą tagu gtag.js, zaktualizuj parametr config swojej usługi, aby ustawić identyfikator użytkownika:

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 do czasu udzielenia zgody przez użytkownika. Więcej informacji znajdziesz w artykule Dostosowywanie działania tagów na podstawie zgody użytkownika.