این راهنما شما را در فرآیند انتقال پیادهسازی Universal Analytics موجود analytics.js
برای استفاده از gtag.js
راهنمایی میکند.
بررسی اجمالی
analytics.js دو مکانیسم اصلی برای ارسال داده به Google Analytics دارد:
ردیاب ها مشخص می کنند که کدام ملک را اندازه گیری می کنید.
انواع ضربه مشخص می کند که چه نوع تعاملی را اندازه گیری می کنید.
در 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 می فرستد که با 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<Index>': '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 |