इस गाइड में, लागू किए गए analytics.js
Universal Analytics को gtag.js
पर माइग्रेट करने का तरीका बताया गया है.
खास जानकारी
Google Analytics को डेटा भेजने के लिए analytics.js में दो मुख्य तरीके हैं:
-
ट्रैकर से पता चलता है कि किस प्रॉपर्टी को मेज़र किया जा रहा है.
-
हिट टाइप से पता चलता है कि किस तरह के इंटरैक्शन को मेज़र करना है.
gtag.js
प्रॉपर्टी में, config
कमांड के ज़रिए या किसी कमांड के पैरामीटर के तौर पर उसे बताया जाता है.
analytics.js के उलट, gtag.js Google Analytics को डेटा भेजने के लिए ट्रैकर का इस्तेमाल नहीं करता. यह Google Analytics प्रॉपर्टी को डेटा भेजता है. इन प्रॉपर्टी की पहचान, config
कमांड से सेट किए गए आईडी से की जाती है. gtag.js को दिए गए इवेंट के नाम से यह पता चलता है कि
Google Analytics को किस तरह का डेटा भेजा जा रहा है.
analytics.js से gtag.js पर माइग्रेट करने के लिए, अपनी साइट के हर वेब पेज के लिए ये काम करें:
analytics.js कोड को मिलते-जुलते gtag.js कोड से बदलें:
analytics.js स्निपेट को gtag.js स्निपेट से बदलना
अपने वेब पेज में analytics.js स्निपेट बदलें:
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
किए गए gtag.js स्निपेट के साथ:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
पेज व्यू मेज़र करना
analytics.js, Google Analytics को पेज व्यू भेजने के लिए ट्रैकर का इस्तेमाल करता है. ट्रैकर में Google Analytics प्रॉपर्टी का मेज़रमेंट आईडी होता है. gtag.js उस Google Analytics प्रॉपर्टी को पेज व्यू भेजता है जिसकी पहचान config
कमांड में बताए गए TAG_ID
से की जाती है.
डिफ़ॉल्ट ट्रैकर की मदद से पेज व्यू मेज़र करना
नीचे दिया गया analytics.js कोड हटाएं जो Google Analytics के पेज व्यू send
के लिए डिफ़ॉल्ट ट्रैकर का इस्तेमाल करता है:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');
gtag.js स्निपेट में यह कोड अपने-आप TAG_ID
के टैग आईडी के साथ, Google Analytics प्रॉपर्टी को एक पेज व्यू भेजता है:
gtag('config', 'TAG_ID');
तय किए गए ट्रैकर की मदद से पेज व्यू मेज़र करना
Google Analytics को पेज व्यू भेजने के लिए, तय किए गए ट्रैकर का इस्तेमाल करने वाले Analytics.js कोड को बदलें:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
नीचे दिए गए gtag.js event
कमांड का इस्तेमाल करके:
gtag('event', 'page_view', { 'send_to': 'TAG_ID' });
इवेंट मेज़र करना
जैसा कि पहले बताया गया था, Google Analytics को इवेंट भेजने के लिए analytics.js ट्रैकर का इस्तेमाल करता है. ट्रैकर में Google Analytics प्रॉपर्टी का ट्रैकिंग आईडी होता है. इसके उलट, gtag.js उस Google Analytics प्रॉपर्टी को इवेंट भेजता है जिसकी पहचान config
कमांड में बताए गए
TAG_ID
से होती है.
डिफ़ॉल्ट ट्रैकर की मदद से इवेंट मेज़र करना
Google Analytics में इवेंट send
के लिए, डिफ़ॉल्ट ट्रैकर का इस्तेमाल करने वाले analytics.js कोड को बदलें:
ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
इसके लिए,
gtag.js event
कमांड का इस्तेमाल किया जाएगा:
gtag('event', eventName, eventParameters);
यहां eventName
उस इवेंट का नाम है जिसे आपको लॉग करना है.
उदाहरण:
analytics.js:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
तय किए गए ट्रैकर की मदद से, इवेंट को मेज़र करना
Google Analytics को इवेंट भेजने के लिए, तय किए गए ट्रैकर का इस्तेमाल करने वाले नीचे दिए गए analytics.js कोड को बदलें:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
नीचे दिए गए gtag.js event
कमांड का इस्तेमाल करके:
gtag('event', eventName, {
'send_to': 'TAG_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
उदाहरण:
analytics.js:
// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');
// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
'send_to': 'TAG_ID',
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
कस्टम डाइमेंशन और मेट्रिक भेजें
अपने वेब पेजों में मौजूद कोई भी analytics.js send
कमांड बदलें, जो Google Analytics को
कस्टम डाइमेंशन भेजता है:
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
जिसकी मदद से gtag.js कोड का इस्तेमाल किया जा सकता है:
gtag('config', 'TAG_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
TAG_ID
को अपने Analytics आईडी से बदलें.
अपने वेब पेजों में मौजूद कोई भी analytics.js send
कमांड बदलें, जो Google Analytics को
कस्टम मेट्रिक भेजता है:
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
जिसकी मदद से gtag.js कोड का इस्तेमाल किया जा सकता है:
gtag('config', 'TAG_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
TAG_ID
की जगह अपना टैग आईडी डालें.
उपयोगकर्ता समय मापें
अपने वेब पेजों में मौजूद ऐसा कोई भी analytics.js send
कमांड बदलें जो
उपयोगकर्ता के समय को ट्रैक करता है:
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
नीचे दिए गए
gtag.js event
कमांड का इस्तेमाल करके:
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
अपवादों को मेज़र करना
अपने वेब पेजों में ऐसे सभी analytics.js send
कमांड को बदलें जो
अपवादों को ट्रैक करता है:
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
इसके लिए, gtag.js event
कमांड का इस्तेमाल करें:
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
analytics.js फ़ील्ड को gtag.js पैरामीटर में मैप करना
नीचे दी गई टेबल, analytics.js फ़ील्ड को इनसे जुड़े gtag.js पैरामीटर से मैप करती हैं.
इवेंट
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
कस्टम डाइमेंशन और मेट्रिक
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
जहां <Index>
एक गैर-ऋणात्मक पूर्णांक है, जो कस्टम डाइमेंशन या मेट्रिक के इंडेक्स को दिखाता है.
उपयोगकर्ता समय
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
अपवाद मेज़रमेंट
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
exDescription |
description |
exFatal |
fatal |
बेहतर ई-कॉमर्स कार्रवाई का डेटा
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
प्रमोशन का डेटा
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
creative |
creative_name |
position (इंप्रेशन, प्रॉडक्ट) |
list_position |
position (प्रमोशन) |
creative_slot |
प्रॉडक्ट और प्रमोशन से जुड़ी कार्रवाइयां
analytics.js फ़ील्ड | gtag.js इवेंट |
---|---|
add |
add_to_cart |
checkout (पहला चरण) |
begin_checkout |
checkout (इसके बाद का कोई भी चरण) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (प्रमोशन के बिना) |
detail |
view_item |
promo_click |
select_content (प्रमोशन के साथ) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client-ID और यूज़र आईडी
analytics.js फ़ील्ड | gtag.js पैरामीटर |
---|---|
clientId |
client_id |
userId |
user_id |