ga कमांड सूची रेफ़रंस

ga() कमांड सूची के साथ आपको Analytics.js लाइब्रेरी के साथ करीब हर काम करने के लिए इंटरफ़ेस मिलता है.

JavaScript ट्रैकिंग स्निपेट, शुरुआती ga() कमांड सूची फ़ंक्शन के बारे में बताता है, ताकि analytics.js लाइब्रेरी के पूरी तरह लोड होने से पहले भी इसका इस्तेमाल किया जा सके. analytics.js लाइब्रेरी के लोड होते ही, कमांड सूची में मौजूद आइटम उसी क्रम में एक्ज़ीक्यूट हो जाते हैं जिस क्रम में वे मिलते हैं. यह प्रोसेस पूरी होने के बाद, सूची में भेजे गए नए निर्देश तुरंत लागू हो जाते हैं.

ध्यान दें: JavaScript ट्रैकिंग स्निपेट की मदद से, ga() कमांड क्यू फ़ंक्शन का नाम बदला जा सकता है. अगर ऐसा किया जाता है, तो पक्का करें कि इस साइट से कॉपी किए गए कोड में नए नाम का इस्तेमाल किया गया हो.

ट्रैकिंग स्निपेट को जितना हो सके छोटा रखने के लिए, ga() कमांड सूची ओवरलोड हो गई है, ताकि कई अलग-अलग फ़ॉर्मैट में तर्क स्वीकार किए जा सकें. इस दस्तावेज़ में उन सभी तरीकों के बारे में बताया गया है जिनसे ga() कमांड क्यू फ़ंक्शन को शुरू किया जा सकता है.

फ़ंक्शन सिग्नेचर
ga(command, [...fields], [fieldsObject])	ga() कमांड क्यू फ़ंक्शन को यहां दिए गए फ़ंक्शन सिग्नेचर के साथ शुरू करने से, कमांड, सूची में भेज दिए जाएंगे, ताकि लाइब्रेरी के लोड होने के बाद, उसे एक्ज़ीक्यूट करने के लिए शेड्यूल किया जा सके.
ga(readyCallback)	ga() कमांड क्यू फ़ंक्शन को शुरू करने से, पास किए गए फ़ंक्शन को सूची में अगले पॉइंट पर चलने के लिए शेड्यूल किया जाएगा. कमांड, analytics.js लाइब्रेरी के पूरी तरह लोड होने के बाद ही एक्ज़ीक्यूट होते हैं, इसलिए कमांड क्यू को फ़ंक्शन पास करने की सबसे आम वजह, analytics.js लाइब्रेरी के लोड और तैयार होने के दौरान, कॉलबैक के तौर पर होती है.

सूची में निर्देश जोड़ना

ga() कमांड क्यू फ़ंक्शन को यहां दिए गए फ़ंक्शन सिग्नेचर के साथ शुरू करने से, कमांड, सूची में भेज दिए जाएंगे, ताकि लाइब्रेरी के लोड होने के बाद, उसे एक्ज़ीक्यूट करने के लिए शेड्यूल किया जा सके.

इस्तेमाल का तरीका

ga(command, [...fields], [fieldsObject])

पैरामीटर

नाम	टाइप	ज़रूरी है	ब्यौरा
command	string	हाँ	इस आइडेंटिफ़ायर को सूची में जोड़ने के लिए कमांड दिखाया जाता है. आइडेंटिफ़ायर के तीन हिस्से होते हैं (पहले दो हिस्से ज़रूरी नहीं हैं): [trackerName.][pluginName:]methodName trackerName शेड्यूल किए गए निर्देश को शुरू करने के लिए ट्रैकर का नाम. अगर ट्रैकर का कोई नाम नहीं दिया गया है, तो डिफ़ॉल्ट ट्रैकर पर निर्देश लागू किया जाता है. pluginName ज़रूरी analytics.js प्लगिन का नाम. अगर pluginName दिया गया है, तो methodName, प्लगिन से मिला तरीका होना चाहिए. methodName निष्पादन के लिए शेड्यूल किए जाने वाले तरीके का नाम. किसी प्लगिन का नाम तय नहीं करने पर, यह तरीका नीचे दिए गए कमांड के तरीकों में से एक होना चाहिए.
...fields	*	no	सामान्य फ़ील्ड को फटाफट तय करने के लिए, एक या एक से ज़्यादा सुविधा से जुड़े वैकल्पिक पैरामीटर. इस्तेमाल किए जा रहे कमांड के तरीके के आधार पर, फ़ील्ड की संख्या और अनुमति वाले फ़ील्ड अलग-अलग होते हैं.
fieldsObject	Object	no	किसी भी fields पैरामीटर में तय न की गई बाकी वैल्यू के बारे में बताने वाला ऑब्जेक्ट. अगर फ़ील्ड को fields पैरामीटर और fieldsObject, दोनों में सेट किया गया है, तो fieldsObject की वैल्यू का इस्तेमाल किया जाएगा.

अलग-अलग फ़ील्ड के दस्तावेज़ के लिए, फ़ील्ड रेफ़रंस देखें.

उदाहरण

अलग-अलग निर्देश के उदाहरण देखने के लिए, नीचे कमांड के तरीके सेक्शन देखें.

तैयार कॉलबैक

ga() कमांड क्यू फ़ंक्शन को शुरू करने से, पास किए गए फ़ंक्शन को सूची में अगले पॉइंट पर चलने के लिए शेड्यूल किया जाएगा.

कमांड, analytics.js लाइब्रेरी के पूरी तरह लोड होने के बाद ही एक्ज़ीक्यूट होते हैं, इसलिए कमांड क्यू को फ़ंक्शन पास करने की सबसे आम वजह, analytics.js लाइब्रेरी के लोड और तैयार होने के दौरान, कॉलबैक के तौर पर होती है.

इस्तेमाल का तरीका

ga(readyCallback)

पैरामीटर

नाम	टाइप	ज़रूरी है	ब्यौरा
readyCallback	Function	हाँ	लाइब्रेरी के पूरी तरह लोड हो जाने और इंटरैक्ट करने के लिए तैयार होने पर, कॉलबैक फ़ंक्शन को शुरू किया जाना है. फ़ंक्शन को पहले आर्ग्युमेंट के तौर पर, डिफ़ॉल्ट ट्रैकर ऑब्जेक्ट के साथ शुरू किया गया है. अगर कोई डिफ़ॉल्ट ट्रैकर नहीं बनाया गया है, तो पहला आर्ग्युमेंट undefined है. ध्यान दें: कॉलबैक फ़ंक्शन को शुरू करने पर, सभी ga ऑब्जेक्ट तरीकों का इस्तेमाल किया जा सकता है.

उदाहरण

// Queues a tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto');

// Once the tracker has been created, log the
// client ID to the console.
ga(function(tracker) {
  console.log(tracker.get('clientId'));
});

// Queues a named tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

// When there is no default tracker, the first
// argument of the ready callback is `undefined`.
ga(function(tracker) {
  console.log(tracker); // Logs `undefined`.
});

निर्देश देने के तरीके की जानकारी

नीचे उन सभी तरीकों की सूची दी गई है जिन्हें ga() कमांड सूची में भेजा जा सकता है. इनमें प्लगिन के तरीके शामिल नहीं हैं.

create

दिए गए फ़ील्ड के साथ एक नया ट्रैकर इंस्टेंस बनाता है.

इस्तेमाल का तरीका

ga('create', [trackingId], [cookieDomain], [name], [fieldsObject]);

पैरामीटर

अलग-अलग फ़ील्ड के दस्तावेज़ के लिए, फ़ील्ड रेफ़रंस देखें.

रिटर्न

undefined

उदाहरण

// Creates a default tracker for the Property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga('create', 'UA-XXXXX-Y', 'auto');

// Creates a tracker with the name "myTracker" for the Property
// UA-XXXXX-Y, sets the cookieDomain to "example.com", and specifies
// a transport mechanism of "beacon".
ga('create', 'UA-XXXXX-Y', 'example.com', 'myTracker', {
  transport: 'beacon'
});

अहम जानकारी: 'कॉल करें' के तरीके वाले हिस्से में, ट्रैकर का नाम नहीं बताया जा सकता. उदाहरण के लिए, ga('myTracker.create', 'UA-XXXXX-Y`) काम नहीं करता.

ट्रैकर बनाने के बारे में ज़्यादा जानकारी के लिए, ट्रैकर बनाने से जुड़ी गाइड पढ़ें.

---

send

Google Analytics को हिट भेजता है.

इस्तेमाल का तरीका

ga('[trackerName.]send', [hitType], [...fields], [fieldsObject]);

भेजे गए फ़ील्ड, ...fields पैरामीटर और fieldsObject में दी गई वैल्यू होती हैं. इन्हें ट्रैकर में सेव किए गए फ़ील्ड के साथ मर्ज किया जाता है.

ध्यान दें: ...fields और fieldsObject में दी गई वैल्यू, मौजूदा हिट के साथ भेजी जाती हैं, लेकिन उन्हें ट्रैकर ऑब्जेक्ट में स्टोर नहीं किया जाता. ट्रैकर को अपडेट करने के लिए, set तरीके का इस्तेमाल करें.

पैरामीटर

...fields पैरामीटर से तय किए जा सकने वाले फ़ील्ड, हिट टाइप के आधार पर अलग-अलग होते हैं. नीचे दी गई टेबल में, हर हिट टाइप से जुड़े फ़ील्ड की सूची दी गई है. सूची में नहीं दिए गए हिट टाइप ...fields पैरामीटर को स्वीकार नहीं करते हैं. सिर्फ़ fieldsObject को स्वीकार किया जाता है.

हिट टाइप	...fields
pageview	page
event	eventCategory, eventAction, eventLabel, eventValue
social	socialNetwork, socialAction, socialTarget
timing	timingCategory, timingVar, timingValue, timingLabel

अलग-अलग फ़ील्ड के दस्तावेज़ के लिए, फ़ील्ड रेफ़रंस देखें.

रिटर्न

undefined

उदाहरण

// Sends a pageview hit.
ga('send', 'pageview');

// Sends an event hit for the tracker named "myTracker" with the
// following category, action, and label, and sets the nonInteraction
// field value to true.
ga('send', 'event', 'link', 'click', 'http://example.com', {
  nonInteraction: true
});

हिट भेजने के बारे में ज़्यादा जानकारी के लिए, Google Analytics को डेटा भेजना गाइड पढ़ें.

---

set

ट्रैकर ऑब्जेक्ट पर, एक फ़ील्ड और वैल्यू पेयर या फ़ील्ड/वैल्यू पेयर का ग्रुप सेट करता है.

इस्तेमाल का तरीका

// Sets a single field and value.
ga('[trackerName.]set', fieldName, fieldValue);

// Sets a group of field/value pairs.
ga('[trackerName.]set', fieldsObject);

पैरामीटर

अलग-अलग फ़ील्ड के दस्तावेज़ के लिए, फ़ील्ड रेफ़रंस देखें.

रिटर्न

undefined

उदाहरण

// Sets the page field to "/about.html".
ga('set', 'page', '/about.html');

// Sets the page field to "/about.html" and the title to "About".
ga('set', {
  page: '/about.html',
  title: 'About'
});

ट्रैकर अपडेट करने के बारे में ज़्यादा जानकारी के लिए, ट्रैकर डेटा पाने और सेट करने से जुड़ी गाइड पढ़ें.

---

require

analytics.js प्लगिन की ज़रूरत होती है.

इस्तेमाल का तरीका

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

पैरामीटर

नाम	टाइप	ज़रूरी है	ब्यौरा
pluginName	string	हाँ	प्लग इन का नाम डालना ज़रूरी है. ध्यान दें: अगर प्लगिन, आधिकारिक analytics.js प्लगिन नहीं है, तो उसे पेज पर कहीं और उपलब्ध होना चाहिए.
pluginOptions	Object	no	एक इनिशलाइज़ेशन ऑब्जेक्ट, जिसे इंस्टैंशिएट होने पर प्लगिन कंस्ट्रक्टर को पास किया जाएगा.

रिटर्न

undefined

उदाहरण

// Requires the Enhanced Ecommerce plugin.
ga('require', 'ec');

// Requires the Advertising Features plugin
// named "myTracker" and override its default cookie name.
ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

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

---

provide

यह analytics.js प्लगिन और इसके तरीकों की जानकारी देता है, ताकि ga() कमांड सूची के साथ इनका इस्तेमाल किया जा सके.

ga('provide', pluginName, pluginConstuctor);

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

पैरामीटर

नाम	टाइप	ज़रूरी है	ब्यौरा
pluginName	string	हाँ	दिए जा रहे प्लगिन का नाम. इस्तेमाल किया गया नाम वही होना चाहिए जो require कॉल के लिए इस्तेमाल किया गया हो.
pluginConstuctor	Function	हाँ	कंस्ट्रक्टर फ़ंक्शन, प्लगिन के सभी लॉजिक और तरीके उपलब्ध कराता है. इस कंस्ट्रक्टर को require तरीके में बताए गए pluginsOptions ऑब्जेक्ट के साथ शुरू किया जाएगा.

उदाहरण

// Defines a plugin constructor
function MyPlugin(tracker, options) {
  // ...
}

// Provides the plugin for use with the ga() command queue.
ga('provide', 'myplugin', MyPlugin);

analytics.js प्लगिन उपलब्ध कराने के बारे में ज़्यादा जानकारी के लिए, राइटिंग प्लगिन गाइड पढ़ें.

---

remove

ट्रैकर ऑब्जेक्ट को हटाता है.

इस्तेमाल का तरीका

ga('[trackerName.]remove');

उदाहरण

// Remove the default tracker.
ga('remove');

// Remove the  tracker named "myTracker".
ga('myTracker.remove');