قياس نجاح النموذج بدل نقرات الأزرار
النقر على زر الإرسال وإرسال نموذج وإكمال معالجته أحداث مختلفة. قد يلي النقرة خطأ تحقق أو طلب فاشل أو رفض من الخادم. يوفر Stats4U فئات اتصال تلقائية وعمليات إرسال موسومة وأحداثًا صريحة لنجاح النموذج؛ ويحدد الاختيار المعنى الفعلي للتقرير.
- الإرسال
- نتيجة التطبيق
- حدث النجاح
تفعيل القياسات المطلوبة فقط
- فتح العدّاد المملوك عبر عداداتي، ثم فتح لوحة التحكم والأدوات وإجراءات التواصل.
- في إعدادات القياس، تفعيل عد نقرات الهاتف والبريد الإلكتروني والتنزيل تلقائيًا لفئات النقر هذه، أو عد عمليات إرسال النماذج المحددة وعمليات نجاح النماذج المؤكدة لعمليات الإرسال الموسومة والنجاحات المؤكدة.
- اختيار حفظ والتأكد من أن الموقع يستخدم تكامل JavaScript المولّد.
تستخدم فئات الاتصال التلقائية أسماء إجراءات مثل contact-email وcontact-phone وdownload. تصف هذه الأسماء نقرة، لا بريدًا تم تسليمه أو مكالمة تم الرد عليها أو تنزيلًا مكتملًا. لا يرسل الحدث العنوان أو رقم الهاتف أو محتويات حقول النموذج.
وسم إرسال النموذج
إضافة اسم ثابت وغير شخصي للنموذج إلى عنصر النموذج. ينبغي أن يصف الاسم غرضه لا أن يحدد زائرًا. يوسم هذا المثال نموذج اتصال:
<form data-s4u-form="contact">
<!-- Existing form controls and submission handling -->
</form>تُنتج العلامة form-submitted-contact عندما يرسل المتصفح النموذج. لا يثبت ذلك أن الخادم قبله أو عالجه. يجب الاحتفاظ بشيفرة التحقق والمعالجة الحالية؛ فإضافة علامة قياس لا تنفّذ معالجة النموذج.
تأكيد النجاح عند نقطة النجاح الفعلية
في النموذج المخصص، لا تُستدعى دالة النجاح إلا بعد أن يؤكد التطبيق نجاح المعالجة. لا يكفي وحده وصول استجابة HTTP أو النقر على زر أو اكتمال وعد fetch: يجب أن يفسّر التطبيق استجابة خادمه وحالة الخطأ الخاصة به.
if (window.s4u && typeof window.s4u.formSuccess === 'function') {
window.s4u.formSuccess('contact');
}ينتج هذا الاستدعاء form-success-contact عند تفعيل قياس النماذج وتوفر المتتبع. يجب وضعه في فرع النجاح المؤكد الموجود، لا قبل الطلب ولا في معالج اكتمال غير مشروط. يمكن لـ Contact Form 7 استخدام تكامل حدث إرسال البريد الناجح المدعوم؛ أما النموذج العام فيتطلب إشارة نجاح صريحة من التطبيق.
فحص النجاح والفشل معًا
- على تثبيت اختباري مملوك، تجربة إرسال صالح وإرسال يرفضه التطبيق. ينبغي ألا يُرسل حدث النجاح إلا عند نجاح مؤكد.
- استخدام أداة تصحيح القياس للتحقق من قبول فئة الحدث واسمه المتوقعين، دون احتساب حدث فعلي.
- مقارنة أسماء الأحداث الناتجة في التقرير. قد يكون عدد الإرسالات الأكبر من عدد النجاحات إشارة مفيدة، لكنه لا يثبت خطأ محددًا بعينه.
تفحص أداة التصحيح الأهلية، لا نجاح تسليم نموذج فعلي. ينبغي فحص استجابة التطبيق وطلبات المتتبع العادية بصورة منفصلة. يجب عدم إدراج الأسماء ومحتويات النماذج في تسميات الأحداث أو خصائص التشخيص.
الخطوة التالية
فحص دليل التكامل قبل إضافة استدعاء النجاح إلى التطبيق.
فتح دليل التثبيت