Blog
Joomla için SignalHost: uzantıyı kurun, bir kez bağlayın ve sunucu tarafı izleme yayında
Yayınlandı · 5 dk okuma
Joomla Extensions Directory üzerinden edinin
SignalHost uzantısı, sunucu tarafı Google Tag Manager'ı bir Joomla sitesine tek satır kod yapıştırmadan kurar. İzleme yükleyicisini sitenizin her sayfasına ekler, bizim tarafımızda bir şey değiştiğinde onu güncel tutar ve bağlantıyı kestiğinizde yeniden kaldırır. Bu kılavuz, adımları karşınıza çıktıkları sırayla izler: paketi kurma, konteyner bağlama, çalıştığını kontrol etme ve bir şey çalışmadığında yapılacaklar.
Başlamadan önce
- PHP 7.4 veya daha yeni bir sürümde çalışan Joomla 4.4, 5 veya 6.
- Bir SignalHost hesabı. Denemek için ücretsiz plan yeterlidir: ayda 10.000 istek ve bir konteyner. Hesabı bağlanırken de oluşturabilirsiniz.
- Joomla yönetim panelinde bir Super User hesabı: bağlanmak ve bağlantıyı kesmek, Super User'ların sahip olduğu SignalHost bileşenini yapılandırma iznini gerektirir.
1. Uzantıyı kurun
Paketi, SignalHost Server-Side Tagging adıyla listelendiği Joomla Extensions Directory sayfasından indirin. Joomla yönetim panelinizde System › Install › Extensions bölümünü açın ve zip dosyasını yükleyin.
Bu, iki parçalı tek bir pakettir: siteyi bağladığınız ve durumunu gördüğünüz SignalHost bileşeni ile kodu sayfalarınıza yerleştiren System - SignalHost Server-Side Tagging sistem eklentisi. Kurulum eklentiyi kendiliğinden etkinleştirir; site bağlanana kadar eklenti hiçbir şey yazdırmaz.
2. Siteyi bir konteynere bağlayın
Components › SignalHost bölümünü açın ve “Connect with SignalHost” düğmesine basın. Henüz hesabınız yoksa “Create a free account” sizi bunun yerine kayıt sayfasına götürür. Siz “Connect with SignalHost” düğmesine basmadan SignalHost'a hiçbir şey gönderilmez.
signalhost.io'da oturum açın. Sonraki ekran uzantının neleri yapabileceğini ve neleri yapamayacağını listeler ve sitenin hangi konteyneri kullanması gerektiğini sorar. Konteyner, size ait etiketleme sunucunuzdur: kendi Google hesabınızda oluşturulan bir Tag Manager web konteyneri ve sunucu konteyneri; bu yüzden sizin olarak kalırlar.
Mevcut bir konteyneri seçin ya da sitenizin adını taşıyan “… için yeni konteyner” seçeneğine basıp kısa sihirbazdan geçin. Yeni bir konteynerin oluşturulması birkaç dakika sürer; hemen bağlanabilirsiniz ve kod, konteyner hazır olur olmaz eklenir. “Bağlan” düğmesine basın. Connected mesajıyla birlikte Components › SignalHost ekranına geri dönersiniz. SignalHost'un kodu artık sitenizin her sayfasına eklenmiştir.
3. Kodun sitenizde olduğunu kontrol edin
Ekran artık Tracking is live der; yeni bir konteyner hâlâ oluşturuluyorsa Tracking starts as soon as your container is ready yazar. Ardından On your home page satırını okuyun: bağlandıktan hemen sonra uzantı ana sayfanızı bir ziyaretçinin yapacağı gibi getirir ve kendi kodunu arar. İstediğiniz yanıt Code found'dur. “Check again” kontrolü istediğiniz zaman tekrarlar; diğer yanıtları “Bir şey çalışmadığında” bölümünde bulabilirsiniz.
4. Test edin
Sitenizi gizli bir pencerede açın ve birkaç sayfaya tıklayın; çerez banner'ınızı reddeden bir ziyaretçi de Google'ın çerezsiz ping'i olarak sayılır. Ardından signalhost.io'daki konteyner sayfanızı açmak için “Open statistics & settings” düğmesine basın.
“Gelişmiş analiz” altındaki “Son veriler” sekmesi, aralarında sizinkilerin de bulunduğu son 30 dakikanın sayfa görüntülemelerini gösterir. Sayfanın en altındaki “Sorun giderme” bölümünde yer alan “Kontrolleri çalıştır”, etiketleme sunucunuzun aldıklarını Google Analytics'in aynı 30 dakika için raporladıklarıyla karşılaştırır. Analytics'te daha az görmeniz normaldir: çerezleri reddeden ziyaretçileri dışarıda bırakır. Growth planından itibaren “Canlı etkinlik izleme” her etkinliği geldiği anda gösterir.
Uzantının sitenize ekledikleri
Küçük bir betik ve saatte bir yapılan bir bağlantı kontrolü:
- Google Tag Manager yükleyicisi: sitenizin sayfalarının head bölümünde, googletagmanager.com yerine kendi etiketleme adresinize yönlendirilmiş olarak. Tag Manager konteynerinizi oradan yükler. Eklenti onu Joomla'nın Web Asset Manager'ı üzerinden ekler; böylece siteniz bir CSP nonce kullanıyorsa yükleyici de onu taşır. Yönetim panelinde, bir beslemede ya da yalnızca bileşenden oluşan bir görünümde hiçbir zaman çalışmaz.
- Eklenti saatte bir, bir sayfa gönderildikten sonra güncel kalmak için signalhost.io ile bağlantı kurar. Yalnızca uzantının, Joomla'nın ve PHP'nin sürümlerini, sitenizin adresini ve kodun ana sayfanızda bulunup bulunmadığını gönderir: ziyaretçi verisi, içerik ya da kullanıcı hesabı göndermez. signalhost.io'ya ulaşılamazsa siteniz son geçerli yapılandırmayı korur.
Her istek tarayıcıdan reklam engelleyicilerin tanımadığı bir biçimde çıkar ve etiketleme sunucunuz onu Google Analytics 4'e ve konteyner sayfasında kurduğunuz reklam platformlarına iletir: Google Ads, Meta, TikTok ve diğerleri. İzleme, Google Consent Mode aracılığıyla çerez banner'ınızı izler; banner'ınızın kodunu SignalHost'unkinden önceye koyun.
Uzantı formları veya siparişleri okumaz. Sayfa görüntülemeleri kendiliğinden gelir; bir satın alma ya da potansiyel müşteri ise siteniz onu data layer'a push ettiğinde konteynerinize ulaşır.
Kendi izleme alan adınız
Konteyneriniz signalhost.io altındaki bir adresle başlar. Ücretli bir planda konteyner sayfasındaki “Kendi alan adınızı kurun”, sağlayıcınızdaki tek bir DNS kaydıyla onu kendi sitenizin sgtm.yoursite.com gibi bir alt alan adına taşır. Bu adres filtre listelerine takılmaz ve tıklama çerezlerini birinci taraf tutar. Alan adı yayına girdiğinde uzantı, bir sonraki bağlantı kontrolünde (genellikle bir saat içinde) sitenizi ona geçirir ve Joomla'nın sayfa önbelleğini temizler. Elle değiştirilmesi gereken hiçbir şey yoktur ve eski adres o zamana kadar çalışmaya devam eder.
SignalHost'u elle eklemek
Kodu kendiniz de yapıştırabilirsiniz. Konteyner sayfasında “Sitenize yükleyin” kartındaki kod parçacığınızı bulun ve “Kopyala” düğmesine basın. Onu her sayfanın head bölümüne (Joomla'da site şablonunuza), çerez banner'ınızın betiğinin hemen arkasına yapıştırın ve “Bunu yaptım” düğmesine basın. “Yapay zekâ asistanı için kopyala” aynı işi bir kodlama asistanına devreder.
Elle yapıştırmak, uzantının yaptıklarından vazgeçmek demektir: ana sayfanızı hiçbir şey kontrol etmez, bağlantıyı kestiğinizde kodu hiçbir şey kaldırmaz, siz eklemedikçe yükleyici bir CSP nonce almaz ve kendi alan adınız yayına girdiğinde kodu kartın “Web sitenizdeki kod parçacığını güncelleyin” bölümünden ya da alan adını duyuran e-postadan alarak kendiniz değiştirirsiniz. İki yolu asla birlikte kullanmayın: iki kopya her ziyareti iki kez sayar.
Güncellemeler, yönetme ve bağlantıyı kesme
Güncellemeler, diğer tüm uzantılarda olduğu gibi Joomla'nın kendi güncelleyicisi üzerinden, System › Update › Extensions altında gelir.
Components › SignalHost ekranındaki Disconnect bir kez onay ister, ardından sitenin erişimini iptal eder, kodu her sayfadan kaldırır ve Joomla'nın sayfa önbelleğini temizler. Konteyneriniz ve istatistikleri yerinde kalır; istediğiniz zaman yeniden bağlanabilirsiniz.
signalhost.io'da konteyner sayfası “… sitesindeki Joomla uzantısı tarafından kuruldu” der. Sayfadaki “Yönet” düğmesi sizi “Ayarlar”, “Bağlı siteler” sayfasına götürür; oradaki “Bağlantıyı kes” de çalışır: uzantı bir sonraki bağlantı kontrolünde, genellikle bir saat içinde SignalHost'u yüklemeyi bırakır.
Paketi kaldırmak, uzantının sakladığı her şeyi siler. SignalHost'un da sitenin gittiğini bilmesi için önce bağlantıyı kesin.
Bir şey çalışmadığında
- Code not found: eklenti kapalı olabilir. Joomla'nın eklenti yöneticisinde System - SignalHost Server-Side Tagging eklentisini etkinleştirin, ardından “Check again” düğmesine basın.
- Could not check (your server refused a request to itself): sunucunuz kendi adresine yapılan istekleri engelliyor. Bu, ziyaretçileriniz hakkında hiçbir şey söylemez; ana sayfanızın kaynak kodunda etiketleme adresinizi arayın.
- An older copy is on the page ya da The code is on the page twice: bir kopya elle bir şablona veya başka bir uzantıya yapıştırılmış. Onu kaldırın; güncel olanı uzantı ekler ve iki kopya her ziyareti iki kez sayar.
- Sitenizin bir Tag Manager konteynerini zaten Google'ın kendi kod parçacığıyla yüklediğini bildiren bir uyarı: o kod parçacığını kaldırın, çünkü konteyneri artık SignalHost yüklüyor ve ikisi birlikte her ziyareti iki kez sayar.
- This site's address has changed since it was connected: bir kopyada, örneğin staging ortamında, hiçbir şey gönderilmez. Canlı site taşındıysa bağlantıyı kesip yeniden bağlanın.
- Components › SignalHost bunun yerine sürekli kontrol panelini açıyor: yeni kurulmuş bir Joomla'da ilk girişteki rehberli tur, siz onu gizleyene kadar her yönetim sayfasında bunu yapar.
- Başka bir sorun varsa: sitenizin adresiyle birlikte hello@signalhost.io adresine yazın.
Ticari markalar
SignalHost, Algorithmo GmbH'nin bağımsız bir ürünüdür; Open Source Matters, Google, Meta veya TikTok ile bağlantılı değildir ve bunlar tarafından onaylanmamıştır. Google Analytics, Google Ads ve Google Tag Manager, Google LLC'nin ticari markalarıdır; Meta, Meta Platforms, Inc.'in ticari markasıdır; TikTok, ByteDance Ltd.'nin ticari markasıdır; Joomla!, Open Source Matters, Inc.'in ticari markasıdır.

