analytics.js से gtag.js (Universal Analytics) पर माइग्रेट करना

इस गाइड में, लागू किए गए analytics.js Universal Analytics को gtag.js पर माइग्रेट करने का तरीका बताया गया है.

खास जानकारी

Google Analytics को डेटा भेजने के लिए analytics.js में दो मुख्य तरीके हैं:

  1. ट्रैकर

    ट्रैकर से पता चलता है कि किस प्रॉपर्टी को मेज़र किया जा रहा है.

  2. हिट के टाइप

    हिट टाइप से पता चलता है कि किस तरह के इंटरैक्शन को मेज़र करना है.

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 स्निपेट बदलें:

<!-- 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&lt;Index&gt;':  '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