Wróć do bloga

Blog

SignalHost dla Joomla: zainstaluj rozszerzenie, połącz raz i śledzenie po stronie serwera działa

Opublikowano · 6 min czytania

Pobierz z Joomla Extensions Directory

Rozszerzenie SignalHost umieszcza Google Tag Manager po stronie serwera na witrynie Joomla bez ani jednej linijki wklejanego kodu. Dodaje program ładujący śledzenia na każdej stronie Twojej witryny, aktualizuje go, gdy coś zmieni się po naszej stronie, i usuwa go, gdy się odłączysz. Ten poradnik idzie w kolejności, w jakiej się z nim spotykasz: instalacja pakietu, łączenie z kontenerem, sprawdzanie, czy działa, i to, co zrobić, gdy nie działa.

Zanim zaczniesz

  • Joomla 4.4, 5 lub 6 na PHP 7.4 lub nowszym.
  • 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 Super User w panelu administracyjnym Joomla: łączenie i odłączanie wymagają uprawnienia do konfigurowania komponentu SignalHost, które ma każdy Super User.

1. Zainstaluj rozszerzenie

Pobierz pakiet z Joomla Extensions Directory, gdzie jest wymieniony jako SignalHost Server-Side Tagging. W panelu administracyjnym Joomla otwórz System › Install › Extensions i prześlij plik zip.

To jeden pakiet z dwiema częściami: komponentem SignalHost, w którym łączysz witrynę i widzisz jej stan, oraz wtyczką systemową System - SignalHost Server-Side Tagging, która umieszcza kod na Twoich stronach. Instalacja sama włącza wtyczkę; nie wstawia ona niczego, dopóki witryna nie zostanie połączona.

2. Połącz witrynę z kontenerem

Otwórz Komponenty › SignalHost i naciśnij „Connect with SignalHost”. Jeśli nie masz jeszcze konta, „Create a free account” przeniesie Cię zamiast tego do rejestracji. 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”. Wrócisz do Komponenty › SignalHost z komunikatem „Connected”. Kod SignalHost jest teraz dodany na każdej stronie Twojej witryny.

3. Sprawdź, czy kod jest na Twojej witrynie

Ekran 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”.

4. Przetestuj

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.

Co rozszerzenie dodaje do Twojej witryny

Jeden mały skrypt i jeden cogodzinny kontakt z serwerem:

  • Program ładujący Google Tag Manager w sekcji head stron Twojej witryny, skierowany na Twój własny adres tagowania zamiast na googletagmanager.com. Ładuje stamtąd Twój kontener Tag Managera. Wtyczka dodaje go przez Web Asset Manager Joomla, więc otrzymuje on nonce CSP, gdy Twoja witryna go używa. Nigdy nie działa w panelu administracyjnym, w kanale informacyjnym ani w widoku samego komponentu.
  • Raz na godzinę, po wysłaniu strony, wtyczka kontaktuje się z signalhost.io, aby pozostać aktualną. Wysyła tylko wersje rozszerzenia, Joomla i PHP, adres Twojej witryny oraz informację, czy kod został znaleziony na Twojej stronie głównej: żadnych danych odwiedzających, treści ani kont użytkowników. Jeśli signalhost.io jest nieosiągalny, Twoja 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; umieść kod banera przed kodem SignalHost.

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.

Twoja własna domena śledząca

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 Twoją witrynę przy następnym kontakcie, zwykle w ciągu godziny, i wyczyści pamięć podręczną stron Joomla. Niczego nie trzeba wymieniać ręcznie, a do tego czasu stary adres działa dalej.

Ręczne dodanie SignalHost

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 Joomla: w szablonie witryny), 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, program ładujący nie dostaje nonce CSP, chyba że sam go dodasz, 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.

Aktualizacje, zarządzanie i odłączanie

Aktualizacje przychodzą przez wbudowany mechanizm aktualizacji Joomla, w System › Update › Extensions, tak jak w przypadku każdego innego rozszerzenia.

„Disconnect” na ekranie Komponenty › SignalHost pyta raz, a potem cofa dostęp witryny, usuwa kod ze wszystkich stron i czyści pamięć podręczną stron Joomla. Twój kontener i jego statystyki pozostają, a połączyć się ponownie możesz w każdej chwili.

Na signalhost.io strona kontenera pokazuje „Zainstalowane przez rozszerzenie Joomla 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.

Odinstalowanie pakietu usuwa wszystko, co rozszerzenie zapisało. Najpierw się odłącz, aby SignalHost też wiedział, że witryny już nie ma.

Gdy coś nie działa

  • „Code not found”: wtyczka może być wyłączona. Włącz System - SignalHost Server-Side Tagging w menedżerze wtyczek Joomla, a potem naciśnij „Check again”.
  • „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 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.
  • Komponenty › SignalHost zamiast tego wciąż otwiera panel główny: w świeżej instalacji Joomla robi to z każdą stroną panelu administracyjnego przewodnik wyświetlany przy pierwszym logowaniu, dopóki go nie ukryjesz.
  • Coś innego: napisz na hello@signalhost.io i podaj adres swojej witryny.

Znaki towarowe

SignalHost jest niezależnym produktem Algorithmo GmbH i nie jest powiązany z Open Source Matters, 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.; Joomla! jest znakiem towarowym Open Source Matters, Inc.

Przestań tracić dane przez blokery

Zacznij bezpłatnie. Uruchom pierwszy kontener w kilka minut.