Czy integrujesz się z Google Analytics 4?

Tak. Checkout Widget wysyła zdarzenia związane z rezerwacjami do Google Analytics 4 (GA4) na poszczególnych etapach procesu rezerwacji. Te instrukcje dotyczą aktualnej wersji Checkout Widget. Jeśli korzystasz ze starszej wersji, zobacz Starsze widżety.

Konfiguracja śledzenia

W ustawieniach widgetu rezerwacji otwórz sekcję Analytics i włącz opcję Enable Google Analytics. W sekcji Send events via wybierz sposób, w jaki widget wysyła zdarzenia rezerwacji. Widget korzysta jednocześnie tylko z jednej metody:

• Google Analytics 4 — wybierz Use existing tag, jeśli Twoja witryna już ładuje tag Google Analytics, albo Use custom tag i wprowadź identyfikator pomiaru GA4 (G-…). Widget automatycznie wysyła zdarzenia za pośrednictwem tego tagu.
• Google Tag Manager — włącz opcję Enable Google Tag Manager, a następnie użyj istniejącego kontenera swojej witryny lub wprowadź niestandardowy identyfikator kontenera (GTM-…). Widget przekazuje zdarzenia do Data Layer. Zdarzenia rezerwacji trafią do GA4 po skonfigurowaniu i opublikowaniu w kontenerze tagów zdarzeń GA4 z pasującymi regułami Custom Event oraz danymi e-commerce z Data Layer. Zobacz przewodnik konfiguracji Tag Managera.

Zapisz ustawienia, aby włączyć śledzenie. Nie przekazuj tych samych zdarzeń rezerwacji za pomocą Tag Managera ani własnego kodu, gdy widget wysyła je również przez Google Analytics 4, ponieważ zakupy i przychody mogą zostać policzone dwukrotnie.

Zdarzenia wysyłane automatycznie

Zdarzenie	Kiedy Checkout Widget je wysyła
page_view	Wyświetlany jest etap widgetu, w tym ekran wyboru, realizacji rezerwacji, potwierdzenia lub błędu
select_item	Z listy produktów lub wydarzeń wybrano produkt, pakiet albo voucher produktowy
add_to_cart	Rezerwacja lub pakiet zostaje dodany do koszyka
view_cart	Wyświetlany jest koszyk
begin_checkout	Wyświetlany jest etap danych klienta
add_payment_info	Wyświetlany jest etap płatności — przed przesłaniem danych płatności
purchase	Płatność zakończyła się powodzeniem lub potwierdzono zamówienie, za które nie pozostała żadna kwota do zapłaty

Poszczególne etapy zależą od przebiegu rezerwacji. Na przykład bezpłatna rezerwacja może pominąć ekran płatności.

Zawartość zdarzeń

• Wyświetlenia stron: page_title i page_path identyfikują etap widgetu, na przykład tier_selection, extras_selection, basket lub payment. page_location to adres URL strony Twojej witryny zawierającej widget.
• Wybór produktu: item_list_id, item_list_name i tablica items identyfikują wybrany produkt lub pakiet.
• Zdarzenia koszyka i realizacji rezerwacji: currency, numeryczna wartość value, order_id, locale i items. Elementy tablicy identyfikują typy biletów, ich liczbę, ceny jednostkowe oraz powiązany produkt lub pakiet. Wybór korzysta z identyfikatorów produktów lub pakietów, a kolejne zdarzenia — z identyfikatorów typów biletów.
• Zakup: obejmuje również transaction_id (numer referencyjny zamówienia). coupon jest uwzględniany w zdarzeniach begin_checkout, add_payment_info i purchase, gdy jest dostępny. Zdarzenia Analytics zawierają również widget_id.

Zakres śledzenia przychodów: value to suma śledzonych biletów w rezerwacjach produktów i pakietów, w tym voucherów produktowych. Nie obejmuje dodatków, towarów ani zakupów kart podarunkowych, dlatego przychody w GA4 mogą różnić się od pełnej wartości zamówienia.

Niestandardowe śledzenie

W przypadku niestandardowego śledzenia programista Twojej witryny może nasłuchiwać tych samych siedmiu zdarzeń na obiekcie document z prefiksem th:, na przykład th:purchase. Ich dane znajdują się w event.detail, a zdarzenia pozostają dostępne także wtedy, gdy wbudowane śledzenie Google Analytics jest wyłączone.

Sprawdzanie konfiguracji

Wykonaj testową rezerwację na stronie, na której osadzono widget. Sprawdź GA4 Realtime lub DebugView; aktualizacja standardowych raportów może potrwać 24–48 godzin. W przypadku Tag Managera użyj trybu Preview, aby sprawdzić, czy tagi GA4 są uruchamiane, a następnie opublikuj zmiany.

Aby sprawdzić logowanie w konsoli, brakujące zdarzenia oraz problemy ze zgodami lub blokadami reklam, skorzystaj z artykułu Jak debugować śledzenie Google Analytics i Tag Managera.