شناسه های کاربری را ارسال کنید

شناسه‌های کاربری، شناسه‌های منحصر به فرد شما هستند که به کاربران اختصاص می‌دهید. این راهنما نحوه ارسال شناسه‌های کاربری به گوگل آنالیتیکس را توضیح می‌دهد، بنابراین می‌توانید رفتار کاربر را در جلسات، دستگاه‌ها و پلتفرم‌های مختلف به هم مرتبط کنید.

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

تنظیم ابعاد سفارشی بر اساس شناسه‌های کاربری منجر به ابعادی با مقادیر منحصر به فرد بسیار زیاد می‌شود. داشتن مقادیر منحصر به فرد بسیار زیاد باعث ایجاد مشکلاتی در داده‌های گوگل آنالیتیکس و دقت گزارش می‌شود. درباره بهترین شیوه‌های تنظیم ابعاد سفارشی بیشتر بدانید .


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

قبل از ارسال شناسه‌های کاربری، مطمئن شوید که موارد زیر را تکمیل کرده‌اید:

ارسال شناسه‌های کاربری

مقداری که برای user_id ارسال می‌کنید به وضعیت کاربر بستگی دارد:

  • کاربر هرگز وارد سیستم نشده است : پارامتر user_id را ارسال نکنید.
  • کاربر وارد سیستم شده است : شناسه کاربری او را ارسال کنید.
  • کاربر وارد سیستم شده و سپس از سیستم خارج شده است : ارسال null .

برای ارسال شناسه کاربری به آنالیتیکس، پارامتر user_id را به دستور config در هر صفحه از وب‌سایت خود اضافه کنید:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. به جای TAG_ID شناسه تگ خود را قرار دهید.
  2. نظرات را با بررسی‌های خود برای اینکه آیا کاربر وارد سیستم شده است یا خیر، و اینکه آیا کاربر وارد سیستم شده اما سپس از سیستم خارج شده است، جایگزین کنید.
  3. اگر کاربری وارد سیستم شده است، به جای USER_ID ، شناسه کاربری او را وارد کنید.
  4. وقتی کاربر از سیستم خارج می‌شود، user_id روی null تنظیم کنید. رشته خالی ( "" ) ، رشته خالی ( " " ) یا کلمات "null" یا "NULL" که در گیومه قرار دارند را ارسال نکنید.

تنظیم شناسه کاربری پس از مقداردهی اولیه

در بسیاری از موارد، user_id هنگام مقداردهی اولیه تگ گوگل مشخص نیست. برای مثال، ممکن است کاربری از سایت شما بازدید کند و بعداً وارد سیستم شود.

برای تنظیم یا به‌روزرسانی user_id پس از بارگذاری اولیه صفحه، از دستور gtag('set') استفاده کنید. این دستور user_id را برای همه رویدادهای بعدی در صفحه تنظیم می‌کند و در این سناریو، رویکرد پیشنهادی به جای gtag('config') است.

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

وقتی کاربری با موفقیت وارد سیستم شد، تابع gtag('set') را فراخوانی کنید تا شناسه او را با رویدادهای آینده مرتبط کنید:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

پاک کردن شناسه کاربری هنگام خروج

وقتی کاربر از سیستم خارج می‌شود، باید user_id را با تنظیم مقدار آن به null پاک کنید:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

با استفاده از gtag('set') ، مطمئن می‌شوید که user_id در طول جلسه کاربر به درستی مدیریت می‌شود و وضعیت ورود فعلی کاربر را حتی اگر پس از بارگذاری صفحه تغییر کند، منعکس می‌کند.

قبلی
پارامترها را اضافه کنید، پارامترها را اضافه کنید
بعدی
موارد استثنا را اندازه گیری کنید