العودة إلى المدونة

المدونة

SignalHost لـ Joomla: ثبّت الملحق، واربط مرة واحدة، فيعمل التتبّع من جانب الخادم

نُشر · 6 دقائق قراءة

احصل عليه من Joomla Extensions Directory

يضع ملحق SignalHost خدمة Google Tag Manager من جانب الخادم على موقع Joomla دون سطر واحد من الكود الملصوق. فهو يضيف مُحمِّل التتبّع إلى كل صفحة من موقعك، ويُبقيه محدّثًا كلما تغيّر شيء في جانبنا، ويزيله مجددًا حين تقطع الاتصال. يتبع هذا الدليل الترتيب الذي تصادفه به: تثبيت الحزمة، ثم ربط حاوٍ، ثم التحقق من أنه يعمل، وما تفعله حين لا يعمل.

قبل أن تبدأ

  • Joomla 4.4 أو 5 أو 6، يعمل على PHP 7.4 أو أحدث.
  • حساب SignalHost. الخطة المجانية تكفي للتجربة: عشرة آلاف طلب شهريًا وحاوٍ واحد. ويمكنك إنشاء الحساب أثناء الربط.
  • حساب Super User في لوحة إدارة Joomla: يحتاج الربط وقطع الاتصال إلى صلاحية ضبط مكوّن SignalHost، وهي صلاحية يملكها Super Users.

1. ثبّت الملحق

نزّل الحزمة من دليل ملحقات Joomla، حيث تظهر باسم SignalHost Server-Side Tagging. في لوحة إدارة Joomla، افتح System › Install › Extensions وارفع ملف zip.

إنها حزمة واحدة من جزأين: مكوّن SignalHost، حيث تربط الموقع وترى حالته، وإضافة النظام System - SignalHost Server-Side Tagging، التي تضع الكود في صفحاتك. يفعّل التثبيت الإضافة من تلقاء نفسه؛ ولا تطبع شيئًا حتى يُربط الموقع.

2. اربط الموقع بحاوٍ

افتح Components › SignalHost واضغط «Connect with SignalHost». وإن لم يكن لديك حساب بعد، فإن «Create a free account» ينقلك إلى صفحة التسجيل بدلًا من ذلك. لا يُرسَل أي شيء إلى SignalHost قبل أن تضغط زر الربط.

على signalhost.io، سجّل الدخول. تسرد الشاشة التالية ما سيتمكن الملحق من فعله وما لن يتمكن منه، وتسألك أي حاوٍ يجب أن يستخدمه الموقع. الحاوي هو خادم الوسم الخاص بك: حاوي ويب وحاوي خادم في Tag Manager، يُبنيان في حساب Google الخاص بك، فيبقيان ملكك.

اختر حاويًا موجودًا، أو اضغط «حاوية جديدة لـ…» مع اسم موقعك ومُرّ بالمعالج القصير. يستغرق بناء حاوٍ جديد بضع دقائق؛ ويمكنك الربط فورًا، ويُضاف الكود فور جاهزيته. اضغط «اربط». فتعود إلى Components › SignalHost مع الرسالة «Connected». وقد أصبح كود SignalHost الآن مضافًا إلى كل صفحة من موقعك.

3. تحقّق من وجود الكود على موقعك

تعرض الشاشة الآن «Tracking is live»، أو «Tracking starts as soon as your container is ready» بينما ما زال حاوٍ جديد قيد البناء. ثم اقرأ السطر «On your home page»: فبعد الربط مباشرة، يجلب الملحق صفحتك الرئيسية كما يفعل الزائر ويبحث عن الكود الخاص به. والجواب الذي تريده هو «Code found». يكرّر «Check again» الفحص في أي وقت، والأجوبة الأخرى مشروحة في قسم «حين لا يعمل شيء ما».

4. اختبره

افتح موقعك في نافذة خاصة وتنقّل بين بضع صفحات؛ فالزائر الذي يرفض لافتة ملفات تعريف الارتباط لديك يُحتسب مع ذلك، كإشارة Google بلا ملفات تعريف ارتباط. ثم اضغط «Open statistics & settings» لتفتح صفحة الحاوي على signalhost.io.

ضمن «تحليلات مفصّلة»، تعرض علامة التبويب «الأحدث» مشاهدات الصفحات في آخر 30 دقيقة، ومنها مشاهداتك. ويقارن «تشغيل الفحوصات»، ضمن «استكشاف الأخطاء وإصلاحها» أسفل الصفحة، ما تلقّاه خادم الوسم الخاص بك بما يُبلغ عنه Google Analytics للدقائق الثلاثين نفسها. ومن الطبيعي أن يكون الرقم في Analytics أقل: فهو يستبعد الزوار الذين رفضوا ملفات تعريف الارتباط. وبدءًا من خطة Growth، تعرض «مراقبة الأحداث مباشرة» كل حدث لحظة وصوله.

ما يضيفه الملحق إلى موقعك

سكربت صغير واحد، وتواصل واحد كل ساعة:

  • مُحمِّل Google Tag Manager، في قسم head من صفحات موقعك، موجَّهًا إلى عنوان الوسم الخاص بك بدلًا من googletagmanager.com. يحمّل حاوي Tag Manager لديك من هناك. تضيفه الإضافة عبر Web Asset Manager في Joomla، فيحمل CSP nonce حين يستخدمه موقعك. ولا يعمل أبدًا في لوحة الإدارة، ولا في خلاصة (feed)، ولا في عرض المكوّن وحده.
  • مرة كل ساعة، بعد إرسال صفحة، تتواصل الإضافة مع signalhost.io لتبقى محدّثة. ولا ترسل إلا إصدارات الملحق وJoomla وPHP، وعنوان موقعك، وما إذا عُثر على الكود في صفحتك الرئيسية: لا بيانات زوار، ولا محتوى، ولا حسابات مستخدمين. وإن تعذّر الوصول إلى signalhost.io، يحتفظ موقعك بآخر إعداد سليم.

يغادر كل طلب المتصفح بشكل لا تتعرّف عليه حاجبات الإعلانات، ويمرّره خادم الوسم الخاص بك إلى Google Analytics 4 وإلى منصات الإعلانات التي تُعدّها في صفحة الحاوي: Google Ads وMeta وTikTok وغيرها. ويتبع التتبّع لافتة ملفات تعريف الارتباط لديك عبر Google Consent Mode؛ فضع كود لافتتك قبل كود SignalHost.

لا يقرأ الملحق النماذج ولا الطلبات. تصل مشاهدات الصفحات من تلقاء نفسها؛ أما عملية الشراء أو العميل المحتمل فيصل إلى حاويك حين يدفعه موقعك إلى طبقة البيانات.

نطاق التتبّع الخاص بك

يبدأ حاويك على عنوان تحت signalhost.io. في خطة مدفوعة، ينقله «إعداد نطاقك الخاص» في صفحة الحاوي إلى نطاق فرعي من موقعك أنت، مثل sgtm.yoursite.com، بسجل DNS واحد لدى مزوّدك. ينجو ذلك العنوان من قوائم المرشّحات ويُبقي ملفات تعريف الارتباط الخاصة بالنقرات من الطرف الأول. وحين يبدأ الخدمة، ينقل الملحق موقعك إليه عند تواصله التالي، عادةً خلال ساعة، ويمسح ذاكرة التخزين المؤقت للصفحات في Joomla. لا يلزم استبدال أي شيء يدويًا، ويظل العنوان القديم يعمل حتى ذلك الحين.

إضافة SignalHost يدويًا

يمكنك أيضًا لصق الكود بنفسك. في صفحة الحاوي، ابحث عن المقتطف الخاص بك في بطاقة «التثبيت على موقعك» واضغط «نسخ». ألصقه في قسم head من كل صفحة (في Joomla، قالب موقعك)، مباشرة بعد سكربت لافتة ملفات تعريف الارتباط، واضغط «لقد فعلت ذلك». ويسلّم «نسخ لوكيل ذكاء اصطناعي» المهمة نفسها إلى وكيل برمجة.

اللصق اليدوي يتخلى عمّا يفعله الملحق: لا شيء يفحص صفحتك الرئيسية، ولا شيء يزيل الكود حين تقطع الاتصال، ولا يحصل المُحمِّل على CSP nonce ما لم تضفه بنفسك، وحين يبدأ نطاقك الخاص الخدمة تستبدل الكود بنفسك، من «حدّث مقتطف موقعك» في البطاقة أو من البريد الإلكتروني الذي يعلن عن النطاق. ولا تستخدم الطريقتين معًا أبدًا: فنسختان تحتسبان كل زيارة مرتين.

التحديثات والإدارة وقطع الاتصال

تصل التحديثات عبر أداة التحديث الخاصة بـ Joomla، ضمن System › Update › Extensions، مثل تحديثات أي ملحق آخر.

يسألك «Disconnect»، في شاشة Components › SignalHost، مرة واحدة، ثم يلغي وصول الموقع، ويزيل الكود من كل صفحة، ويمسح ذاكرة التخزين المؤقت للصفحات في Joomla. يبقى حاويك وإحصاءاته، ويمكنك الربط مجددًا في أي وقت.

على signalhost.io، تقول صفحة الحاوي «مثبّت بواسطة ملحق Joomla على» متبوعة بموقعك. ويقودك زر «إدارة» فيها إلى «الإعدادات»، ضمن «المواقع المرتبطة»، حيث يعمل «قطع الاتصال» أيضًا: يتوقف الملحق عن تحميل SignalHost عند تواصله التالي، عادةً خلال ساعة.

إلغاء تثبيت الحزمة يزيل كل ما خزّنه الملحق. اقطع الاتصال أولًا، لكي تعرف SignalHost أيضًا أن الموقع رحل.

حين لا يعمل شيء ما

  • «Code not found»: قد تكون الإضافة معطّلة. فعّل System - SignalHost Server-Side Tagging في مدير الإضافات في Joomla، ثم اضغط «Check again».
  • «Could not check (your server refused a request to itself)»: مضيفك يحجب الطلبات إلى عنوانه هو. وهذا لا يقول شيئًا عن زوارك؛ ابحث عن عنوان الوسم الخاص بك في مصدر صفحتك الرئيسية.
  • «An older copy is on the page» أو «The code is on the page twice»: لُصقت نسخة يدويًا في قالب أو في ملحق آخر. أزلها؛ فالملحق يضيف النسخة الحالية، ونسختان تحتسبان كل زيارة مرتين.
  • إشعار بأن موقعك يحمّل أصلًا حاوي Tag Manager بمقتطف Google نفسها: أزل ذلك المقتطف، لأن SignalHost تحمّل الحاوي الآن، والاثنان معًا يحتسبان كل زيارة مرتين.
  • «This site's address has changed since it was connected»: على نسخة مثل بيئة staging، لا يُرسَل شيء. وإن انتقل الموقع المباشر، فاقطع الاتصال واربط مجددًا.
  • يظل Components › SignalHost يفتح لوحة التحكم بدلًا منه: على Joomla مثبّت حديثًا، تفعل الجولة الإرشادية عند أول تسجيل دخول ذلك مع كل صفحة إدارة إلى أن تخفيها.
  • أي شيء آخر: اكتب إلى hello@signalhost.io مع عنوان موقعك.

العلامات التجارية

SignalHost منتج مستقل من Algorithmo GmbH، وهو غير تابع لـ Open Source Matters أو Google أو Meta أو TikTok ولا يحظى بتأييد أيٍّ منها. Google Analytics وGoogle Ads وGoogle Tag Manager علامات تجارية لـ Google LLC؛ وMeta علامة تجارية لـ Meta Platforms, Inc.؛ وTikTok علامة تجارية لـ ByteDance Ltd.؛ وJoomla! علامة تجارية لـ Open Source Matters, Inc.

كفى خسارةً للبيانات أمام أدوات الحجب

ابدأ مجانًا. شغّل حاويتك الأولى خلال دقائق.