מדידת הצלחת טופס במקום לחיצות על כפתורים

לחיצה על כפתור שליחה, שליחת טופס והשלמת העיבוד שלו הם אירועים שונים. אחרי לחיצה יכולות להגיע שגיאת אימות, בקשה שנכשלה או דחייה בשרת. שירות Stats4U מספק קטגוריות יצירת קשר אוטומטיות, שליחות מסומנות ואירועי הצלחת טופס מפורשים; הבחירה קובעת מה הדוח אומר בפועל.

הפעלת המדידות הנדרשות בלבד

1. יש לפתוח את המונה שבבעלות המשתמש דרך המונים שלי, ואז לפתוח את לוח בקרה וכלים ואת פעולות יצירת קשר.
2. במדור הגדרות המדידה, יש להפעיל את ספירה אוטומטית של לחיצות על טלפון, דוא״ל והורדות לקטגוריות הלחיצה האלה, או את ספירת שליחות של טפסים מסומנים והצלחות מאומתות של טפסים לשליחות מסומנות ולהצלחות מאומתות.
3. יש לבחור באפשרות שמירה ולאמת שהאתר משתמש בהטמעת JavaScript שנוצרה.

קטגוריות יצירת קשר אוטומטיות משתמשות בשמות פעולה כגון contact-email, contact-phone ו־download. הן מתארות לחיצה, ולא דוא״ל שנמסר, שיחה שנענתה או הורדה שהושלמה. האירוע אינו שולח את הכתובת, מספר הטלפון או תוכן שדות הטופס.

סימון שליחת טופס

יש להוסיף שם טופס יציב ולא אישי לרכיב הטופס. השם אמור לתאר את מטרתו ולא לזהות מבקר. הדוגמה הזאת מסמנת טופס יצירת קשר:

<form data-s4u-form="contact">
  <!-- Existing form controls and submission handling -->
</form>

הסמן מפיק form-submitted-contact כשהדפדפן שולח את הטופס. הוא אינו מוכיח שהשרת קיבל או עיבד אותו. יש לשמור על קוד האימות והעיבוד הקיים של הטופס; הוספת סמן מדידה אינה מממשת טיפול בטופס.

אישור הצלחה בנקודת ההצלחה בפועל

בטופס מותאם אישית, יש לקרוא לפונקציית ההצלחה רק אחרי שהיישום אישר עיבוד מוצלח. הגעת תשובת HTTP, לחיצה על כפתור או השלמת promise של fetch אינן מספיקות בפני עצמן: היישום חייב לפרש את תשובת השרת ואת מצב השגיאה שלו עצמו.

if (window.s4u && typeof window.s4u.formSuccess === 'function') {
  window.s4u.formSuccess('contact');
}

הקריאה הזאת מפיקה form-success-contact כשמדידת טפסים מופעלת וכלי המעקב זמין. יש לשים אותה בענף ההצלחה המאומתת הקיים, ולא לפני הבקשה ולא במטפל השלמה בלתי מותנה. התוסף Contact Form 7 יכול להשתמש בהטמעת אירוע הדוא״ל המוצלח הנתמכת שלו; טופס כללי דורש אות הצלחה מפורש מהיישום.

בדיקת הצלחה וכישלון גם יחד

1. בהתקנת בדיקה שבבעלות הבודק, יש לנסות שליחה תקינה ושליחה שהיישום דוחה. רק הצלחה מאומתת אמורה לשלוח את אירוע ההצלחה.
2. יש להשתמש בכלי מנפה שגיאות מדידה כדי לבדוק אם קטגוריית האירוע ושמו הצפויים יתקבלו, בלי לספור אירוע אמיתי.
3. יש להשוות את שמות האירועים שמתקבלים בדוח. מספר שליחות שגדול ממספר ההצלחות יכול להיות סימן שימושי, אבל אינו הוכחה לשגיאה מסוימת אחת.

מנפה השגיאות בודק זכאות, ולא מסירה מוצלחת של טופס אמיתי. יש לבדוק בנפרד את תשובת היישום ואת בקשות כלי המעקב הרגילות. יש להשאיר שמות ותוכן טפסים מחוץ לתוויות אירועים ולמאפייני אבחון.

השלב הבא

יש לבדוק את מדריך ההטמעה לפני הוספת קריאת ההצלחה ליישום.

לפתיחת מדריך ההטמעה