کوکی ها و شناسایی کاربر با gtag.js

gtag.js از کوکی ها برای شناسایی کاربران منحصر به فرد در جلسات مرور استفاده می کند. این صفحه نحوه سفارشی کردن تنظیمات کوکی را توضیح می دهد.

توجه: برای جزئیات بیشتر در مورد نحوه استفاده gtag.js از کوکی ها می توانید به راهنمای استفاده از کوکی مراجعه کنید.

تنظیمات فیلد کوکی را پیکربندی کنید

جدول زیر مقادیر فیلد کوکی پیش فرض استفاده شده توسط gtag.js را نشان می دهد:

نام زمینه	نوع ارزش	مقدار پیش فرض
cookie_domain	string	auto
cookie_expires	integer	63072000 (دو سال، در ثانیه)
cookie_prefix	string	_ga
cookie_update	boolean	true
cookie_flags	string

برای تغییر هر یک از این مقادیر، config ویژگی خود را به روز کنید تا آنها را در لیست پارامترها مشخص کنید. مثلا:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

پیکربندی دامنه کوکی

به طور پیش فرض، gtag.js دارای پیکربندی خودکار دامنه کوکی فعال است. وقتی فعال باشد، gtag.js کوکی‌ها را در دامنه بالاترین سطحی که می‌تواند تنظیم می‌کند. برای مثال، اگر آدرس وب‌سایت شما blog.example.com است، gtag.js کوکی‌ها را در دامنه example.com تنظیم می‌کند. اگر gtag.js تشخیص دهد که شما یک سرور را به صورت محلی اجرا می کنید (مثلاً localhost )، به طور خودکار cookie_domain روی 'none' تنظیم می کند، که باعث می شود gtag.js کوکی ها را با استفاده از دامنه کامل از محل سند تنظیم کند.

برای خاموش کردن پیکربندی خودکار دامنه کوکی، config ویژگی خود را به‌روزرسانی کنید تا مقداری برای پارامتر cookie_domain مشخص کنید:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

توجه: هنگامی که از پیکربندی خودکار دامنه کوکی استفاده می کنید، فعالیت در زیر دامنه ها بدون هیچ گونه پیکربندی اضافی اندازه گیری می شود.

احتیاط: cookie_domain باید اجداد دامنه فعلی باشد، در غیر این صورت کوکی تنظیم نخواهد شد. برای مثال، اگر دامنه شما one.two.three.root.com است، می‌توانید کوکی را طوری پیکربندی کنید که روی root.com تنظیم شود، اما نه someotherdomain.com . تنظیم یک دامنه کوکی نادرست منجر به ارسال هیچ بازدیدی به Google Analytics نخواهد شد.

پیشوند کوکی

برای جلوگیری از تداخل با سایر کوکی‌ها، ممکن است لازم باشد پیشوند کوکی را تغییر دهید، که به کوکی‌های تنظیم‌شده توسط gtag.js اضافه می‌شود. به عنوان مثال، نام پیش‌فرض کوکی شناسه مورد استفاده توسط Google Analytics _ga است. این کد باعث می شود که کوکی به جای آن example_ga نامیده شود:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

احتیاط: اگر سایتی که برچسب گذاری شده با gtag.js یا Google Analytics باشد، و پس از بازدید کاربران از سایت cookie_prefix تغییر کند، این بازدیدکنندگان به عنوان بازدیدکنندگان جدید برای gtag.js و Google Analytics ظاهر می شوند، زیرا زمینه ذخیره شده در غیر از کوکی های پیشوندی از بین خواهند رفت. به همین دلیل، اگر استفاده از پیشوند کوکی مورد نظر است، توصیه می کنیم از اولین باری که سایت تگ می شود از آن استفاده کنید.

انقضای کوکی

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

اگر مقدار cookie_expires را روی 0 (صفر) ثانیه تنظیم کنید، کوکی به یک کوکی مبتنی بر جلسه تبدیل می شود و پس از پایان جلسه فعلی مرورگر منقضی می شود.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

احتیاط: اگر کوکی را خیلی سریع تنظیم کنید که منقضی شود، تعداد کاربران خود را افزایش می دهید و کیفیت اندازه گیری خود را کاهش می دهید.

به روز رسانی کوکی

وقتی cookie_update روی true (مقدار پیش‌فرض) تنظیم می‌شود، gtag.js کوکی‌ها را در هر بارگذاری صفحه به‌روزرسانی می‌کند. با این کار انقضای کوکی برای تنظیم نسبت به آخرین بازدید از سایت به روز می شود. به عنوان مثال، اگر انقضای کوکی روی یک هفته تنظیم شده باشد، و کاربر هر پنج روز یکبار با استفاده از مرورگر یکسان بازدید کند، انقضای کوکی در هر بازدید به‌روزرسانی می‌شود و عملاً هرگز منقضی نمی‌شود.

وقتی روی false تنظیم شود، کوکی ها در هر بار بارگذاری صفحه به روز نمی شوند. این تأثیر منقضی شدن کوکی ها نسبت به اولین باری است که کاربر از سایت بازدید می کند.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

پرچم های کوکی

هنگام تنظیم، پرچم های اضافی را به کوکی اضافه می کند. پرچم ها باید با نقطه ویرگول از هم جدا شوند.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

احتیاط: تنظیم samesite روی None و حذف پرچم Secure یا ارائه سایت از طریق HTTP ، تأثیر منفی بر اندازه‌گیری خواهد داشت.

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

شناسه کاربری یک رشته شناسه منحصر به فرد، پایدار و غیرشخصی است که نشان دهنده یک کاربر است. تجزیه و تحلیل گروه های جلسات را در دستگاه ها امکان پذیر می کند. برای اطلاع از اینکه چرا باید User ID را پیاده سازی کنید، به مزایای استفاده از ویژگی User ID مراجعه کنید.

برای پیاده سازی User ID با gtag.js، config ویژگی خود را به روز کنید تا شناسه کاربر را تنظیم کنید:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

رفتار برچسب را بر اساس رضایت تنظیم کنید

می‌توانید gtag.js را طوری پیکربندی کنید که کوکی‌ها را نخواند یا ننویسد تا زمانی که رضایت کاربر ارائه شود. برای کسب اطلاعات بیشتر به تنظیم رفتار برچسب بر اساس رضایت مراجعه کنید