Analityka (Organizator) 6: Zdarzenia niestandardowe (custom events)

Gridaly wysyła do Twoich narzędzi analitycznych gotowe zdarzenia: dodanie biletu do koszyka, zakup, logowanie, obejrzenie wideo, ukończenie kursu i inne. Nie musisz ich programować — wystarczy skonfigurować narzędzie i zbudować na zdarzeniach raporty, cele lub tagi. Ten artykuł to katalog wszystkich zdarzeń, z momentem wysłania, przekazywanymi danymi i listą usług, do których trafiają.

Z tego artykułu dowiesz się:

do jakich usług trafiają zdarzenia i od czego to zależy,
jakie zdarzenia wysyła strona wydarzenia i proces rejestracji,
jakie zdarzenia wysyła platforma wydarzenia online — w podziale na moduły,
jakie dane zawiera każde zdarzenie,
jak przekazać do narzędzi odpowiedzi z formularza.

Artykuł jest przeznaczony przede wszystkim dla osoby, która konfiguruje Google Tag Manager, GA4 lub Piwik PRO w Twoim zespole.

Dokąd trafiają zdarzenia

Każde zdarzenie jest rozsyłane jednocześnie do kilku usług. W tabelach używamy skrótów:

Skrót	Usługa	Warunek konfiguracji	Warunek zgody
DL	Warstwa danych (`dataLayer`) — widzą ją Twój kontener Google Tag Manager, Piwik PRO Tag Manager i kontener Gridaly	Zawsze	Brak — zdarzenie trafia do warstwy danych zawsze; to tagi w kontenerze decydują, czy mogą się uruchomić
GA4	Google Analytics 4 wpisane w polu Google Analytics (GA4)	Wypełnione pole GA4	Zgodnie z Google Consent Mode (bez zgody — tryb ograniczony)
Piwik	Piwik PRO — jako zdarzenie niestandardowe	Wypełnione pola Piwik PRO	W trybie domyślnym — zgoda Analityka; w pozostałych trybach bez warunku
Meta	Meta Pixel	Wypełnione pole Meta Pixel	Zgoda Reklamowe
Ads	Konwersja Google Ads	Wypełnione pola Google Ads i Google Ads - ID konwersji	Zgodnie z Google Consent Mode
LI	Konwersja LinkedIn	Wypełnione pola LinkedIn Insight Tag i LinkedIn - ID konwersji zakupu	Zgoda Reklamowe

Zasady zgód opisuje szczegółowo artykuł 7.

Jak zdarzenie wygląda w każdej usłudze

Warstwa danych i GA4 — zdarzenie ma nazwę z kolumny „Zdarzenie” i dane z kolumny „Dane”. W GTM zbudujesz na nim regułę typu Zdarzenie niestandardowe, a dane odczytasz zmiennymi warstwy danych (np. ecommerce.value).
Piwik PRO — zdarzenie niestandardowe z kategorią równą polu Piwik PRO - prefix zdarzeń (domyślnie gridaly), akcją i nazwą z kolumny „Piwik PRO” oraz opcjonalną wartością.
Meta, Google Ads, LinkedIn — zdarzenia standardowe tych platform, opisane w artykule 5.

Format pozycji koszyka

Zdarzenia e-commerce zawierają listę items. Każda pozycja to bilet lub dodatek:

Pole	Znaczenie
`item_id`	Identyfikator biletu lub dodatku
`item_name`	Nazwa biletu lub dodatku
`quantity`	Liczba sztuk
`price`	Cena jednostkowa
`currency`	Waluta, np. `PLN`

W warstwie danych zdarzenia e-commerce mają dane w obiekcie ecommerce — zgodnie ze standardem GA4. Przykład zdarzenia zakupu w warstwie danych:

event: purchase ecommerce: currency: PLN value: 1198 transaction_id: 7d3f…-… coupon: EARLYBIRD items: - item_id: 1a2b…, item_name: Bilet VIP, quantity: 2, price: 599, currency: PLN

Część A — strona wydarzenia i rejestracja

Rejestracja i zakup biletów

Zdarzenia z tej tabeli wysyła proces rejestracji — na stronie rejestracji wydarzenia, w bloku rejestracji osadzonym na landing page'u i na stronie zamówienia.

Zdarzenie	Kiedy się wyzwala	Dane	Piwik PRO (akcja / nazwa / wartość)	Usługi docelowe
`gridaly.registrationInit`	Wczytanie formularza rejestracji: nowa rejestracja, rozszerzenie zamówienia lub zmiana biletu	`type`: `new` / `extend` / `upgrade`; `registrationType`: `free` / `paid`	`registrationInit` / `registrationInit`	DL, GA4, Piwik
`add_to_cart`	Wybranie biletu lub dodatku, zwiększenie liczby sztuk, bilet wybrany z linku. Tylko nowa rejestracja	`ecommerce`: `currency`, `value` (cena dodanej pozycji), `items`	`addToCart` / nazwa pozycji / liczba sztuk	DL, GA4, Piwik, Meta (`AddToCart`)
`remove_from_cart`	Odznaczenie biletu lub dodatku, zmniejszenie liczby sztuk	`ecommerce`: `currency`, `value`, `items`	`removeFromCart` / nazwa pozycji / liczba sztuk	DL, GA4, Piwik
`gridaly.registrationStep`	Każde przejście do kolejnego kroku rejestracji. Tylko nowa rejestracja	`value`: nazwa kroku — `tickets` (bilety), `manage_addons` (dodatki), `manage_tickets` (przypisanie biletów), `user_data` (dane uczestnika), `payments` (płatność), `summary` (podsumowanie)	`registrationStep` / nazwa kroku	DL, GA4 (bez danych), Piwik, Meta (`InitiateCheckout` — raz na rejestrację, przy pierwszym kroku po wyborze biletów, z wartością koszyka)
`add_payment_info`	Zatwierdzenie wyboru metody płatności (przejście do podsumowania)	`ecommerce`: `currency`, `value` (wartość koszyka), `coupon`, `payment_type`, `items`	`addPaymentInfo` / `addPaymentInfo`	DL, GA4, Piwik
`purchase`	Przyjęcie płatnego zamówienia — przed przejściem do płatności; także przelew i zamówienie do akceptacji. Nie jest wysyłany ponownie po powrocie z bramki płatniczej ani przy płatnym rozszerzeniu lub zmianie biletu	`ecommerce`: `currency`, `transaction_id` (identyfikator płatności), `value` (wartość zamówienia), `coupon` (kod rabatowy), `items`	`purchase` / `purchase`	DL, GA4, Piwik, Meta (`Purchase`, a przy wartości 0 `CompleteRegistration`), Ads, LI
`gridaly.freeRegistrationCompleted`	Zakończenie darmowej rejestracji	—	`freeRegistrationCompleted` / `freeRegistrationCompleted`	DL, GA4, Piwik, Meta (`CompleteRegistration`), Ads (bez wartości), LI
`gridaly.orderPageView`	Otwarcie strony zamówienia, także po powrocie z bramki płatniczej	—	`orderPageView` / `orderPageView`	DL, GA4, Piwik

Wskazówka: jeśli chcesz liczyć w GTM tylko opłacone zakupy, nie masz do tego zdarzenia w przeglądarce — purchase wyzwala się przed płatnością. Opłacone zamówienia pokazuje lejek Gridaly (krok 4), a w czasie rzeczywistym możesz je przekazać do własnego systemu przez webhooki (artykuł 8).

Ważne: rejestracja uruchomiona ze strony organizacji wysyła powyższe zdarzenia wyłącznie do warstwy danych (DL). GA4, Piwik PRO i piksele wydarzenia nie są tam wczytywane.

Pozostałe zdarzenia na stronie wydarzenia

Zdarzenie	Kiedy się wyzwala	Gdzie	Dane	Piwik PRO (akcja / nazwa / wartość)	Usługi docelowe
`gridaly.formInit`	Wczytanie formularza	Strona formularza, formularz w bloku strony, formularz na podstronie informacyjnej	`eventProps`: `{ form: identyfikator formularza }`	kategoria zawsze `gridaly`; `formInit` / identyfikator formularza	DL, Piwik
`gridaly.formSubmitted`	Poprawne wysłanie formularza	jak wyżej	`eventProps`: identyfikator formularza + wartości pól oznaczonych Dodaj do dataLayer (Formularze)	kategoria zawsze `gridaly`; `formSubmitted` / identyfikator formularza	DL, Piwik
`gridaly.ticketDownloadPdf`	Pobranie biletu jako PDF	Strona biletu	`ticketName`: nazwa biletu	`ticketDownloadPdf` / nazwa biletu	DL, GA4, Piwik
`gridaly.ticketDownloadApple`	Dodanie biletu do Apple Wallet	Strona biletu	`ticketName`	`ticketDownloadApple` / nazwa biletu	DL, GA4, Piwik
`gridaly.ticketDownloadGoogle`	Dodanie biletu do Google Wallet	Strona biletu	`ticketName`	`ticketDownloadGoogle` / nazwa biletu	DL, GA4, Piwik
`gridaly.login`	Zalogowanie linkiem z maila (magic link) otwartym na stronie wydarzenia	Strona wydarzenia	`method`: `token`	`login` / `token`	DL, GA4, Piwik
`gridaly.cookieConsentUpdated`	Każda decyzja odwiedzającego w bannerze zgód Gridaly (także przełączenie pojedynczej kategorii)	Wszędzie, gdzie wyświetla się banner Gridaly	— (aktualny stan zgód jest w poprzedzającej aktualizacji Consent Mode)	—	DL

Część B — platforma wydarzenia online

Zdarzenia z tej części wysyła platforma wydarzenia dla uczestników (część dostępna po zalogowaniu). Trafiają do tych samych usług co zdarzenia strony wydarzenia — o ile identyfikatory są wpisane w ustawieniach wydarzenia.

Moduł	Zdarzenie	Kiedy się wyzwala	Dane	Piwik PRO (akcja / nazwa / wartość)	Usługi docelowe
Logowanie	`gridaly.login`	Faktyczne zalogowanie — hasłem, kodem z maila, linkiem z maila lub przez SSO	`method`: `password` / `code` / `token` / `sso`; `provider`: dostawca SSO (tylko przy SSO)	`login` / metoda	DL, GA4, Piwik
Sesje (agenda)	`gridaly.videoView`	Obejrzenie 25%, 50%, 75%, 90% i 100% transmisji lub nagrania sesji — każdy próg raz	`videoId`, `value` (próg w %), `materialType`: `session`, `materialId`, `tags`	kategoria zawsze `gridaly`; `videoView` / ID wideo / próg	DL, GA4, Piwik
Biblioteka nagrań	`gridaly.videoView`	Jak wyżej, dla nagrania z biblioteki wideo	jak wyżej, `materialType`: `recording`	jak wyżej	DL, GA4, Piwik
Kursy (e-learning)	`gridaly.videoView`	Jak wyżej, dla wideo lekcji	jak wyżej, `materialType`: `courseLesson`, `courseId`	jak wyżej	DL, GA4, Piwik
Kursy (e-learning)	`gridaly.courseCompleted`	Ukończenie kursu przez uczestnika	`courseId`, `courseName` (GA4: tylko `courseId`)	`courseCompleted` / ID kursu	DL, GA4, Piwik
Miniodtwarzacz	`gridaly.videoView`	Jak wyżej, dla wideo oglądanego w pływającym miniodtwarzaczu	`videoId`, `value` (bez typu materiału)	jak wyżej	DL, GA4, Piwik
Profil uczestnika	`gridaly.profileSaved`	Zapisanie profilu — w edycji profilu, przy pierwszym uzupełnianiu profilu do networkingu, w ustawieniach profilu w grywalizacji, w polach dodatkowych	—	`profileSaved` / `profileSaved`	DL, GA4, Piwik
Formularze	`gridaly.formInit`, `gridaly.formSubmitted`	Wczytanie i wysłanie formularza — na stronie formularza, w panelu bocznym, w formularzu wystawcy, w formularzu produktu	jak w części A	jak w części A	DL, Piwik
Banner zgód	`gridaly.cookieConsentUpdated`	Zmiana decyzji w bannerze (także z preferencji profilu)	—	—	DL

Przy obejrzeniu wideo liczy się łączny obejrzany czas: przewinięcie od razu do końca nie zalicza wszystkich progów, a wznowienie wcześniej obejrzanego wideo nie wysyła progów ponownie.

Odsłony wysyłane automatycznie

Oprócz zdarzeń z tabel każde narzędzie otrzymuje odsłony przy wejściu na stronę i przy każdej zmianie podstrony — na stronie wydarzenia, w rejestracji i na platformie online:

Usługa	Jak rejestrowana jest odsłona
GA4	`page_view` z adresem podstrony
Piwik PRO	Pierwsza odsłona przez kontener Piwik PRO, kolejne przez Gridaly
Meta Pixel	`PageView`
Google Ads	Odsłona remarketingowa raz przy wczytaniu strony
LinkedIn Insight Tag	Liczone przez sam tag
Twój kontener GTM	Standardowe reguły GTM (np. „Zmiana historii” dla zmian podstron)

Formularze

Do zdarzenia gridaly.formSubmitted możesz dołączyć odpowiedzi z wybranych pól formularza — np. branżę, wielkość firmy albo wybraną ścieżkę tematyczną. Pozwala to budować w GTM lub Piwik PRO segmenty i cele na podstawie odpowiedzi.

Przejdź do Lista wydarzeń → [Twoje wydarzenie] → Formularze → [formularz].
Otwórz edycję wybranego pola i przejdź do zakładki Zaawansowane.
Włącz przełącznik Dodaj do dataLayer i zapisz pole.

Po wysłaniu formularza zdarzenie zawiera w eventProps identyfikator formularza (form) oraz wartości zaznaczonych pól, zapisane pod nazwami tych pól.

Ważne: nie zaznaczaj pól z danymi osobowymi (imię, e-mail, telefon). Wartości trafiają do warstwy danych, którą widzą wszystkie tagi w Twoim kontenerze — także tagi reklamowe. Przekazanie danych osobowych do narzędzi zewnętrznych wymaga podstawy prawnej i zwykle narusza regulaminy platform reklamowych.

Zdarzenia wbudowanej analityki Gridaly

Wbudowana analityka strony (artykuł 1) zbiera własne zdarzenia: odsłony, czas zaangażowania, głębokość przewijania, wyświetlenia sekcji, kliknięcia w przyciski rejestracji i linki wychodzące oraz wejście w rejestrację. Nie trafiają one do warstwy danych ani do narzędzi zewnętrznych — są wysyłane wyłącznie do Gridaly i widoczne tylko w dashboardzie Statystyki strony wydarzenia. Podobnie dane o obecności uczestników na platformie online zasilają wyłącznie stronę Statystyka (artykuł 8).

Jeśli potrzebujesz podobnych danych w GA4 lub Piwik PRO (np. głębokości przewijania), skonfiguruj je w swoim narzędziu — np. regułą „Głębokość przewijania” w GTM.

FAQ — najczęściej zadawane pytania

Czy muszę coś włączyć, żeby zdarzenia trafiały do GTM?

Nie. Wystarczy wpisać identyfikator kontenera — zdarzenia pojawiają się w warstwie danych automatycznie. W kontenerze musisz tylko zbudować reguły i tagi.

Dlaczego zdarzenia formularzy nie docierają do GA4?

Zdarzenia formularzy są wysyłane tylko do warstwy danych i do Piwik PRO. Aby mieć je w GA4, zbuduj w GTM tag zdarzenia GA4 z regułą gridaly.formSubmitted.

Czy mogę dodać własne zdarzenie, którego nie ma na liście?

Gridaly nie pozwala definiować nowych zdarzeń w panelu. Możesz budować własne reguły wGTM na podstawie kliknięć, widoczności elementów czy zmian adresu.

Zdarzenie jest w warstwie danych, ale nie dociera do Meta. Dlaczego?

Meta otrzymuje tylko zdarzenia wymienione w kolumnie „Usługi docelowe” i tylko przy zgodzie Reklamowe. Sprawdź to w trybie diagnostyki (?gridalyAnalyticsDebug=1, artykuł 4).

Czy katalog obejmuje aplikację mobilną?

Nie. Katalog opisuje stronę wydarzenia, rejestrację i platformę online w przeglądarce.

Artykuły powiązane