استفاده از کوکی Google Analytics در وب سایت ها

این سند توضیح می دهد که چگونه Google Analytics از کوکی ها برای اندازه گیری تعاملات کاربر در وب سایت ها استفاده می کند.

بررسی اجمالی

گوگل آنالیتیکس یک ابزار ساده و کاربردی است که به صاحبان وب سایت کمک می کند تا نحوه تعامل کاربران با محتوای وب سایت را اندازه گیری کنند. هنگامی که کاربر بین صفحات وب حرکت می کند، گوگل آنالیتیکس تگ های جاوا اسکریپت (کتابخانه ها) را برای صاحبان وب سایت فراهم می کند تا اطلاعات صفحه ای را که کاربر دیده است، به عنوان مثال URL صفحه، ثبت کنند.

کتابخانه‌های جاوا اسکریپت Google Analytics از کوکی‌های HTTP برای «به خاطر آوردن» کارهایی که کاربر در صفحات قبلی / تعاملات با وب‌سایت انجام داده است، استفاده می‌کنند.

گوگل آنالیتیکس از سه کتابخانه (برچسب) جاوا اسکریپت برای اندازه گیری میزان استفاده از وب سایت پشتیبانی می کند: gtag.js ، analytics.js و ga.js. بخش‌های زیر نحوه استفاده هر کتابخانه از کوکی‌ها را برای Universal Analytics و Google Analytics 4 ، در صورت لزوم، توضیح می‌دهد.

gtag.js (Google Analytics 4) - استفاده از کوکی

برای Google Analytics 4 ، کتابخانه جاوا اسکریپت gtag.js از کوکی های شخص اول استفاده می کند تا:

متمایز کردن کاربران منحصر به فرد
تمایز جلسات برای یک کاربر

هنگام استفاده از جاوا اسکریپت توصیه شده، کوکی‌های قطعه در بالاترین سطح دامنه ممکن تنظیم می‌شوند. به عنوان مثال، اگر آدرس وب سایت شما blog.example.co.uk باشد، gtag.js دامنه کوکی را روی .example.co.uk تنظیم می کند. تنظیم کوکی ها در بالاترین سطح دامنه ممکن به اندازه گیری اجازه می دهد تا در میان زیر دامنه ها بدون هیچ گونه پیکربندی اضافی انجام شود.

gtag.js کوکی های زیر را تنظیم می کند:

نام کوکی	زمان انقضای پیش فرض	شرح
`_ga`	2 سال	برای متمایز کردن کاربران استفاده می شود.
`_ga_<container-id>`	2 سال	برای تداوم وضعیت جلسه استفاده می شود.

سفارشی سازی

کوکی‌های gtag.js و راهنمای شناسایی کاربر (GA4) را بخوانید تا بدانید چگونه می‌توان این تنظیمات پیش‌فرض را با gtag.js سفارشی کرد.

gtag.js و analytics.js (Universal Analytics) - استفاده از کوکی

کتابخانه جاوا اسکریپت analytics.js یا کتابخانه جاوا اسکریپت gtag.js را می توان برای Universal Analytics استفاده کرد. در هر دو مورد، کتابخانه ها از کوکی های شخص اول استفاده می کنند تا:

متمایز کردن کاربران منحصر به فرد
نرخ درخواست را کاهش دهید

هنگام استفاده از جاوا اسکریپت توصیه شده، کوکی‌های قطعه در بالاترین سطح دامنه ممکن تنظیم می‌شوند. برای مثال، اگر آدرس وب‌سایت شما blog.example.co.uk است، analytics.js و gtag.js دامنه کوکی را روی .example.co.uk تنظیم می‌کنند. تنظیم کوکی ها در بالاترین سطح دامنه ممکن به اندازه گیری اجازه می دهد تا در میان زیر دامنه ها بدون هیچ گونه پیکربندی اضافی انجام شود.

gtag.js و analytics.js کوکی‌های زیر را تنظیم می‌کنند:

نام کوکی	زمان انقضای پیش فرض	شرح
`_ga`	2 سال	برای متمایز کردن کاربران استفاده می شود.
`_gid`	24 ساعت	برای متمایز کردن کاربران استفاده می شود.
`_gat`	1 دقیقه	برای کاهش نرخ درخواست استفاده می شود. اگر Google Analytics از طریق Google Tag Manager مستقر شود، این کوکی `_dc_gtm_<property- id>` نامیده می شود.
`AMP_TOKEN`	30 ثانیه تا 1 سال	حاوی رمزی است که می تواند برای بازیابی شناسه مشتری از سرویس AMP Client ID استفاده شود. سایر مقادیر ممکن نشانگر انصراف، درخواست در پرواز یا خطا در بازیابی شناسه مشتری از سرویس AMP Client ID است.
`_gac_<property-id>`	90 روز	حاوی اطلاعات مربوط به کمپین برای کاربر است. اگر حساب‌های Google Analytics و Google Ads خود را پیوند داده‌اید، برچسب‌های تبدیل وب‌سایت Google Ads این کوکی را می‌خوانند مگر اینکه انصراف دهید. بیشتر بدانید .

سفارشی سازی

کوکی‌های gtag.js و راهنمای شناسایی کاربر (Universal Analytics) را بخوانید تا بدانید چگونه می‌توان این تنظیمات پیش‌فرض را با gtag.js سفارشی کرد.

راهنمای توسعه‌دهنده دامنه‌ها و کوکی‌های analytics.js را بخوانید تا با همه روش‌هایی که می‌توان این تنظیمات پیش‌فرض را با analytics.js سفارشی کرد، آشنا شوید.

برای اطلاعات بیشتر درباره Universal Analytics و کوکی ها، سند امنیت و حریم خصوصی در Universal Analytics را بخوانید.

ga.js - استفاده از کوکی

کتابخانه جاوا اسکریپت ga.js از کوکی های شخص اول برای موارد زیر استفاده می کند:

تعیین کنید که کدام دامنه را اندازه گیری کنید
متمایز کردن کاربران منحصر به فرد
نرخ درخواست را کاهش دهید
تعداد و زمان بازدیدهای قبلی را به خاطر بسپارید
اطلاعات منبع ترافیک را به خاطر بسپارید
شروع و پایان یک جلسه را مشخص کنید
ارزش متغیرهای سفارشی در سطح بازدیدکننده را به خاطر بسپارید

به طور پیش‌فرض، این کتابخانه کوکی‌ها را روی دامنه مشخص‌شده در ویژگی مرورگر document.host تنظیم می‌کند و مسیر کوکی را روی سطح ریشه (/) تنظیم می‌کند. این کتابخانه کوکی های زیر را تنظیم می کند:

نام کوکی	زمان انقضای پیش فرض	شرح
`__utma`	2 سال از تنظیم / به روز رسانی	برای متمایز کردن کاربران و جلسات استفاده می شود. کوکی زمانی ایجاد می شود که کتابخانه جاوا اسکریپت اجرا شود و هیچ کوکی __utma موجود وجود نداشته باشد. هر بار که داده ها به Google Analytics ارسال می شود، کوکی به روز می شود.
`__utmt`	10 دقیقه	برای کاهش نرخ درخواست استفاده می شود.
`__utmb`	30 دقیقه از تنظیم / به روز رسانی	برای تعیین جلسات/بازدیدهای جدید استفاده می شود. کوکی زمانی ایجاد می شود که کتابخانه جاوا اسکریپت اجرا شود و هیچ کوکی __utmb موجود وجود نداشته باشد. هر بار که داده ها به Google Analytics ارسال می شود، کوکی به روز می شود.
`__utmc`	پایان جلسه مرورگر	در ga.js استفاده نمی شود. تنظیم برای قابلیت همکاری با urchin.js. از لحاظ تاریخی، این کوکی همراه با کوکی `__utmb` برای تعیین اینکه آیا کاربر در یک جلسه/بازدید جدید بوده یا خیر، کار می‌کرد.
`__utmz`	6 ماه از تنظیم / به روز رسانی	منبع ترافیک یا کمپینی را ذخیره می کند که نحوه دسترسی کاربر به سایت شما را توضیح می دهد. کوکی زمانی ایجاد می‌شود که کتابخانه جاوا اسکریپت اجرا می‌شود و هر بار که داده‌ها به Google Analytics ارسال می‌شود، به‌روزرسانی می‌شود.
`__utmv`	2 سال از تنظیم / به روز رسانی	برای ذخیره داده های متغیر سفارشی در سطح بازدیدکننده استفاده می شود. این کوکی زمانی ایجاد می شود که یک توسعه دهنده از متد `_setCustomVar` با یک متغیر سفارشی سطح بازدیدکننده استفاده می کند. این کوکی برای روش `_setVar` منسوخ شده نیز استفاده شد. هر بار که داده ها به Google Analytics ارسال می شود، کوکی به روز می شود.

سفارشی سازی

برای سفارشی کردن نحوه تنظیم کوکی ها می توان از روش های زیر استفاده کرد:

_setDomainName - دامنه ای را تنظیم می کند که همه کوکی ها روی آن تنظیم شوند.
_setCookiePath - مسیری را که تمام کوکی ها در آن تنظیم می شوند را تعیین می کند.
_setVisitorCookieTimeout - انقضای کوکی بازدیدکنندگان Google Analytics را در میلی ثانیه تنظیم می کند.
_setSessionCookieTimeout - زمان پایان کوکی جلسه جدید را در میلی ثانیه تنظیم می کند.
_setCampaignCookieTimeout - زمان انقضای کوکی کمپین را بر حسب میلی ثانیه تنظیم می کند.
_storeGac - برای غیرفعال کردن کوکی GAC، false را پاس کنید. پیش فرض ها به true

راهنمای ردیابی دامنه‌های چندگانه را بخوانید تا نحوه پیکربندی ga.js برای اندازه‌گیری تعامل کاربر در دامنه‌ها را بیاموزید.

urchin.js - استفاده از کوکی

از لحاظ تاریخی، گوگل آنالیتیکس یک کتابخانه اندازه گیری جاوا اسکریپت به نام urchin.js ارائه می کرد. هنگامی که کتابخانه جدیدتر ga.js راه اندازی شد، توسعه دهندگان تشویق شدند تا به کتابخانه جدید مهاجرت کنند. برای سایت‌هایی که انتقال را کامل نکرده‌اند، urchin.js کوکی‌ها را دقیقاً مشابه آنچه در ga.js تنظیم شده است تنظیم می‌کند. برای جزئیات بیشتر، بخش استفاده از کوکی ga.js در بالا را بخوانید.

Google Analytics برای تبلیغ کنندگان نمایش - استفاده از کوکی

برای مشتریانی که از ویژگی‌های تبلیغ‌کننده نمایش Google Analytics استفاده می‌کنند، مانند بازاریابی مجدد ، یک کوکی DoubleClick شخص ثالث علاوه بر سایر کوکی‌های توضیح داده شده در این سند فقط برای این ویژگی‌ها استفاده می‌شود. برای اطلاعات بیشتر در مورد این کوکی، از پرسش‌های متداول حریم خصوصی تبلیغات Google دیدن کنید.

آزمایشات محتوا - استفاده از کوکی

برای وب‌سایت‌هایی که از آزمایش‌های محتوای Google Analytics استفاده می‌کنند، کوکی‌های زیر برای این ویژگی‌ها علاوه بر کوکی‌های دیگر توضیح داده شده در این سند استفاده می‌شوند:

نام کوکی	زمان انقضای پیش فرض	شرح
`__utmx`	18 ماه	برای تعیین گنجاندن کاربر در یک آزمایش استفاده می شود.
`__utmxx`	18 ماه	برای تعیین انقضای آزمایش‌هایی که کاربر در آنها گنجانده شده است استفاده می‌شود.

بهینه سازی - استفاده از کوکی

برای وب‌سایت‌هایی که از Optimize استفاده می‌کنند، از کوکی‌های زیر علاوه بر سایر کوکی‌های شرح داده شده در این سند استفاده می‌شود:

نام کوکی	زمان انقضای پیش فرض	شرح
`_gaexp`	بستگی به طول آزمایش دارد، اما معمولاً 90 روز است.	برای تعیین گنجاندن کاربر در آزمایش و انقضای آزمایش‌هایی که کاربر در آنها گنجانده شده است استفاده می‌شود.
`_opt_awcid`	24 ساعت	برای کمپین‌های نگاشت شده با شناسه‌های مشتری Google Ads استفاده می‌شود.
`_opt_awmid`	24 ساعت	برای کمپین های نگاشت شده با شناسه های کمپین تبلیغاتی گوگل استفاده می شود.
`_opt_awgid`	24 ساعت	برای کمپین‌های نگاشت شده با شناسه‌های گروه تبلیغات Google Ads استفاده می‌شود
`_opt_awkid`	24 ساعت	برای کمپین‌های نگاشت شده با شناسه‌های معیار تبلیغات Google استفاده می‌شود
`_opt_utmc`	24 ساعت	آخرین پارامتر پرس و جو `utm_campaign` را ذخیره می کند.
`_opt_expid`	10 ثانیه	این کوکی هنگام اجرای آزمایش تغییر مسیر ایجاد می شود. شناسه آزمایش، شناسه نوع و ارجاع دهنده به صفحه ای که در حال تغییر مسیر است را ذخیره می کند.