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

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

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

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


قبل‌از شروع

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

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

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

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

مرحله ۱: به‌روزرسانی لایه داده

پیش‌از ارسال شناسه‌های کاربر به Analytics، user_id را در لایه داده وب‌سایتتان دردسترس قرار دهید.

می‌توانید لایه داده را درطول بارگیری اولیه صفحه یا پس‌از بارگیری صفحه (برای مثال، وقتی کاربر به سیستم وارد می‌شود) به‌روز کنید. هر بار که dataLayer.push را فراخوانی می‌کنید، هر برچسب «مدیر برچسب» مرتبط، user_id به‌روزشده را دریافت خواهد کرد.

نکته کلیدی: برای اطمینان از اینکه user_id با رویداد اولیه بازدید صفحه و همه رویدادهای بعدی مرتبط است، باید لایه داده خود را اعلام کنید و user_id را بالاتر (قبل‌از) قطعه کد محفظه «مدیر برچسب Google» در صفحه قرار دهید. اگر user_id بعداز قطعه GTM ارسال شود، هنگام فعال شدن برچسب‌هایتان در رویداد بارگیری محفظه دردسترس نخواهد بود.

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

مرحله ۲: ایجاد کردن متغیر لایه داده

  1. در مدیر برچسب Google، روی متغیرها کلیک کنید.
  2. در بخش متغیرهای تعریف‌شده توسط کاربر، روی جدید کلیک کنید.
  3. روی پیکربندی متغیر > متغیر لایه داده کلیک کنید.
  4. نامی برای متغیر در بالا وارد کنید.
  5. در فیلد نام متغیر لایه داده، نامی برای متغیر شناسه کاربر خود وارد کنید (مانند «user_id»).
  6. روی ذخیره کلیک کنید.

مرحله ۳: اصلاح برچسب Google

درنهایت، برچسب «پیکربندی» را اصلاح کنید تا همه رویدادهای مرتبط با برچسب از متغیر «لایه داده» استفاده کنند:

  1. در Tag Manager، روی گزینه منو «برچسب‌ها» برچسب‌ها کلیک کنید.
  2. برچسب Google خود را انتخاب کنید.
  3. در بخش تنظیمات پیکربندی، ردیف جدیدی با پارامترهای زیر اضافه کنید:
    • پارامتر: user_id
    • مقدار: متغیر «لایه داده» را که ایجاد کرده‌اید انتخاب کنید.
  4. روی ذخیره کلیک کنید.
  5. برای انتشار تغییرات، روی ارسال کلیک کنید.

نحوه استفاده از User-ID در Google Analytics

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

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

ملاحظات مهم

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

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

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

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

برای اطمینان از اینکه داده‌های «شناسه کاربر» استفاده می‌شود و در کاوشگر کاربر قابل‌مشاهده است، مطمئن شوید که هویت گزارش‌کننده دارایی‌تان روی ترکیبی یا مشاهده‌شده تنظیم شده باشد.