DOKUMENTACJA TRACKINGU

Oprócz wymienionych powyżej parametrów do każdego zdarzenia, w miarę możliwości, dołączane są zawsze następujące parametry:

​

• doorId: ID aktualnie wybranych drzwi

• externalDoorId: zewnętrzne ID aktualnie wybranych drzwi

• scenarioId: ID aktualnie wybranej sceny (przykładowego zdjęcia)

• scenarioType: typ aktualnie wyświetlanej sceny. Przyjmuje wartość „USER” dla sceny przesłanej przez użytkownika lub „EXAMPLE” dla sceny przykładowej

• userId: ID użytkownika frontendu

• customerKey: klucz Państwa środowiska

​

Konfiguracja w Google Tag Manager

Aby zdarzenia niestandardowe były prawidłowo przekazywane do tagu, należy poprawnie skonfigurować następujące zasoby:

• 1. Zmienne

• 2. Tag, do którego trafiają zdarzenia niestandardowe (np. Google Analytics)​

• 3. Trigger określający, które zdarzenia mają być przekazywane do tagu​

​​

​

1. Zmienne

Dla każdego z wymienionych powyżej zdarzeń, które mają być przekazywane, utwórz osobną zmienną niestandardową w następujący sposób:

1. W GTM przejdź do sekcji „Variables”.

2. Kliknij „New” i wybierz „Data Layer Variable”:

   • Ustaw nazwę zmiennej warstwy danych na `body.<label>`, gdzie label oznacza etykietę z powyższej tabeli.​​

   • Przykład: zmienną niestandardową dla ID sceny należy zdefiniować jako `body.scenarioId`.

   • Jako wersję Data Layer wybierz „Version 2”.

​

Oprócz zmiennej niestandardowej należy też utworzyć zmienną typu „Data Layer Variable” dla pola event w warstwie danych, aby przechwytywać nazwę zdarzenia. Wykonaj następujące kroki:​​​​​

1. Kliknij „New”, aby utworzyć nową zmienną.

2. Jako typ zmiennej wybierz „Data Layer Variable”.

3. W polu „Data Layer Variable Name” wpisz „event”, aby przechwytywać nazwę zdarzenia.

4. Jako wersję Data Layer wybierz „Version 2”.

​​

2. Trigger

Aby zdefiniowane zdarzenia niestandardowe były prawidłowo przekazywane do tagu, należy skonfigurować trigger. Wykonaj poniższe kroki, aby utworzyć trigger nasłuchujący wszystkich zdarzeń niestandardowych:

1. W GTM przejdź do sekcji „Triggers”.

2. Utwórz nowy trigger:

   • Kliknij „New” i jako typ triggera wybierz „Custom Event”.

• W polu „Event Name” użyj symbolu wieloznacznego (.*), aby objąć wszystkie zdarzenia. Dzięki temu trigger uruchomi się dla każdego zdarzenia niestandardowego przekazanego do dataLayer. Koniecznie zaznacz pole wyboru włączające dopasowanie wyrażeń regularnych.

  • Przykład:

    • Trigger Type: Custom Event

    • Event Name: .* (wyrażenie regularne)

    • This trigger fires on: All Custom Events

​

3. Tag

Po skonfigurowaniu triggera należy skonfigurować tag, który będzie wysyłać dane do miejsca docelowego (np. Google Analytics GA4). Aby utworzyć tag dla Google Analytics GA, wykonaj następujące kroki:

1. W GTM przejdź do sekcji „Tags”.

2. Utwórz nowy tag:

   • Kliknij „New” i jako typ tagu wybierz „Google Analytics: GA4 Event Tag”.

3. Skonfiguruj GA4 Event Tag:

   • W konfiguracji tagu wybierz „GA4 Configuration Tag” (zawierający Measurement ID).

   • W polu „Event Name” wpisz {{event}}, aby dynamicznie przechwytywać nazwę wywoływanego zdarzenia.

4. Przypisz zmienne niestandardowe do parametrów GA4:

   • Aby wysyłać dodatkowe dane (np. scenarioId, userId lub doorId) jako parametry niestandardowe, dodaj odpowiednie przypisania w sekcji „Event Parameters”.

   • Przykład:

     • Parameter Name: scenario_id, Value: nazwa zmiennej, np. {{scenario_id}}

5. Dołącz trigger:

   • W sekcji „Triggering” wybierz utworzony w poprzednim kroku trigger „All Custom Events Trigger”.

​

Po zakończeniu konfiguracji tag będzie uruchamiany przy każdym zdarzeniu niestandardowym wysłanym do dataLayer, a odpowiednie dane będą przekazywane do Google Analytics GA4.

​

4. Debugowanie zdarzeń w trybie Preview

Po skonfigurowaniu zmiennych niestandardowych, triggerów i tagów należy koniecznie, jeszcze przed publikacją, przetestować konfigurację i upewnić się, że wszystko działa prawidłowo. Do debugowania zdarzeń Google Tag Manager oferuje wbudowany tryb podglądu (Preview Mode).

Aby zdebugować zdarzenia, wykonaj następujące kroki:

​

Jak korzystać z trybu podglądu:

1. Włącz tryb podglądu:

   • W obszarze roboczym GTM kliknij przycisk „Preview” w prawym górnym rogu ekranu.

   • W nowej karcie otworzy się Tag Assistant, w którym można wpisać adres URL strony. Użyj adresu URL swojego środowiska DoorVision, np. demo.door-vision.com dla naszego środowiska demo.

2. Wykonaj działania na stronie:

   • Po włączeniu trybu podglądu wykonaj w aplikacji jedną z czynności z powyższej listy. Aby na przykład przetestować zdarzenie selectDoor, wybierz model drzwi w panelu z ofertą drzwi.

3. Sprawdź zdarzenia w Tag Assistant:

   • Tag Assistant na bieżąco wyświetla w lewym panelu listę zdarzeń wywołanych podczas korzystania z aplikacji.

   • Znajdź na liście zdarzenie niestandardowe (np. selectDoor) i kliknij je, aby wyświetlić szczegóły.

4. Sprawdź, czy tag został uruchomiony:

   • Dla każdego zdarzenia sprawdź w sekcjach „Tags Fired” i „Tags Not Fired”, czy GA4 Event Tag uruchomił się prawidłowo.

   • Jeśli tag się nie uruchomił, sprawdź warunki triggera i upewnij się, że zdarzenie odpowiada jego konfiguracji (np. przy triggerze zdarzenia niestandardowego sprawdź poprawność nazwy zdarzenia).

5. Sprawdź warstwę danych:

   • W sekcji „Data Layer” w Tag Assistant sprawdź dane przekazane dla każdego zdarzenia. Powinny być widoczne wszystkie skonfigurowane zmienne i ich wartości, np. scenarioId, userId oraz pole event opisujące wykonaną czynność.

   • Upewnij się, że wszystkie wymagane dane są obecne, a zmienne są prawidłowo przypisane.

6. Użyj DebugView w Google Analytics:

   • Jeśli korzystają Państwo z Google Analytics GA4, dane zdarzeń można też zweryfikować w GA4 DebugView.

     • Otwórz Google Analytics, przejdź do DebugView (w sekcji „Events”) i sprawdź, czy GA4 odbiera zdarzenia.

     • Odszukaj parametry niestandardowe (np. scenario_id, user_id), aby upewnić się, że są prawidłowo przekazywane.

​

Rozwiązywanie problemów:

• Jeśli tag się nie uruchamia, ponownie sprawdź w GTM konfigurację triggera i nazwy zdarzenia.

• Jeśli zmienne nie przekazują poprawnych wartości, zweryfikuj nazwy zmiennych „Data Layer Variable”.

• Sprawdź, czy w przeglądarce nie jest włączony bloker reklam lub podobne rozszerzenie, które może blokować śledzenie (np. uBlock, Ghostery itp.)