Konfiguracja

Ten dokument zawiera listę wszystkich pól 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ą. campaign_content służy do rozróżniania reklam lub linków kierujących do tego samego adresu 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. Aby wskazać konkretną kampanię, użyj campaign_id.

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 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. Atrybut campaign_name służy do wskazywania określonej promocji produktu lub kampanii strategicznej.

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 narzędzia campaign_term, by zapisać słowa kluczowe 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żywaj 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 jako część własnego pliku cookie Analytics z 2-letnim okresem ważności.

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 'none'.

Ustaw wartość 'auto' (wartość domyślną), aby ustawić plik cookie z domeną najwyższego poziomu i jedną subdomeną (eTLD + 1). Jeśli na przykład cookie_domain ma wartość 'auto', https://example.com użyje w domenie example.com, a https://subdomain.example.com na potrzeby domeny 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, okres ważności pliku cookie jest aktualizowany do aktualnej godziny powiększonej o 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, tag gtag.js będzie aktualizować 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, plik cookie będzie aktualizowany po każdej wizycie i w konsekwencji nigdy nie wygaśnie.

Jeśli zasada 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 wizyty. 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. Wartość domyślna to 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. Wartość domyślna to 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. Wartość ta służy też do obliczania źródła wizyty. Wartość ta ma format adresu URL. Wartość domyślna 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. Wartość domyślna 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

Ustaw wartość false (fałsz), aby uniemożliwić domyślny fragment kodu wysyłanie parametru page_view.

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ść będzie wynosić 800x600. Obliczane na podstawie wartości window.screen użytkownika.

Nazwa pola Typ Wartość domyślna
screen_resolution string Wartość domyślna zostanie obliczona 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. Ta wartość nie powinna być zachowywana w plikach cookie Google Analytics ani w innych usługach przechowywanych 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 każdym projekcie można 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'
  }
});