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

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

खास जानकारी

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

  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 प्रॉपर्टी को पेज व्यू भेजता है जिसकी पहचान TAG_ID ने config कमांड में की है.

डिफ़ॉल्ट ट्रैकर से पेज व्यू मेज़र करना

नीचे दिया गया 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' });

इवेंट मेज़र करना

जैसा कि पहले बताया गया है, analytics.js Google Analytics को इवेंट भेजने के लिए ट्रैकर का इस्तेमाल करता है. ट्रैकर में 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