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

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

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

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

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

आगे दिया गया पूरा require निर्देश (&s) का हस्ताक्षर:

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

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

ga('require', 'ec');

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

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

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

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

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

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

<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 को ऐसे प्लग इन के लिए require निर्देश मिलता है जो अभी तक लोड नहीं हुआ है, तो analytics.js लाइब्रेरी, कमांड लाइन के एक्ज़ीक्यूशन को रोककर इस समस्या का समाधान करती है. प्लग इन लोड होने के बाद, सूची एक्ज़ीक्यूशन हमेशा की तरह जारी रहता है.

इस वजह से, यह बहुत ज़रूरी है कि आप सभी प्लग इन की जांच करके पक्का करें कि वे लोड हो रहे हैं और सही तरीके से चल रहे हैं. अगर कोई प्लग इन लोड नहीं हो पाता या उसमें कोई गड़बड़ी होती है, तो वह बाद के सभी 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 को डीबग करने का तरीका बताया गया है.