مهاجرت از analytics.js به gtag.js (Universal Analytics)

این راهنما شما را در فرآیند انتقال پیاده‌سازی Universal Analytics موجود analytics.js برای استفاده از gtag.js راهنمایی می‌کند.

بررسی اجمالی

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 زیر را که از ردیاب پیش‌فرض برای send بازدید از صفحه به Google Analytics استفاده می‌کند، حذف کنید:

// 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');

تعداد بازدید از صفحه را با ردیاب های مشخص شده اندازه گیری کنید

کد analytics.js زیر را که از ردیاب مشخص شده برای ارسال بازدید از صفحه به Google Analytics استفاده می کند، جایگزین کنید:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

با دستور event gtag.js زیر:

gtag('event', 'page_view', { 'send_to': 'TAG_ID' });

رویدادها را اندازه گیری کنید

همانطور که قبلا ذکر شد، analytics.js از ردیاب ها برای ارسال رویدادها به Google Analytics استفاده می کند. یک ردیاب شناسه ردیابی یک ویژگی Google Analytics را دارد. در مقابل، gtag.js رویدادها را به یک ویژگی Google Analytics که توسط TAG_ID مشخص شده در یک فرمان config مشخص شده است ارسال می‌کند.

رویدادها را با ردیاب پیش‌فرض اندازه‌گیری کنید

کد analytics.js زیر را که از ردیاب پیش‌فرض برای send رویدادها به Google Analytics استفاده می‌کند، جایگزین کنید:

ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

با دستور event gtag.js زیر:

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'
});

رویدادها را با ردیاب‌های مشخص شده اندازه‌گیری کنید

کد analytics.js زیر را که از ردیاب مشخص شده برای ارسال رویدادها به Google Analytics استفاده می کند، جایگزین کنید:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

با دستور event gtag.js زیر:

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'
});

ابعاد و معیارهای سفارشی را ارسال کنید

هر دستور send analytics.js را در صفحات وب خود که ابعاد سفارشی را به 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'});

شناسه Analytics خودتان را جایگزین TAG_ID کنید.

هر دستور send analytics.js را در صفحات وب خود که معیارهای سفارشی را به 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 با شناسه برچسب خود جایگزین کنید.

زمان بندی کاربر را اندازه گیری کنید

هر دستور send analytics.js را در صفحات وب خود که زمان‌بندی کاربر را ردیابی می‌کند ، جایگزین کنید:

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

با دستور gtag.js event زیر:

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

موارد استثنا را اندازه گیری کنید

هر دستور send analytics.js را در صفحات وب خود که استثناها را ردیابی می کند جایگزین کنید:

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

با دستور event gtag.js زیر:

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

شناسه مشتری و شناسه کاربری

فیلد analytics.js پارامتر gtag.js
clientId client_id
userId user_id