प्लगिन का इस्तेमाल करना

प्लग इन, ऐसी स्क्रिप्ट होते हैं जो उपयोगकर्ता इंटरैक्शन को मेज़र करने में मदद करने के लिए, analytics.js की सुविधा को बेहतर बनाते हैं. आम तौर पर, प्लग इन सुविधाओं के एक ऐसे सेट के लिए होते हैं जो Google Analytics के सभी उपयोगकर्ताओं को ज़रूरी नहीं होते, जैसे कि ecommerce या क्रॉस-डोमेन मेज़रमेंट. इसलिए, वे डिफ़ॉल्ट रूप से analytics.js में शामिल नहीं होते.

इस गाइड में analytics.js प्लगिन की ज़रूरत और उनका इस्तेमाल करने के तरीके के बारे में बताया गया है.

प्लग इन की ज़रूरत पड़ रही है

require कमांड, प्लगिन का नाम लेता है और उसे ga() कमांड सूची के साथ इस्तेमाल करने के लिए रजिस्टर कर देता है. अगर प्लगिन, कॉन्फ़िगरेशन के विकल्प स्वीकार करता है, तो उन विकल्पों को require कमांड को आखिरी तर्क के तौर पर भेजा जा सकता है.

यह require कमांड का पूरा हस्ताक्षर है:

ga('[trackerName.]require', pluginName, [pluginOptions]);

उदाहरण के लिए, यहां बताया गया है कि डिफ़ॉल्ट ट्रैकर के साथ इस्तेमाल करने के लिए, आपको बेहतर ई-कॉमर्स प्लगिन की ज़रूरत कैसे होगी:

ga('require', 'ec');

यहां बताया गया है कि आपको "myTracker" नाम के ट्रैकर के लिए विज्ञापन सुविधाएं प्लगिन की ज़रूरत कैसे होगी. साथ ही, आपको कुकी के नाम की डिफ़ॉल्ट वैल्यू को बदलने वाला कॉन्फ़िगरेशन विकल्प पास करना होगा:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

प्लगिन कोड लोड हो रहा है

require कमांड, प्लगिन के तरीकों को ga() कमांड सूची के साथ इस्तेमाल करने के लिए शुरू करता है. हालांकि, यह प्लगिन स्क्रिप्ट को लोड नहीं करता. अगर किसी तीसरे पक्ष के प्लगिन का इस्तेमाल किया जा रहा है या खुद कोई प्लगिन लिखा जा रहा है, तो आपको पेज पर मैन्युअल तरीके से प्लग इन कोड जोड़ना होगा.

हमारा सुझाव है कि पेज पर प्लगिन कोड जोड़ने के लिए, async एट्रिब्यूट वाले <script> टैग का इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि आपकी साइट पर मौजूद अन्य सुविधाएं लोड होने से न रोकें.

नीचे दिए गए कोड के लिए, एक काल्पनिक लिंक ट्रैकिंग प्लगिन की ज़रूरत होती है और उसे लोड करता है:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

ध्यान दें: analytics.js के लिए आधिकारिक Google Analytics प्लगिन, ज़रूरत पड़ने पर अपने-आप लोड हो जाते हैं. आपको उनके लिए स्क्रिप्ट टैग जोड़ने की ज़रूरत नहीं होती. आधिकारिक analytics.js प्लग इन की पूरी सूची बाईं ओर नेविगेशन में आधिकारिक प्लग इन सेक्शन में देखी जा सकती है.

प्लग इन के लोड होने का इंतज़ार किया जा रहा है

analytics.js लाइब्रेरी और analytics.js प्लगिन, दोनों को एसिंक्रोनस तरीके से लोड किया जाता है. इसलिए, यह पता लगाना मुश्किल हो सकता है कि प्लगिन कब पूरी तरह से लोड होंगे और कब इस्तेमाल के लिए तैयार होंगे.

analytics.js लाइब्रेरी इस समस्या को हल करने के लिए, कमांड सूची को एक्ज़ीक्यूट करने से रोक देती है. ऐसा तब होता है, जब किसी ऐसे प्लगिन के लिए require कमांड मिलता है जो अब तक लोड नहीं हुआ है. प्लगिन के लोड होने के बाद, सूची का एक्ज़ीक्यूशन पहले की तरह जारी रहता है.

इस वजह से, यह बेहद ज़रूरी है कि इस्तेमाल किए जा रहे प्लग इन की जांच कर ली जाए, ताकि यह पक्का किया जा सके कि वे सही तरीके से लोड हों और काम करें. अगर कोई प्लग इन लोड नहीं हो पाता है या उसमें कोई गड़बड़ी होती है, तो वह बाद के सभी analytics.js कमांड को लागू नहीं कर पाएगा.

कॉल करने के लिए प्लगिन के तरीके

प्लगिन की ज़रूरत होने के बाद, ga() कमांड सूची के साथ इस्तेमाल करने के लिए इसका तरीका उपलब्ध हो जाता है. प्लगिन के तरीकों को कॉल करने के लिए, यहां दिया गया कमांड सिग्नेचर है:

ga('[trackerName.][pluginName:]methodName', ...args);

उदाहरण के लिए, बेहतर ई-कॉमर्स प्लगिन के addProduct तरीके को इस तरह से कॉल किया जा सकता है:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

इसके अलावा, नाम वाले ट्रैकर पर कमांड स्ट्रिंग में ट्रैकर का नाम जोड़कर:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

अगले चरण

अगर आपने इस सेक्शन में दी गई सभी गाइड पढ़ ली हैं, तो आपको analytics.js की ज़्यादातर सुविधाओं के बारे में पता होना चाहिए. अगली गाइड में बताया गया है कि अपने analytics.js को लागू करने के तरीके को कैसे डीबग करें, ताकि गड़बड़ियों का ज़्यादा आसानी से पता लगाया जा सके और यह देखा जा सके कि आपका कोड क्या कर रहा है.