رویدادها را تنظیم کنید

رویدادها به شما امکان می‌دهند تعاملات کاربر را در وب‌سایت یا برنامه خود اندازه‌گیری کنید؛ برای مثال، می‌توانید اندازه‌گیری کنید که چه زمانی کسی صفحه‌ای را بارگذاری می‌کند، روی لینکی کلیک می‌کند و خریدی انجام می‌دهد. گوگل آنالیتیکس از داده‌های رویدادها برای ایجاد گزارش‌هایی با اطلاعات مربوط به کسب‌وکار شما استفاده می‌کند. اطلاعات بیشتر

انواع رویداد

رویدادهای گوگل آنالیتیکس به چهار دسته تقسیم می‌شوند:

نوع رویداد پیوند راه‌اندازی لازم است؟ شرح و مورد استفاده
به صورت خودکار جمع آوری می شود بیشتر بدانید خیر به طور پیش‌فرض هنگام تنظیم برچسب گوگل آنالیتیکس در سایت یا برنامه خود جمع‌آوری می‌شود. نمونه‌هایی از آن شامل first_visit ، session_start و user_engagement است.
اندازه‌گیری پیشرفته بیشتر بدانید خیر (معمولاً) وقتی اندازه‌گیری پیشرفته در رابط کاربری GA4 فعال شود، به‌طور خودکار جمع‌آوری می‌شود. تعاملات رایج وب مانند scroll ، click و file_download اندازه‌گیری می‌کند.
توصیه شده مرجع رویدادهای پیشنهادی بله رویدادهای استاندارد برای حوزه‌های مختلف کسب‌وکار (مثلاً خرده‌فروشی، سفر، بازی) که پنل‌های گزارش‌دهی از پیش ساخته شده را باز می‌کنند. مثال‌ها: purchase ، login ، sign_up .
سفارشی بیشتر بدانید بله رویدادهایی که خودتان تعریف می‌کنید زیرا هیچ رویداد خودکار، بهبود یافته یا پیشنهادی از پیش تعریف شده‌ای متناسب با نیازهای شما وجود ندارد. با استفاده از گزارش‌های سفارشی قابل دسترسی است.

این راهنما به شما نشان می‌دهد که چگونه رویدادهای پیشنهادی و رویدادهای سفارشی را در وب‌سایت خود با استفاده از تگ گوگل (gtag.js) یا گوگل تگ منیجر تنظیم کنید. نیازی به تنظیم رویدادهای اندازه‌گیری خودکار جمع‌آوری‌شده و بهبودیافته ندارید.

مخاطب

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


قبل از اینکه شروع کنی

این راهنما فرض می‌کند که شما موارد زیر را انجام داده‌اید:

همچنین فرض بر این است که شما موارد زیر را دارید:

  • دسترسی به کد منبع وب‌سایت شما
  • نقش ویرایشگر یا بالاتر در حساب گوگل آنالیتیکس

مرور کلی تگ گوگل (gtag.js)

از API تگ گوگل (gtag.js) برای ارسال رویدادها به گوگل آنالیتیکس استفاده کنید. این API یک تابع به نام gtag() دارد و هر زمان که می‌خواهید رویدادی را به گوگل آنالیتیکس ارسال کنید، از سینتکس زیر استفاده می‌کنید:

gtag('event', '<event_name>', {
  <event_parameters>
});

در این مثال، تابع gtag() شامل موارد زیر است:

  • یک دستور event که به گوگل می‌گوید شما در حال ارسال یک رویداد هستید
  • نام رویداد پیشنهادی یا سفارشی
  • (اختیاری) مجموعه‌ای از پارامترها که اطلاعات بیشتری در مورد رویداد ارائه می‌دهند

برای مثال، در ادامه یک رویداد پیشنهادی به نام screen_view با دو پارامتر ارائه شده است:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

رویدادها را به جاوا اسکریپت خود اضافه کنید

gtag() یک تابع جاوا اسکریپت است، بنابراین باید این تابع را به جاوا اسکریپت صفحه وب خود اضافه کنید. برای مثال، می‌توانید این تابع را درون تگ‌های <script> یا در یک فایل جاوا اسکریپت جداگانه که به صفحه HTML خود وارد می‌کنید، اضافه کنید.

شما می‌توانید رویدادها را به جاوا اسکریپت خود در هر جایی زیر قطعه کد تگ گوگل اضافه کنید. گوگل داده‌های رویدادهایی را که بالای قطعه کد تگ گوگل قرار می‌دهید، پردازش نمی‌کند. برای مثال، کد نمونه زیر شامل یک رویداد پیشنهادی به نام screen_view و یک رویداد سفارشی به نام signup_newsletter در یک تگ <script> است:

<!DOCTYPE html>
<html lang="en">
<head>
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
    <script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());

    gtag('config', 'G-XXXXXXXXXX');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      *   The following events are sent when the page loads. You send
      *   recommended and custom events the same way. You could wrap
      *   the events in JavaScript functions so they are sent when
      *   users perform specific actions.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
      gtag('event', 'signup_newsletter', {
        'method': 'web'
      });
    </script> 
</body>
</html>

اگر می‌خواهید رویداد را بر اساس کلیک یک دکمه (یا برخی اقدامات دیگر کاربر) ارسال کنید، می‌توانید مقداری جاوا اسکریپت اضافی به رویداد خود اضافه کنید.

رویدادهای خود را در Analytics ببینید

شما می‌توانید رویدادها و پارامترهای آنها را با استفاده از گزارش‌های Realtime و DebugView مشاهده کنید. توجه داشته باشید که گزارش DebugView قبل از استفاده از گزارش، به پیکربندی‌های اضافی نیاز دارد. این دو گزارش، رویدادهایی را که کاربران در وب‌سایت شما هنگام فعال شدن رویدادها فعال می‌کنند، به شما نشان می‌دهند.

مراحل بعدی

قبلی
Web
بعدی
پارامترها را اضافه کنید، پارامترها را اضافه کنید