बटन क्लिक के बजाय फ़ॉर्म की सफलता मापना

सबमिट बटन पर क्लिक करना, फ़ॉर्म जमा करना और उसकी प्रक्रिया पूरी होना अलग-अलग इवेंट हैं। क्लिक के बाद सत्यापन त्रुटि, विफल अनुरोध या सर्वर की अस्वीकृति हो सकती है। Stats4U स्वचालित संपर्क श्रेणियाँ, चिह्नित सबमिशन और स्पष्ट फ़ॉर्म-सफलता इवेंट देता है; चुनाव तय करता है कि रिपोर्ट का वास्तविक अर्थ क्या है।

सबमिशन
एप्लिकेशन का परिणाम
सफलता इवेंट

केवल आवश्यक मापन चालू करना

मेरे काउंटर से स्वामित्व वाला काउंटर खोलना, फिर डैशबोर्ड और टूल और संपर्क कार्रवाइयाँ खोलना।
मापन की सेटिंग में इन क्लिक श्रेणियों के लिए फ़ोन, ईमेल और डाउनलोड क्लिक अपने-आप गिनें या चिह्नित सबमिशन और पुष्टि की गई सफलता के लिए चिह्नित फ़ॉर्म सबमिशन और पुष्ट फ़ॉर्म सफलताएँ गिनें चालू करना।
सहेजें चुनना और यह जाँचना कि वेबसाइट तैयार JavaScript एकीकरण का उपयोग करती है।

स्वचालित संपर्क श्रेणियाँ contact-email, contact-phone और download जैसे क्रिया नाम इस्तेमाल करती हैं। ये क्लिक बताते हैं, ईमेल पहुँचने, कॉल का उत्तर मिलने या डाउनलोड पूरा होने की पुष्टि नहीं करते। इवेंट पता, फ़ोन नंबर या फ़ॉर्म फ़ील्ड की सामग्री नहीं भेजता।

फ़ॉर्म सबमिशन को चिह्नित करना

फ़ॉर्म तत्व में स्थिर और गैर-व्यक्तिगत फ़ॉर्म नाम जोड़ा जाता है। नाम का उद्देश्य उपयोग बताना होना चाहिए, किसी आगंतुक की पहचान करना नहीं। यह उदाहरण संपर्क फ़ॉर्म को चिह्नित करता है:

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

ब्राउज़र के फ़ॉर्म जमा करने पर चिह्न form-submitted-contact उत्पन्न करता है। यह सर्वर द्वारा उसे स्वीकार या संसाधित किए जाने का प्रमाण नहीं है। फ़ॉर्म का मौजूदा सत्यापन और प्रोसेसिंग कोड बनाए रखना चाहिए; मापन चिह्न जोड़ने से फ़ॉर्म संभालने की प्रक्रिया लागू नहीं होती।

वास्तविक सफलता बिंदु पर सफलता की पुष्टि

कस्टम फ़ॉर्म में सफलता फ़ंक्शन केवल तब कॉल होना चाहिए जब एप्लिकेशन सफल प्रोसेसिंग की पुष्टि कर चुका हो। HTTP प्रतिक्रिया आना, बटन क्लिक या fetch promise का पूरा होना अपने आप पर्याप्त नहीं है: एप्लिकेशन को अपनी सर्वर प्रतिक्रिया और त्रुटि स्थिति का अर्थ समझना पड़ता है।

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

फ़ॉर्म मापन चालू हो और ट्रैकर उपलब्ध हो तो यह कॉल form-success-contact उत्पन्न करती है। इसे मौजूदा पुष्टि की गई सफलता वाली शाखा में रखना चाहिए, अनुरोध से पहले या बिना शर्त चलने वाले पूर्णता हैंडलर में नहीं। Contact Form 7 अपना समर्थित सफल मेल इवेंट एकीकरण इस्तेमाल कर सकता है; सामान्य फ़ॉर्म के लिए स्पष्ट एप्लिकेशन-सफलता संकेत ज़रूरी है।

सफलता और विफलता दोनों की जाँच

स्वामित्व वाली परीक्षण स्थापना पर वैध सबमिशन और एप्लिकेशन द्वारा अस्वीकृत सबमिशन आज़माना। केवल पुष्टि की गई सफलता पर सफलता इवेंट भेजा जाना चाहिए।
वास्तविक इवेंट गिने बिना यह जाँचने के लिए मापन डीबगर का उपयोग करना कि अपेक्षित इवेंट श्रेणी और नाम स्वीकार होंगे या नहीं।
रिपोर्ट में मिले इवेंट नामों की तुलना करना। सबमिशन संख्या सफलता संख्या से बड़ी हो तो उपयोगी संकेत मिल सकता है, लेकिन इससे किसी एक विशेष त्रुटि का प्रमाण नहीं मिलता।

डिबगर स्वीकार्यता जाँचता है, वास्तविक फ़ॉर्म की सफल डिलीवरी नहीं। एप्लिकेशन प्रतिक्रिया और सामान्य ट्रैकर अनुरोध अलग-अलग जाँचे जाने चाहिए। इवेंट लेबल और निदान प्रॉपर्टी में नाम और फ़ॉर्म सामग्री शामिल नहीं होनी चाहिए।

अगला कदम

एप्लिकेशन में सफलता कॉल जोड़ने से पहले एकीकरण मार्गदर्शिका की जाँच करना।

स्थापना मार्गदर्शिका खोलना