عدّ ما يفعله الزوّار
يخبرك العدّاد بعدد من زاروا موقعك، وتخبرك الأحداث بما فعلوه: ضغطوا زر التواصل، أو نزّلوا الدليل، أو أرسلوا النموذج. يُحصى فقط عدد المرات، ولا يُعرف أبدًا من فعلها.
1. ضع علامة على عنصر
أضف السمة data-s4u-event إلى أي رابط أو زر. يُحتسب كل نقر عليه تحت هذا الاسم.
<a href="/contact" data-s4u-event="contact">Contact</a>
<button data-s4u-event="guide-downloaded">Download</button>2. أو استدعِه من سكربت
حيث لا يوجد نقر يمكن التقاطه، مثل نموذج أُرسل أو فيديو وصل إلى نهايته، استدعِ الدالة بنفسك:
<script>
s4u.event('form-sent');
</script>3. أو احتسب كل رابط تلقائيًا
فعّل الخيار “عد نقرات الروابط أيضًا” في إعدادات عدّادك (أثناء الإعداد أو لاحقًا في لوحة المالك في صفحة الإحصائيات الخاصة به). عندها يُحتسب كل نقر على رابط بحسب وجهته لا بحسب نص الرابط: صفحات موقعك بمسارها، والروابط إلى مواقع أخرى بنطاقها. أما العنصر الذي يحمل data-s4u-event بنفسه فيُحتسب مرة واحدة تحت الاسم الذي أعطيته له.
قواعد الأسماء
تُكتب الأسماء بأحرف لاتينية صغيرة وتتكون فقط من a–z و0–9 والشرطة والشرطة السفلية، بحد أقصى 32 حرفًا؛ وأي شيء آخر يتحول إلى شرطة. يمكن للعدّاد الواحد أن يحمل من الأسماء المختلفة 100 كحد أقصى. ويمكن للاحتساب التلقائي للروابط أن يستخدم منها حتى 70، ويبقى الباقي للأسماء التي تضعها بنفسك. وعند بلوغ الحد تستمر الأسماء الموجودة في العدّ ولا تُضاف أسماء جديدة. ويمكن لعنوان واحد أن يرسل من الأحداث 300 في الساعة كحد أقصى.
ما لا يجوز أن يكون في الاسم
يظهر الاسم في صفحة الإحصائيات العامة. لا تكتب فيه أي شيء يدل على شخص: لا اسمًا ولا عنوان بريد إلكتروني ولا رقم هاتف ولا رقم طلب أو عميل ولا رمزًا مميّزًا. تُرفض تلقائيًا الأسماء التي تحتوي على @ أو سلسلة طويلة من الأرقام أو رمز طويل يبدو عشوائيًا. أما الاسم العادي مثل “jan-kowalski” فلا يمكن التعرف عليه وسيُحفظ، لذلك لا تكوّن الأسماء أبدًا مما كتبه الزائر.
ما الذي يُخزَّن
سطر واحد لكل عدّاد ويوم واسم، ومعه رقم. لا زائر ولا عنوان ولا ترتيب للنقرات. من “contact: 14” يستحيل معرفة من نقر.
أين تراه
في صفحة إحصائيات عدّادك، في قسم الصفحات: البطاقة “ما فعله الزوار”، مع المسار عبر الزمن، وعند توفر بيانات كافية، الأحداث التي ارتفعت أو انخفضت مقارنة بالفترة السابقة.
عدّة عدّادات في صفحة واحدة
افتراضيًا يتبع الحدث أول عدّاد في الصفحة. لاختيار عدّاد آخر أضف رقمه: data-s4u-id="12345" على العنصر، أو s4u.event('name', '12345') في السكربت.
تحليلات الموقع
لا تُجرى القياسات إلا للميزات التي تفعّلها. يؤدي حفظ الإعدادات المعطلة إلى وقف جمع البيانات في المستقبل.
الملاحظات خاصة افتراضيًا. تظهر الملاحظات العامة لكل من يستطيع الاطلاع على الإحصاءات.
استخدم تسميات قصيرة للحملات دون أسماء أو عناوين بريد إلكتروني أو معرّفات عملاء. قيم الحملات محدودة؛ وتُتجاهل القيم غير المعروفة.
اختر من خطوتين إلى ثماني خطوات. استخدم page:/contact أو event:contact، واحدة في كل سطر. يجب أن تحدث الخطوات بالترتيب خلال زيارة واحدة؛ ويمكن أن تحدث أنشطة أخرى بينها. تنتهي الزيارة بعد ثلاثين دقيقة من عدم النشاط أو عند انتهاء اليوم. تحصي التقارير الزيارات، لا عدد الأشخاص الفريدين.
لا تُحصى إلا فئات الإجراءات وأسماؤها. لا تُرسل أرقام الهواتف أو عناوين البريد الإلكتروني أو قيم حقول النماذج. إرسال النموذج لا يثبت نجاحه. أكّد النجاح باستخدام s4u.formSuccess('contact') أو تكامل نماذج WordPress مدعوم.
<form data-s4u-form="contact">…</form>
s4u.formSuccess('contact');المبيعات
اربط المتجر باستخدام رقم عداده ومفتاحه السري. أبلغ فقط عن المدفوعات والمبالغ المستردة المؤكدة. صافي المبيعات هو المبالغ المدفوعة مطروحًا منها المبالغ المستردة؛ ولا تغير عمليات استرداد الأموال عدد الطلبات المدفوعة.
لوحة معلوماتي
اختيار التقارير الظاهرة وترتيبها. لا تُحمّل البطاقات المخفية. الترتيب خاص بالمالك؛ ويستخدم القراء الترتيب القياسي.
طرق العرض المحفوظة
حفظ الفترة الحالية والمرشحات المدعومة لزيارة لاحقة. لا يرى العروض المحفوظة إلا المالك. تتحرك الفترات النسبية مع التاريخ، بينما تبقى تواريخ البداية والنهاية المخصصة ثابتة.
مجموعات الصفحات
تجميع الصفحات المرتبطة، مثل /blog/* للمدونة. تطابق * النهائية المسارات التي تبدأ بتلك البادئة. يتاح حتى عشر مجموعات، لكل منها ثماني قواعد. وقد تتداخل المجموعات، فلا تُجمع أعداد زوارها.
تستخدم مشاهدات الصفحات الإجماليات المحفوظة المتاحة، وقد تتضمن بوتات وفق إعداد العداد. يبدأ تسجيل زوار المجموعة وأهدافها عند إنشائها. ويُحتسب الزوار مرة لكل مجموعة يوميًا، لا مرة عبر الفترة كلها.
خصائص الأحداث
حدّد ما يصل إلى عشرة أسماء للخصائص وما يصل إلى عشرين قيمة مسموحًا بها لكل خاصية قبل إرسالها. استخدم فئات ثابتة مثل plan=basic، ولا تستخدم أبدًا أسماء الأشخاص أو عناوين البريد الإلكتروني أو أرقام الطلبات أو مدخلات النماذج. تُحتسب كل خاصية بشكل منفصل؛ ولا تُستنتج تركيبات الخصائص.
يُقبل ما لا يزيد على خمس خصائص لكل حدث و500 تركيبة حدث/خاصية/قيمة لكل عداد في اليوم.
Core Web Vitals
يقيس التحميل (LCP)، والاستجابة للتفاعلات (INP)، وتغيرات التخطيط (CLS) في المتصفحات التي تدعم ذلك. غياب القياسات لا يعني أنها صفر. لا يُبلّغ عن INP دون تفاعل. تبدأ القياسات بعد التفعيل.
تُقدّر قيمة المئين 75 من فئات محدودة للمدرج التكراري. يُحتفظ بما يصل إلى 100 تركيبة صفحة/جهاز لكل عداد في اليوم. تعني القيم في الفئة الأخيرة أنها لا تقل عن تلك القيمة. لا تشمل قياسات المتصفح جميع أنشطة iframe ذات المصادر المختلفة، وليست مطابقة لبيانات CrUX من Google.
تفعيل القياس الاختياري لمؤشرات Web Vitals
تقرير إحصاءات الموقع الإلكتروني
اختر الفترة والبطاقات، ثم استخدم مربع حوار الطباعة في متصفحك للطباعة أو لحفظ PDF. تُدرج الملاحظات الخاصة بالمالك فقط عند الفتح باستخدام مفتاح المالك.
لوحة التحكم والأدوات
اربط عدادك باستخدام مفتاح المالك. يمكنك أيضًا لصق رابط الإدارة كاملًا. تُحفظ العدادات المرتبطة طوال جلسة المتصفح هذه؛ ويؤدي تغيير مفتاح المالك إلى إلغاء الوصول.
التقارير المجدولة
اختر عرضًا محفوظًا وإرسالًا أسبوعيًا أو شهريًا إلى عنوان البريد الإلكتروني المؤكد للمالك. تُستخدم المرشحات والتقارير المختارة مجددًا، ويغطي التقرير الأسبوع أو الشهر الكامل السابق وفقًا للمنطقة الزمنية للعداد. لا تُضمَّن الملاحظات الخاصة. لن تُرسل أي رسالة حتى تُفعّل جدول الإرسال.
تضمين بطاقة إحصاءات
اختر تقريرًا واحدًا ومرشحاته. يستخدم iframe الذي يتم إنشاؤه مفتاحًا منفصلًا للقراءة فقط، وتنتهي صلاحيته في التاريخ المختار، ويمكنك إلغاءه هنا. لا تُضمَّن الملاحظات الخاصة أو إجراءات المالك أبدًا.
API للإحصاءات
أنشئ مفتاح API منفصلًا للقراءة فقط مع تحديد التقارير المتاحة. أرسله في ترويسة Authorization: Bearer؛ ولا تستخدم مفتاح المالك في البرامج النصية أبدًا. يمكن إلغاء مفاتيح API، ولها تاريخ انتهاء صلاحية. يحتوي JSON وCSV على بيانات مجمعة فقط.
يغطي التصدير 400 يوم و500 صف كحد أقصى لكل تقرير. أعداد الزوار والزوار الذين حققوا الأهداف هي مجاميع يومية؛ ولا يجوز جمع أعداد المجموعات المتداخلة. تستخدم الرتب المئينية لمقاييس Web Vitals تقديرات من المدرج التكراري وتتطلب عددًا كافيًا من العينات.