SignalHost dla TYPO3: zainstaluj rozszerzenie, połącz każdą witrynę i śledzenie po stronie serwera działa

• TYPO3 13.4 LTS lub 14.3 LTS na PHP 8.2 lub nowszym z rozszerzeniem sodium.
• Konto SignalHost. Do wypróbowania wystarczy plan darmowy: 10 000 żądań miesięcznie i jeden kontener. Konto możesz założyć w trakcie łączenia.
• Konto administratora backendu. Moduł SignalHost jest przeznaczony wyłącznie dla administratorów.
• Witryna, której adres bazowy w konfiguracji witryny zawiera domenę, na przykład https://www.example.com/.

W instalacji opartej na Composerze dodaj je z Packagist:

composer require signalhost/server-side-tagging

W trybie klasycznym zainstaluj je zamiast tego z Extension Manager; znajduje się w TYPO3 Extension Repository pod kluczem signalhost_server_side_tagging. Nie dodaje niczego do witryny, dopóki ta witryna nie zostanie połączona.

W backendzie TYPO3 otwórz Sites › SignalHost (Site Management › SignalHost w TYPO3 13), gdzie każda witryna ma własną kartę. Po połączeniu SignalHost odsyła Cię na adres danej witryny, więc otwórz backend pod domeną tej witryny; w innym przypadku karta ma przycisk, który otwiera tę stronę pod właściwą domeną, gdzie być może trzeba będzie raz się zalogować.

Na karcie witryny naciśnij „Connect with SignalHost” albo „Create a free account”, jeśli nie masz jeszcze konta. Do SignalHost nic nie jest wysyłane, zanim nie naciśniesz „Connect”. Na signalhost.io zaloguj się. Następny ekran wymienia, co rozszerzenie będzie mogło robić, a czego nie, i pyta, którego kontenera ma używać witryna. Kontener to Twój własny serwer tagowania: kontener internetowy i kontener serwerowy Tag Managera, zbudowane na Twoim własnym koncie Google, więc pozostają Twoje.

Wybierz istniejący kontener albo naciśnij „Nowy kontener dla …” i przejdź krótki kreator. Budowa nowego trwa kilka minut; możesz połączyć od razu, a kod zostanie dodany, gdy tylko kontener będzie gotowy. Naciśnij „Połącz”, a wrócisz na kartę z komunikatem „Connected”. Kod SignalHost jest teraz dodany na każdej stronie tej witryny. Powtórz to dla każdej witryny, którą chcesz śledzić.

Karta witryny pokazuje teraz „Tracking is live” albo, gdy nowy kontener jest jeszcze budowany, „Tracking starts as soon as your container is ready”. Potem przeczytaj wiersz „On your home page”: zaraz po połączeniu rozszerzenie pobiera Twoją stronę główną tak, jak zrobiłby to odwiedzający, i szuka na niej swojego kodu. „Code found” to odpowiedź, na którą czekasz. „Check again” w każdej chwili powtarza sprawdzenie, a pozostałe odpowiedzi opisuje sekcja „Gdy coś nie działa”.

Otwórz swoją witrynę w oknie prywatnym i przejdź przez kilka stron; odwiedzający, który odrzuci Twój baner cookie, nadal jest liczony, jako sygnał Google bez plików cookie. Potem naciśnij „Open statistics & settings”, aby otworzyć stronę kontenera na signalhost.io.

W sekcji „Rozszerzona analityka” zakładka „Ostatnie” pokazuje odsłony z ostatnich 30 minut, w tym Twoje. „Uruchom sprawdzanie” na karcie „Rozwiązywanie problemów” u dołu strony porównuje to, co otrzymał Twój serwer tagowania, z tym, co Google Analytics raportuje za te same 30 minut. Mniej w Analytics to norma: pomija ono odwiedzających, którzy odrzucili pliki cookie. Od planu Growth w górę „Monitorowanie zdarzeń na żywo” pokazuje każde zdarzenie w chwili nadejścia.

Jeden mały skrypt na każdą połączoną witrynę i jeden cogodzinny kontakt z serwerem:

• Program ładujący Google Tag Manager, tuż przed końcem sekcji head każdej strony frontendu, skierowany na własny adres tagowania witryny zamiast na googletagmanager.com. Ładuje stamtąd Twój kontener Tag Managera. Trafia do gotowej strony już po pamięci podręcznej stron TYPO3, więc żadnej pamięci podręcznej nie trzeba czyścić. Jeśli witryna egzekwuje Content Security Policy TYPO3, rozszerzenie dodaje do niej adres tagowania i dopuszcza program ładujący po jego skrócie, chyba że polityka już zezwala na skrypty inline.
• Raz na godzinę, po wysłaniu odpowiedzi, rozszerzenie kontaktuje się z signalhost.io, aby pozostać aktualnym. Wysyła tylko wersje rozszerzenia, TYPO3 i PHP, adres witryny oraz informację, czy kod został znaleziony na stronie głównej: żadnych danych odwiedzających, treści ani kont użytkowników. Jeśli signalhost.io jest nieosiągalny, witryna zachowuje ostatnią poprawną konfigurację.

Każde żądanie opuszcza przeglądarkę w postaci, której blokery reklam nie rozpoznają, a Twój serwer tagowania przekazuje je do Google Analytics 4 i platform reklamowych skonfigurowanych na stronie kontenera: Google Ads, Meta, TikToka i innych. Śledzenie podąża za Twoim banerem cookie przez Google Consent Mode. Program ładujący pojawia się po banerze umieszczonym w sekcji head; baner ładowany później musi ustawić domyślne wartości Consent Mode przed nim.

Rozszerzenie nie odczytuje formularzy ani zamówień. Odsłony docierają same; zakup lub lead dociera do Twojego kontenera, gdy Twoja witryna wypchnie go do warstwy danych.

Twój kontener startuje pod adresem w signalhost.io. W planie płatnym przycisk „Skonfiguruj własną domenę” na stronie kontenera przenosi go na subdomenę Twojej własnej witryny, taką jak sgtm.twojastrona.pl, za pomocą jednego rekordu DNS u Twojego dostawcy. Ten adres przetrwa listy filtrów, a pliki cookie kliknięć pozostają na nim własnymi plikami cookie Twojej domeny. Gdy zacznie działać, rozszerzenie przełączy na niego tę witrynę przy następnym kontakcie, zwykle w ciągu godziny, a jej Content Security Policy podąży za tą zmianą. Niczego nie trzeba wymieniać ręcznie, a do tego czasu stary adres działa dalej.

Kod możesz też wkleić sam. Na stronie kontenera znajdź swój fragment kodu na karcie „Zainstaluj w witrynie” i naciśnij „Kopiuj”. Wklej go w sekcji head każdej strony (w TYPO3: przez szablon lub TypoScript), bezpośrednio po skrypcie banera cookie, i naciśnij „Zrobione”. „Kopiuj dla agenta AI” przekazuje to samo zadanie agentowi programistycznemu.

Ręczne wklejenie oznacza rezygnację z tego, co robi rozszerzenie: nic nie sprawdza Twojej strony głównej, nic nie usuwa kodu, gdy się odłączysz, witryna egzekwująca Content Security Policy TYPO3 wymaga ręcznego dopuszczenia skryptu i adresu tagowania, a gdy Twoja własna domena zacznie działać, sam wymieniasz kod — z sekcji „Zaktualizuj kod na swojej stronie” na karcie albo z e-maila zapowiadającego domenę. Nigdy nie używaj obu sposobów naraz: dwie kopie liczą każdą wizytę podwójnie.

Aktualizuj je tak, jak je zainstalowałeś: przez Composer albo, w trybie klasycznym, z Extension Manager.

„Disconnect” na karcie witryny pyta raz, a potem od razu usuwa kod SignalHost ze wszystkich stron tej witryny i cofa jej dostęp. Pozostałe witryny pozostają połączone, a Twój kontener i jego dane zostają na Twoim koncie SignalHost.

Na signalhost.io strona kontenera pokazuje „Zainstalowane przez rozszerzenie TYPO3 na witrynie …” z adresem Twojej witryny. Jej przycisk „Zarządzaj” prowadzi do sekcji „Ustawienia › Połączone witryny”, gdzie „Odłącz” też działa: rozszerzenie przestaje wczytywać SignalHost przy następnym kontakcie, zwykle w ciągu godziny.

Dezaktywacja rozszerzenia w Extension Manager, w trybie klasycznym, cofa dostęp wszystkich witryn i usuwa to, co rozszerzenie zapisało. composer remove nie uruchamia żadnego kodu TYPO3, więc najpierw odłącz każdą witrynę; w przeciwnym razie pozostaną widoczne w sekcji „Ustawienia › Połączone witryny” i odłączysz je tam.

• Karta mówi, że po połączeniu SignalHost odsyła Cię na adres danej witryny: backend został otwarty pod inną domeną. Użyj przycisku pod tym komunikatem, aby otworzyć stronę pod domeną witryny.
• „Could not check (your server refused a request to itself)”: Twój hosting blokuje żądania na własny adres. Nie mówi to nic o Twoich odwiedzających; poszukaj swojego adresu tagowania w źródle strony głównej.
• „An older copy is on the page” albo „The code is on the page twice”: kopia została ręcznie wklejona do szablonu, TypoScriptu lub innego rozszerzenia. Usuń ją; rozszerzenie dodaje aktualną, a dwie kopie liczą każdą wizytę podwójnie.
• Komunikat, że Twoja witryna już ładuje kontener Tag Managera własnym fragmentem kodu Google: usuń ten fragment, bo kontener ładuje teraz SignalHost, a oba razem liczą każdą wizytę podwójnie.
• „This site's address has changed since it was connected”: na kopii, na przykład testowej, nic nie jest wysyłane. Jeśli działająca witryna zmieniła adres, odłącz ją i połącz ponownie.
• Coś innego: napisz na hello@signalhost.io i podaj adres swojej witryny.

SignalHost jest niezależnym produktem Algorithmo GmbH i nie jest powiązany z TYPO3 Association, Google, Meta ani TikTok, ani przez nie popierany. Google Analytics, Google Ads i Google Tag Manager są znakami towarowymi Google LLC; Meta jest znakiem towarowym Meta Platforms, Inc.; TikTok jest znakiem towarowym ByteDance Ltd.; TYPO3 jest zarejestrowanym znakiem towarowym TYPO3 Association.