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

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

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

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

پارامتر user_id یک پارامتر پیکربندی است، نه یک ویژگی کاربر سفارشی یا پارامتر رویداد استاندارد. در عوض، user_id یک پارامتر سیستمی رزرو شده است که به طور خاص برای شناسایی کاربران احراز هویت شده در دستگاه‌ها و جلسات استفاده می‌شود. آن را به عنوان یک ویژگی کاربر سفارشی (به عنوان مثال، در شیء user_properties برای gtag.js یا در بخش ویژگی‌های کاربر از برچسب‌های Google Tag Manager) تنظیم نکنید و آن را به عنوان یک بُعد سفارشی در رابط کاربری Analytics ثبت نکنید. به همین ترتیب، آن را به عنوان یک پارامتر سطح رویداد در رویدادهای فردی ارسال نکنید. در عوض، user_id فقط به عنوان یک پارامتر پیکربندی با استفاده از روش‌های زیر تنظیم کنید.

مدیریت برچسب gtag.js

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

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

• یک حساب کاربری و ویژگی گوگل آنالیتیکس ایجاد کنید .
• یک جریان داده وب برای وب‌سایت خود ایجاد کنید .
• تگ گوگل را در وب‌سایت خود قرار دهید .
• به کد منبع وب‌سایت خود دسترسی داشته باشید.
• نقش ویرایشگر (یا بالاتر) را در حساب گوگل آنالیتیکس داشته باشید.

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

مقداری که برای 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 در طول جلسه کاربر به درستی مدیریت می‌شود و وضعیت ورود فعلی کاربر را حتی اگر پس از بارگذاری صفحه تغییر کند، منعکس می‌کند.

نحوه استفاده از شناسه کاربری در گوگل آنالیتیکس

وقتی مقادیر user_id را به گوگل آنالیتیکس ارسال می‌کنید، از آنها برای موارد زیر استفاده می‌شود:

• یکپارچه‌سازی سفرهای کاربر: فعالیت کاربر را در جلسات، دستگاه‌ها و پلتفرم‌های مختلف برای کاربران وارد شده متصل کنید.
• بهبود تعداد کاربران: ارائه معیارهای دقیق‌تر و بدون تکرار برای کاربران.
• فعال کردن تحلیل:
  • تجزیه و تحلیل فعالیت بر اساس وضعیت ورود: از ابعادی مانند «با شناسه کاربری وارد شده‌ام» برای ایجاد مقایسه در گزارش‌های استاندارد یا بخش‌هایی در کاوش‌ها استفاده کنید.
  • تکنیک کاوش کاربر اکسپلورر را تقویت کنید، که به شما امکان می‌دهد تا به جدول زمانی فعالیت‌های هر کاربر دسترسی پیدا کنید.

ملاحظات مهم

• برای شناسه کاربری ابعاد سفارشی ایجاد نکنید: شما نباید شناسه user_id به عنوان یک بعد سفارشی با محدوده کاربر ثبت کنید. این یک روش عالی و کلیدی است. انجام این کار یک بعد غیرضروری با تعداد هسته بالا ایجاد می‌کند که می‌تواند به شدت بر عملکرد گزارش تأثیر بگذارد، باعث شود داده‌ها در ردیف "(سایر)" گروه‌بندی شوند و سهمیه ابعاد سفارشی شما را مصرف کنند. ویژگی داخلی شناسه کاربری، ادغام کاربر را مدیریت می‌کند. برای اطلاعات بیشتر به بهترین شیوه‌ها برای شناسه کاربری مراجعه کنید.

• user_id به عنوان یک تنظیم پیکربندی تنظیم کنید، نه یک ویژگی کاربر یا پارامتر رویداد: از آنجا که user_id یک پارامتر سیستمی رزرو شده است، فقط باید به عنوان یک پیکربندی یا پارامتر تنظیم اعمال شود (با استفاده از دستورات config یا set gtag() یا تنظیمات پیکربندی تگ گوگل در Google Tag Manager). آن را به عنوان یک ویژگی کاربر سفارشی پیکربندی نکنید، آن را درون شیء تنظیمات user_properties منتقل نکنید، یا آن را به عنوان یک پارامتر سطح رویداد در رویدادهای جداگانه ارسال نکنید.

• قابلیت مشاهده مستقیم شناسه در گزارش‌های استاندارد در مقایسه با کاوش‌ها: مقادیر خام user_id به عنوان یک بُعد استاندارد در گزارش‌های استاندارد یا اکثر کاوش‌ها (مانند فرم رایگان) برای حفظ حریم خصوصی و مدیریت کاردینالیتی در دسترس نیستند. با این حال، می‌توانید user_id خام را در الگوی کاوش کاوشگر کاربر در زیر ستونی با عنوان شناسه کاربر مؤثر برای کاربران وارد شده مشاهده کنید.

• دسترسی به شناسه‌های خام کاربر: اگر نیاز به انجام تجزیه و تحلیل با استفاده از مقادیر خام user_id دارید، رویکرد پیشنهادی استفاده از Google Analytics 4 BigQuery Export است. فیلد user_id در داده‌های خروجی موجود است.

برای اطمینان از اینکه داده‌های شناسه کاربری در User Explorer استفاده و قابل مشاهده هستند، مطمئن شوید که Reporting Identity مربوط به property شما روی Blended یا Observed تنظیم شده است.