مناسبت ها

این مقاله راهنمایی در مورد نحوه انتقال رویدادهای Universal Analytics (UA) به رویدادهای Google Analytics 4 (GA4) ارائه می‌کند.

از آنجایی که مدل‌های اندازه‌گیری برای UA و GA4 متفاوت است، توصیه می‌شود به جای پورت ساختار رویداد UA موجود خود به GA4، مجموعه داده‌های خود را بر اساس مدل GA4 تجدید نظر کنید.

برای کسب اطلاعات بیشتر درباره رویدادهای GA4، درباره رویدادها را بخوانید.

مقایسه رویدادهای UA و GA4

Universal Analytics

برای Universal Analytics (UA)، اندازه‌گیری با ارسال بازدید انجام می‌شود. بیشتر انواع ضربه برای اندازه گیری تعاملات خاص استفاده می شود (مثلاً pageview ) اما نوع ضربه event برای اندازه گیری سفارشی/عمومی در دسترس است. داده های ارسال شده با ضربه event شامل دسته ، اقدام و برچسب است.

در زیر نمونه‌هایی از رویدادهای Universal Analytics برای کتابخانه‌های analytics.js و gtag.js آمده است:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

گوگل آنالیتیکس 4

برای Google Analytics 4 (GA4)، اندازه گیری با ارسال رویدادها انجام می شود. رویدادهایی هستند که به صورت خودکار جمع‌آوری می‌شوند، رویدادهایی هستند که از پیش تعریف شده‌اند و توصیه می‌شوند در صورت لزوم آن‌ها را ارسال کنید، و رویدادهای سفارشی‌ای هستند که می‌توانید در مواردی که رویدادهای خودکار یا توصیه‌شده مطابق با موارد استفاده شما نیستند، ارسال کنید.

مثال زیر نمونه ای از یک رویداد سفارشی در GA4 است:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

نگاشت یک رویداد UA به GA4

برای انتقال رویداد UA به GA4، باید تشخیص دهید که آیا رویداد GA4 معادل وجود دارد یا خیر. برای نگاشت یک رویداد UA به GA4 از روش پلکانی زیر استفاده کنید:

  1. فهرست رویدادهای جمع آوری خودکار را مرور کنید. اگر یک رویداد جمع‌آوری‌شده خودکار GA4 با رویداد UA مطابقت دارد، رویداد UA را حذف کنید و به رویداد جمع‌آوری‌شده خودکار تکیه کنید.

  2. اگر در مرحله قبل موردی را پیدا نکردید، رویدادهای جمع‌آوری‌شده از طریق اندازه‌گیری پیشرفته را مرور کنید. اگر یک رویداد اندازه‌گیری پیشرفته GA4 با هدف رویداد UA مطابقت دارد، رویداد UA را انتقال ندهید و در عوض برای ارسال رویداد به اندازه‌گیری پیشرفته تکیه کنید. مطمئن شوید که تأیید می‌کنید که اندازه‌گیری بهبودیافته برای ویژگی GA4 شما برای جمع‌آوری رویداد به درستی پیکربندی شده است.

  3. اگر در مرحله قبل موردی را پیدا نکردید، فهرست رویدادهای توصیه شده را مرور کنید. اگر یک رویداد توصیه شده GA4 دقیقاً با هدف رویداد UA مطابقت دارد، از رویداد توصیه شده استفاده کنید و هنگام ارسال رویداد، پارامترهای رویداد قابل اجرا را تنظیم کنید.

  4. اگر در مرحله قبل موردی را پیدا نکردید، یک رویداد سفارشی ارسال کنید.

سناریوها و نمونه های مهاجرت

رویدادها به صورت خودکار جمع آوری می شوند

رویدادهای جمع‌آوری‌شده به‌طور خودکار همیشه ارسال می‌شوند و معمولاً غیرفعال نمی‌شوند، مگر اینکه از طریق اندازه‌گیری پیشرفته قابل تنظیم باشند. به طور کلی شما نباید رویدادهای UA را که یک رویداد به اندازه کافی معادل به طور خودکار جمع آوری شده است، منتقل کنید.

برای مثال، یک رویداد UA که برای اندازه‌گیری تعامل دانلود فایل ارسال می‌شود، احتمالاً نیازی به انتقال به GA4 ندارد زیرا رویداد file_download در GA4 به‌طور خودکار جمع‌آوری می‌شود.

اندازه گیری پیشرفته

به طور کلی، زمانی که یک رویداد GA4 به اندازه کافی معادل از طریق اندازه‌گیری پیشرفته جمع‌آوری می‌شود، نیازی به انتقال رویدادهای UA به GA4 ندارید. برای مثال، رویدادهای UA زیر احتمالاً نیازی به انتقال به GA4 ندارند، زیرا آنها قبلاً در GA4 از طریق اندازه‌گیری پیشرفته اندازه‌گیری شده‌اند:

نادیده گرفتن اندازه گیری پیشرفته

اگر یک رویداد اندازه‌گیری پیشرفته از نظر هدف برابر با رویداد UA شما باشد، اما تمام داده‌های مورد نیاز شما را جمع‌آوری نمی‌کند، می‌توانید رویداد را به‌صورت دستی با پارامترهای سفارشی اضافی ارسال کنید. این مستلزم آن است که اندازه گیری پیشرفته را برای رویداد مربوطه پیکربندی/غیرفعال کنید و رویداد GA4 را به صورت دستی ارسال کنید.

به عنوان مثال، رویداد file_download جمع‌آوری‌شده از طریق اندازه‌گیری پیشرفته ، با رویداد UA شما مطابقت دارد، اما اطلاعات مربوط به اندازه فایل را از دست داده است. برای نادیده گرفتن رویداد اندازه‌گیری پیشرفته و گنجاندن اطلاعات اندازه فایل، موارد زیر را انجام دهید:

  1. دانلود فایل ها را در اندازه گیری پیشرفته غیرفعال کنید.
  2. هر جا مناسب باشد، رویداد file_download را با پارامترهای سفارشی به صورت دستی ارسال کنید.
    • از آنجایی که رویداد جمع‌آوری‌شده خودکار از طریق اندازه‌گیری بهبودیافته غیرفعال می‌شود، باید پارامترهایی را که معمولاً با رویداد جمع‌آوری می‌شوند به صورت دستی تنظیم کنید (به عنوان مثال file_extension ، file_name ، و غیره).
  3. برای مشاهده مقادیر پارامترهای سفارشی در گزارش‌ها، یک بعد/متریک سفارشی ایجاد کنید.

مثال gtag.js زیر یک رویداد file_download GA4 با پارامتر سفارشی file_size ارسال می کند.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

اگر رویداد UA شما دارای یک رویداد به اندازه کافی معادل GA4 Recommended است، رویداد UA خود را به رویداد توصیه شده منتقل کنید.

مثال زیر یک رویداد analytics.js UA برای اندازه گیری ورود است:

ga('send', 'event', 'login', 'google-sso');

رویداد login GA4 می تواند برای انتقال رویداد UA به GA4 استفاده شود. معادل GA4 gtag.js به شرح زیر است:

gtag('event', 'login', {
  method: 'google-sso'
});

رویداد سفارشی

اگر رویداد UA شما هیچ رویداد مربوط به جمع‌آوری خودکار ، اندازه‌گیری پیشرفته ، یا رویداد توصیه‌شده ندارد، رویداد UA خود را به یک رویداد سفارشی منتقل کنید و در صورت نیاز ابعاد و معیارهای سفارشی ایجاد کنید.

مثال زیر یک رویداد analytics.js UA را نشان می‌دهد که تغییرات در گزینه‌های جهت UI را اندازه‌گیری می‌کند:

ga('send', 'event', 'orientation', 'layout', 'wide');

هیچ رویداد GA4 از پیش تعریف شده ای برای اندازه گیری رویداد UA در بالا وجود ندارد. در عوض، مثال gtag.js زیر نشان می‌دهد که چگونه از یک رویداد سفارشی برای اندازه‌گیری همان تعامل در GA4 استفاده می‌شود:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

برای گنجاندن ui_element و configuration در گزارش‌های خود، باید ابعاد مربوطه را از این پارامترهای رویداد ایجاد کنید. برای کسب اطلاعات بیشتر به ابعاد و معیارهای سفارشی مراجعه کنید.