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

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

این راهنما به شما نشان می‌دهد که چگونه رویدادهای پیشنهادی و رویدادهای سفارشی را در وب‌سایت خود با استفاده از تگ گوگل (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 در یک تگ <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 event is sent when the page loads. You could
      *   wrap the event in a JavaScript function so the event is
      *   sent when the user performs some action.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>
</html>

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

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

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

مراحل بعدی