Konfiguracja

Ten dokument zawiera wszystkie pola konfiguracji GA4.

allow_google_signals

Aby wyłączyć wszystkie funkcje reklamowe, ustaw allow_google_signals na false.

Nazwa pola Typ Wartość domyślna
allow_google_signals boolean prawda

Przykład

Ustaw globalnie

gtag('set', 'allow_google_signals', true);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

Aby wyłączyć funkcje personalizacji reklam, ustaw false.

Nazwa pola Typ Wartość domyślna
allow_ad_personalization_signals boolean prawda

Przykład

Ustaw globalnie

gtag('set', 'allow_ad_personalization_signals', true);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

Służy do testowania wersji A/B oraz reklam kierowanych na sieć reklamową. Za pomocą atrybutu campaign_content możesz rozróżniać reklamy i linki prowadzące pod ten sam adres URL.

Nazwa pola Typ Wartość domyślna
campaign_content string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_content', 'logolink');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

Służy do wskazania kampanii, do której odwołuje się to odesłanie. Użyj znaku campaign_id, aby wskazać konkretną kampanię.

Nazwa pola Typ Wartość domyślna
campaign_id string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_id', 'abc.123');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

Użyj pola campaign_medium, aby określić medium, takie jak e-mail lub koszt kliknięcia.

Nazwa pola Typ Wartość domyślna
campaign_medium string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_medium', 'cpc');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

Służy do analizy słów kluczowych. Użyj właściwości campaign_name, aby określić konkretną promocję produktu lub kampanię strategiczną.

Nazwa pola Typ Wartość domyślna
campaign_name string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_name', 'spring_sale');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

Użyj pola campaign_source, aby określić wyszukiwarkę, nazwę newslettera lub inne źródło.

Nazwa pola Typ Wartość domyślna
campaign_source string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_source', 'google');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

Używany w przypadku płatnego wyszukiwania. Użyj campaign_term, by zapisać słowa kluczowe dla tej reklamy.

Nazwa pola Typ Wartość domyślna
campaign_term string undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign_term', 'running+shoes');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

kampania

Obiekt zawierający wszystkie wartości kampanii, które można ustawić.

Obiekt campaign jest używany do obsługi starszych implementacji i w większości przypadków nie jest zalecany. Zamiast tego użyj wersji każdego pola z prefiksem campaign:

Nazwa pola Typ Wartość domyślna
campaign object undefined

Przykład

Ustaw globalnie

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

Wskazuje instancję przeglądarki z zastosowaniem pseudonimizacji. Domyślnie ta wartość jest przechowywana przez 2 lata jako część własnego pliku cookie Analytics.

Nazwa pola Typ Wartość domyślna
client_id string Wartość wygenerowana losowo dla każdego użytkownika.

Przykład

Ustaw globalnie

gtag('set', 'client_id', 'aaa.bbb');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

Nazwa pola Typ Wartość domyślna
content_group string

Przykład

Ustaw globalnie

gtag('set', 'content_group', '/news/sports');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

Wskazuje domenę służącą do przechowywania pliku cookie Analytics.

Aby skonfigurować plik cookie bez określania domeny, ustaw wartość 'none'.

Aby skonfigurować plik cookie na domenę najwyższego poziomu i jedną subdomenę (eTLD + 1), ustaw 'auto' (wartość domyślną). Jeśli na przykład cookie_domain ma wartość 'auto', https://example.com używa w domenie example.com, a https://subdomain.example.com używa w domenie example.com.

Nazwa pola Typ Wartość domyślna
cookie_domain string 'auto'

Ustaw globalnie

gtag('set', 'cookie_domain', 'example.com');

Ustaw na 1 transmisję

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

Za każdym razem, gdy do Google Analytics wysyłane jest działanie, data ważności pliku cookie jest aktualizowana na aktualną godzinę plus wartość z pola cookie_expires. Oznacza to, że jeśli użyjesz wartości domyślnej wynoszącej 2 lata (63072 000 sekund), a użytkownik odwiedza Twoją witrynę co miesiąc, jego plik cookie nigdy nie wygaśnie.

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

Nazwa pola Typ Wartość domyślna
cookie_expires number 63072000

Ustaw globalnie

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

Dzięki zdefiniowaniu tego parametru możesz dołączać do pliku cookie dodatkowe flagi. Flagi muszą być rozdzielone średnikami. Przykładowe flagi znajdziesz w sekcji Write a new cookie (Zapisywanie nowego pliku cookie) artykułu w języku angielskim.

Nazwa pola Typ Wartość domyślna
cookie_flags string

Ustaw globalnie

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

Ustaw na 1 transmisję

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

Wskazuje ścieżkę podrzędną służącą do przechowywania pliku cookie Analytics.

Nazwa pola Typ Wartość domyślna
cookie_path string '/'

Ustaw globalnie

gtag('set', 'cookie_path', '/example_path');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

Określa prefiks, który będzie dodawany do nazw plików cookie Analytics.

Nazwa pola Typ Wartość domyślna
cookie_prefix string

Ustaw globalnie

gtag('set', 'cookie_prefix', 'prefix');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

Gdy cookie_update ma wartość true, gtag.js aktualizuje pliki cookie przy każdym wczytaniu strony. Powoduje to ustawianie okresu ważności plików cookie względem najnowszej 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.

Nazwa pola Typ Wartość domyślna
cookie_update boolean true

Ustaw globalnie

gtag('set', 'cookie_update', true);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

ignore_referrer

Ustaw wartość true, aby wskazać Analytics, że strona odsyłająca nie powinna być wyświetlana jako źródło wizyt. Dowiedz się, kiedy używać tego pola

Nazwa pola Typ Wartość domyślna
ignore_referrer boolean false

Przykład

Ustaw globalnie

gtag('set', 'ignore_referrer', true);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

language,

Wskazuje ustawienie języka użytkownika. Przyjmuje się domyślnie wartość navigator.language użytkownika.

Nazwa pola Typ Wartość domyślna
language string Wartością domyślną jest navigator.language

Przykład

Ustaw globalnie

gtag('set', 'language', 'en-us');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

Podaje pełny adres URL strony. Przyjmuje się domyślnie wartość document.location użytkownika.

Nazwa pola Typ Wartość domyślna Character Limit
page_location string Wartością domyślną jest document.location. 1000

Przykład

Ustaw globalnie

gtag('set', 'page_location', 'https://example.com/page1');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

Wskazuje źródło odesłania, z którego pochodzi ruch na stronie. Ta wartość służy też do ustalania źródła wizyty. Format tej wartości to adres URL. Domyślnie jest to wartość document.referrer użytkownika.

Nazwa pola Typ Wartość domyślna Character Limit
page_referrer string Wartością domyślną jest document.referrer 420

Przykład

Ustaw globalnie

gtag('set', 'page_referrer', 'https://example.com');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

Tytuł strony lub dokumentu. Domyślnie jest to wartość document.title użytkownika.

Nazwa pola Typ Wartość domyślna Character Limit
page_title string Wartością domyślną jest document.title 300

Przykład

Ustaw globalnie

gtag('set', 'page_title', 'Settings');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

Aby zapobiec wysyłaniu parametru page_view przez domyślny fragment kodu, ustaw wartość false (fałsz).

Nazwa pola Typ Wartość domyślna
send_page_view boolean prawda

Przykład

Ustaw globalnie

gtag('set', 'send_page_view', false);

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

Podaje rozdzielczość ekranu. Musi się składać z 2 dodatnich liczb całkowitych rozdzielonych znakiem x. Na przykład w przypadku ekranu o wymiarach 800 x 600 pikseli wartość ta będzie miała postać 800x600. Obliczane na podstawie wartości window.screen użytkownika.

Nazwa pola Typ Wartość domyślna
screen_resolution string Wartość domyślna będzie obliczana od window.screen

Przykład

Ustaw globalnie

gtag('set', 'screen_resolution', '800x600');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

Określa znany identyfikator użytkownika podany przez właściciela witryny lub użytkownika biblioteki. Nie może zawierać informacji umożliwiających identyfikację osób. Wartość ta nie powinna być przechowywana w plikach cookie Google Analytics ani w innych usługach służących do przechowywania danych przez Analytics.

Nazwa pola Typ Wartość domyślna Character Limit
user_id string 256

Przykład

Ustaw globalnie

gtag('set', 'user_id', 'id');

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

Właściwości użytkownika to atrybuty służące do opisania segmentów użytkowników, np. ich ustawień języka lub położenia geograficznego. W projekcie możesz ustawić do 25 dodatkowych właściwości użytkownika.

Nazwa pola Typ Wartość domyślna Character Limit
user_properties object właściwość name=24
property value=36

Przykład

Ustaw globalnie

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

Ustaw na 1 transmisję

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});