ga()
कमांड सूची के साथ आपको Analytics.js लाइब्रेरी के साथ करीब हर काम करने के लिए इंटरफ़ेस मिलता है.
JavaScript ट्रैकिंग स्निपेट, शुरुआती ga()
कमांड सूची फ़ंक्शन के बारे में बताता है, ताकि analytics.js लाइब्रेरी के पूरी तरह लोड होने से पहले भी इसका इस्तेमाल किया जा सके. analytics.js लाइब्रेरी के लोड होते ही, कमांड सूची में मौजूद आइटम उसी क्रम में एक्ज़ीक्यूट हो जाते हैं जिस क्रम में वे मिलते हैं. यह प्रोसेस पूरी होने के बाद, सूची में भेजे गए नए निर्देश तुरंत लागू हो जाते हैं.
ट्रैकिंग स्निपेट को जितना हो सके छोटा रखने के लिए, ga()
कमांड सूची ओवरलोड हो गई है, ताकि कई अलग-अलग फ़ॉर्मैट में तर्क स्वीकार किए जा सकें. इस दस्तावेज़ में उन सभी तरीकों के बारे में बताया गया है जिनसे ga()
कमांड क्यू फ़ंक्शन को शुरू किया जा सकता है.
फ़ंक्शन सिग्नेचर | |
---|---|
ga(command, [...fields], [fieldsObject]) |
|
ga(readyCallback) |
कमांड, analytics.js लाइब्रेरी के पूरी तरह लोड होने के बाद ही एक्ज़ीक्यूट होते हैं, इसलिए कमांड क्यू को फ़ंक्शन पास करने की सबसे आम वजह, analytics.js लाइब्रेरी के लोड और तैयार होने के दौरान, कॉलबैक के तौर पर होती है. |
सूची में निर्देश जोड़ना
ga()
कमांड क्यू फ़ंक्शन को यहां दिए गए फ़ंक्शन सिग्नेचर के साथ शुरू करने से, कमांड, सूची में भेज दिए जाएंगे, ताकि लाइब्रेरी के लोड होने के बाद, उसे एक्ज़ीक्यूट करने के लिए शेड्यूल किया जा सके.
इस्तेमाल का तरीका
ga(command, [...fields], [fieldsObject])
पैरामीटर
नाम | टाइप | ज़रूरी है | ब्यौरा | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
command |
string |
हाँ |
इस आइडेंटिफ़ायर को सूची में जोड़ने के लिए कमांड दिखाया जाता है. आइडेंटिफ़ायर के तीन हिस्से होते हैं (पहले दो हिस्से ज़रूरी नहीं हैं): [trackerName.][pluginName:]methodName
|
|||||||||
...fields |
* |
no | सामान्य फ़ील्ड को फटाफट तय करने के लिए, एक या एक से ज़्यादा सुविधा से जुड़े वैकल्पिक पैरामीटर. इस्तेमाल किए जा रहे कमांड के तरीके के आधार पर, फ़ील्ड की संख्या और अनुमति वाले फ़ील्ड अलग-अलग होते हैं. | |||||||||
fieldsObject |
Object |
no |
किसी भी अगर फ़ील्ड को |
अलग-अलग फ़ील्ड के दस्तावेज़ के लिए, फ़ील्ड रेफ़रंस देखें.
उदाहरण
अलग-अलग निर्देश के उदाहरण देखने के लिए, नीचे कमांड के तरीके सेक्शन देखें.
तैयार कॉलबैक
ga()
कमांड क्यू फ़ंक्शन को शुरू करने से, पास किए गए फ़ंक्शन को सूची में अगले पॉइंट पर चलने के लिए शेड्यूल किया जाएगा.
कमांड, analytics.js लाइब्रेरी के पूरी तरह लोड होने के बाद ही एक्ज़ीक्यूट होते हैं, इसलिए कमांड क्यू को फ़ंक्शन पास करने की सबसे आम वजह, analytics.js लाइब्रेरी के लोड और तैयार होने के दौरान, कॉलबैक के तौर पर होती है.
इस्तेमाल का तरीका
ga(readyCallback)
पैरामीटर
नाम | टाइप | ज़रूरी है | ब्यौरा |
---|---|---|---|
readyCallback |
Function |
हाँ |
लाइब्रेरी के पूरी तरह लोड हो जाने और इंटरैक्ट करने के लिए तैयार होने पर, कॉलबैक फ़ंक्शन को शुरू किया जाना है. फ़ंक्शन को पहले आर्ग्युमेंट के तौर पर, डिफ़ॉल्ट ट्रैकर ऑब्जेक्ट के साथ शुरू किया गया है. अगर कोई डिफ़ॉल्ट ट्रैकर नहीं बनाया गया है, तो पहला आर्ग्युमेंट ध्यान दें: कॉलबैक फ़ंक्शन को शुरू करने पर, सभी
|
उदाहरण
// 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' });
send
Google Analytics को हिट भेजता है.
इस्तेमाल का तरीका
ga('[trackerName.]send', [hitType], [...fields], [fieldsObject]);
भेजे गए फ़ील्ड, ...fields
पैरामीटर और fieldsObject
में दी गई वैल्यू होती हैं. इन्हें ट्रैकर में सेव किए गए फ़ील्ड के साथ मर्ज किया जाता है.
पैरामीटर
...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 });
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' });
provide
यह analytics.js प्लगिन और इसके तरीकों की जानकारी देता है, ताकि ga()
कमांड सूची के साथ इनका इस्तेमाल किया जा सके.
ga('provide', pluginName, pluginConstuctor);
पैरामीटर
नाम | टाइप | ज़रूरी है | ब्यौरा |
---|---|---|---|
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);
remove
ट्रैकर ऑब्जेक्ट को हटाता है.
इस्तेमाल का तरीका
ga('[trackerName.]remove');
उदाहरण
// Remove the default tracker. ga('remove');
// Remove the tracker named "myTracker". ga('myTracker.remove');