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'
});
پیشوند کوکی
برای جلوگیری از تداخل با سایر کوکیها، ممکن است لازم باشد پیشوند کوکی را تغییر دهید، که به کوکیهای تنظیمشده توسط gtag.js اضافه میشود. به عنوان مثال، نام پیشفرض کوکی شناسه مورد استفاده توسط Google Analytics _ga
است. این کد باعث می شود که کوکی به جای آن example_ga
نامیده شود:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'example'
});
انقضای کوکی
در هر بارگذاری صفحه، زمان انقضای کوکی بهروزرسانی میشود تا زمان فعلی به اضافه مقدار قسمت 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'
});
شناسه کاربری را تنظیم کنید
شناسه کاربری یک رشته شناسه منحصر به فرد، پایدار و غیرشخصی است که نشان دهنده یک کاربر است. تجزیه و تحلیل گروه های جلسات را در دستگاه ها امکان پذیر می کند. برای اطلاع از اینکه چرا باید User ID را پیاده سازی کنید، به مزایای استفاده از ویژگی User ID مراجعه کنید.
برای پیاده سازی User ID با gtag.js، config
ویژگی خود را به روز کنید تا شناسه کاربر را تنظیم کنید:
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
رفتار برچسب را بر اساس رضایت تنظیم کنید
میتوانید gtag.js را طوری پیکربندی کنید که کوکیها را نخواند یا ننویسد تا زمانی که رضایت کاربر ارائه شود. برای کسب اطلاعات بیشتر به تنظیم رفتار برچسب بر اساس رضایت مراجعه کنید