लिंकर प्लग इन, क्रॉस-डोमेन मेज़रमेंट को लागू करने की प्रोसेस को आसान बनाता है, जैसा कि analytics.js के लिए क्रॉस-डोमेन मेज़रमेंट गाइड में बताया गया है.
खास जानकारी
क्रॉस-डोमेन मेज़रमेंट, सोर्स डोमेन और डेस्टिनेशन डोमेन के बीच एक यूनीक क्लाइंट आईडी शेयर करके काम करता है. यह दो चरणों वाली प्रोसेस है:
- सोर्स डोमेन को यह पक्का करना होता है कि डेस्टिनेशन डोमेन पर ले जाने वाले सभी यूआरएल में, सोर्स डोमेन का क्लाइंट आईडी शामिल हो.
- जब कोई उपयोगकर्ता डेस्टिनेशन डोमेन पर जाता है, तो उसके यूआरएल में क्लाइंट आईडी की मौजूदगी की जांच करने के लिए, डेस्टिनेशन डोमेन की जानकारी होना ज़रूरी है.
लिंकर प्लग इन ऐसा करने के लिए, उन यूआरएल में एक linker पैरामीटर जोड़ देता है, जो डेस्टिनेशन डोमेन पर ले जाते हैं. लिंकर पैरामीटर में क्लाइंट आईडी के साथ-साथ मौजूदा टाइमस्टैंप और कोड में बदला गया ब्राउज़र मेटाडेटा भी शामिल होता है. टाइमस्टैंप और मेटाडेटा का इस्तेमाल, यूआरएल शेयर करने से जुड़ी समस्याओं से बचने के लिए किया जाता है.
लिंकर पैरामीटर कुछ ऐसा दिखेगा:
_ga=1.199239214.1624002396.1440697407
डेस्टिनेशन डोमेन पर, allowLinker फ़ील्ड दिया जाता है. यह तब होता है, जब true analytics.js को यूआरएल में लिंकर पैरामीटर की जांच करने का निर्देश देता है. अगर लिंकर पैरामीटर मिलता है और वह मान्य है, तो यह पैरामीटर से क्लाइंट आईडी निकालता है और उसे स्टोर करता है.
Linker प्लगिन की मदद से, पेज पर मौजूद लिंक और फ़ॉर्म के यूआरएल में, लिंकर पैरामीटर को अपने-आप और मैन्युअल, दोनों तरीकों से जोड़ा जा सकता है. ज़्यादातर मामलों में, अपने-आप काम करने वाले तरीके का इस्तेमाल करने का सुझाव दिया जाता है.
लिंकर पैरामीटर अपने-आप जोड़े जा रहे हैं
डेस्टिनेशन डोमेन पर ले जाने वाले यूआरएल के लिए, सोर्स डोमेन पर अपने-आप लिंक होने की सुविधा सेट अप करने के लिए, आपको लिंकर प्लगर require होगी. साथ ही, उसके autoLink तरीके को कॉल करना होगा.
autoLink
autoLink तरीके को कमांड सूची के ज़रिए कॉल किया जा सकता है.
चलने के बाद analytics.js, डेस्टिनेशन डोमेन या डोमेन पर ले जाने वाले लिंक पर हुए क्लिक की पहचान करेगा और नेविगेशन शुरू होने से ठीक पहले उन लिंक में लिंकर पैरामीटर जोड़ देगा. जब तक उपयोगकर्ता लिंकर पैरामीटर जोड़ने के लिए लिंक पर क्लिक नहीं करता, तब तक इंतज़ार करना ज़रूरी है क्योंकि लिंकर पैरामीटर दो मिनट के बाद खत्म हो जाते हैं.
अगर आपकी साइट पर ऐसे फ़ॉर्म हैं जो डेस्टिनेशन डोमेन पर ले जाते हैं, तो वैकल्पिक decorateForms पैरामीटर को तय करना चाहिए और true पर सेट करना चाहिए.
इस्तेमाल का तरीका
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
पैरामीटर
| नाम | टाइप | ज़रूरी है | ब्यौरा |
|---|---|---|---|
domains |
Array[RexExp|string] |
हाँ | स्ट्रिंग या रेगुलर एक्सप्रेशन का कलेक्शन, जिसे यूआरएल के hostname से मैच करना है. इससे पता चलता है कि अपने-आप लिंक होने वाले डोमेन को किन पर लागू करना चाहिए. अगर कोई स्ट्रिंग पास हो जाती है, तो analytics.js एक सबस्ट्रिंग मैच करेगा. इसका मतलब है कि example.com, blog.example.com पर ले जाने वाले लिंक से मेल खाएगा. |
useAnchor |
boolean |
no | सही होने पर, लिंकर पैरामीटर को क्वेरी वाले हिस्से के बजाय यूआरएल के ऐंकर वाले हिस्से में जोड़ा जाएगा. |
decorateForms |
boolean |
no | सही होने पर, लिंकर प्लग इन फ़ॉर्म सबमिशन के लिए एक लिंकर पैरामीटर जोड़ेगा, जो domain पैरामीटर से मेल खाने वाले डेस्टिनेशन पर ले जाता है. |
उदाहरण
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
मैन्युअल तरीके से लिंकर पैरामीटर जोड़ना
decorate तरीके का इस्तेमाल करके, लिंकर पैरामीटर को किसी <a> या <form> एलिमेंट में मैन्युअल तरीके से जोड़ा जा सकता है. इस तरीके की ज़रूरत सिर्फ़ तब होती है, जब ऊपर बताए गए autoLink तरीके का इस्तेमाल नहीं किया जा रहा हो.
decorate
decorate तरीके को कमांड सूची के ज़रिए कॉल किया जा सकता है.
यह पक्का करना ज़रूरी है कि सजावट वाले तरीके को तब कॉल किया जाए, जब नेविगेशन जितना संभव हो सके, क्योंकि लिंकर पैरामीटर दो मिनट के बाद खत्म हो जाते हैं. ज़्यादातर मामलों में, इस तरीके को इवेंट हैंडलर में ही कॉल किया जाना चाहिए.
इस्तेमाल का तरीका
ga('[trackerName.]linker:decorate', element, [useAnchor]);
पैरामीटर
| नाम | टाइप | ज़रूरी है | ब्यौरा |
|---|---|---|---|
element |
HTMLElement |
हाँ | लिंकर पैरामीटर को जोड़ने के लिए, <a> या <form> एलिमेंट. |
useAnchor |
boolean |
no | सही होने पर, लिंकर पैरामीटर को क्वेरी वाले हिस्से के बजाय यूआरएल के ऐंकर वाले हिस्से में जोड़ा जाएगा. |
उदाहरण
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
decorate तरीके के अलावा, मैन्युअल तरीके से लिंकर पैरामीटर भी मिल सकता है. ट्रैकर, linkerParam फ़ील्ड के ज़रिए इसका इस्तेमाल करेगा.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
लिंकर पैरामीटर स्वीकार करने के लिए साइट को कॉन्फ़िगर करना
जब कोई उपयोगकर्ता यूआरएल में लिंकर पैरामीटर वाले डेस्टिनेशन डोमेन के किसी पेज पर पहुंचता है, तो उस पैरामीटर को खोजने के लिए analytics.js को उसकी जानकारी होनी चाहिए.
ट्रैकर बनाते समय, allowLinker फ़ील्ड को true पर सेट करके, डेस्टिनेशन पेज को लिंकर पैरामीटर खोजने का निर्देश दिया जा सकता है:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
दो-तरफ़ा क्रॉस-डोमेन मेज़रमेंट
ऐसा यूज़र फ़्लो जिसमें उपयोगकर्ता हमेशा सोर्स डोमेन से शुरू करते हैं और बाद में सिंगल-डायरेक्शनल क्रॉस-डोमेन मेज़रमेंट के तहत डेस्टिनेशन डोमेन पर जाते हैं. ऊपर दिए गए निर्देश इस तरह का यूज़र फ़्लो मानते हैं.
अगर आपको यह नहीं पता है कि आपके उपयोगकर्ता किस डोमेन पर पहले जाएंगे, तो आपको दो-तरफ़ा क्रॉस-डोमेन मेज़रमेंट लागू करना होगा. इसमें हर डोमेन को सोर्स या डेस्टिनेशन के तौर पर काम करने के लिए कॉन्फ़िगर किया गया है.
दो-तरफ़ा क्रॉस-डोमेन मेज़रमेंट को लागू करने के लिए, आपको दोनों डोमेन पर अपने-आप लिंक होने की सुविधा चालू करनी होती है और लिंकर पैरामीटर स्वीकार करने के लिए, दोनों को कॉन्फ़िगर करना होता है.
source.com को:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
destination.com को:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
सभी डोमेन पर एक ही स्निपेट का इस्तेमाल करना
इसे और आसान बनाने के लिए, autoLink तरीके से उन सभी संभावित डोमेन की सूची बनाई जा सकती है जिन्हें आपको मेज़र करना है. इससे आपको हर डोमेन पर कोड के एक ही स्निपेट का इस्तेमाल करने की सुविधा मिलेगी:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);