کوکی ها را پیکربندی و سفارشی کنید

این صفحه برای توسعه دهندگانی است که می خواهند تنظیمات کوکی را با تگ Google یا Google Tag Manager سفارشی کنند. اگر مطمئن نیستید که آیا نیاز به پیکربندی کوکی‌ها دارید، کوکی‌ها و شناسایی کاربر را بخوانید.

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

اگر فقط می‌خواهید تنظیمات به‌روزرسانی کوکی یا انقضای کوکی را تغییر دهید، می‌توانید تنظیمات پیش‌فرض کوکی را با استفاده از رابط Analytics تغییر دهید .

برای اکثر وب‌سایت‌ها و برنامه‌ها، ذخیره کوکی باید با رضایت کاربر کنترل شود. مروری بر حریم خصوصی کاربر گزینه های موجود برای مدیریت رضایت کاربر را معرفی می کند.

توجه: اگر از تگ Google استفاده می‌کنید و چندین محصول در صفحه‌ای دارید که کوکی‌ها را به اشتراک می‌گذارند، از دستورات gtag('set') به جای gtag('config') برای تنظیمات پیکربندی کوکی خود استفاده کنید. انجام این کار نتایج ثابت تری به شما می دهد.

تغییر دامنه کوکی

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

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

برای ایجاد تغییرات در پیکربندی دامنه کوکی، مراحل زیر را دنبال کنید:

gtag.js

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

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

مدیر تگ

برای تگ گوگل :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک برچسب Google موجود را ویرایش کنید یا یک برچسب جدید ایجاد کنید.

3. در تنظیمات پیکربندی ، یک پارامتر جدید اضافه کنید:

   • نام : cookie_domain
   • ارزش : my.example.com

4. برچسب را ذخیره کنید و ظرف را منتشر کنید.

   برای تبلیغات گوگل و برچسب های Floodlight :

   تنظیمات دامنه را می توان از تگ Conversion Linker تغییر داد:

   1. در Tag Manager، تگ Conversion Linker موجود خود را باز کنید یا اگر برچسب هنوز در ظرف شما وجود ندارد، یکی ایجاد کنید.
   2. در قسمت Linker Options ، روی لغو تنظیمات کوکی (پیشرفته) کلیک کنید
   3. در قسمت Domain ، دامنه بالاترین سطحی را که یک کوکی باید برای آن تنظیم شود، وارد کنید. همچنین می توانید یک مسیر خاص را در قسمت Path تعیین کنید. فقط در صورتی از این تنظیمات استفاده کنید که نیاز دارید کوکی ها را به یک زیر دامنه یا زیر شاخه سطح پایین تر محدود کنید.

برای برچسب های Universal Analytics

1. در Tag Manager، منوی Tags را باز کنید.
2. تگ Universal Analytics موجود را ویرایش کرده و یا یک برچسب جدید ایجاد کنید.
3. یک متغیر تنظیمات Google Analytics جدید ایجاد کنید. Variable Configuration > More Settings > Fields to Set را انتخاب کنید.
4. وقتی بخش Fields to Set بزرگ شد، روی Add Row کلیک کنید.
5. در نام فیلد ، cookieDomain وارد کنید.
6. برای مقدار ، مقدار دامنه را وارد کنید، به عنوان مثال my.example.com .
7. برچسب را ذخیره و منتشر کنید.

تغییر نام کوکی ها

برای جلوگیری از تداخل با سایر کوکی ها، ممکن است لازم باشد نام کوکی را تغییر دهید.

مهم: اگر پس از اولین بازدید کاربران از سایت شما، تنظیمات نام کوکی تغییر کند، آن بازدیدکنندگان به عنوان بازدیدکنندگان جدید ظاهر می شوند زیرا زمینه ذخیره شده در کوکی های اصلاح نشده از بین می رود.

gtag.js

این پیکربندی example به ابتدای کوکی که تنظیم می‌کند اضافه می‌کند (برای مثال _ga تبدیل به example_ga یا _gcl_au تبدیل به example_gcl_au می‌شود):

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

مدیر تگ

برای تگ گوگل :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک برچسب Google موجود را ویرایش کنید یا یک برچسب جدید ایجاد کنید.

3. در تنظیمات پیکربندی ، یک پارامتر جدید اضافه کنید:

   • نام : cookie_prefix
   • ارزش : example

4. برچسب را ذخیره کنید و ظرف را منتشر کنید.

برای برچسب های Universal Analytics :

برچسب‌های Universal Analytics در Tag Manager می‌توانند نام کوکی را با cookieName از طریق متغیر تنظیمات Google Analytics جایگزین کنند.

1. در Tag Manager، یک متغیر تنظیمات Google Analytics را باز کنید و Variable Configuration > More Settings > Fields to Set را انتخاب کنید.
2. وقتی بخش Fields to Set بزرگ شد، روی Add Row کلیک کنید.
3. برای نام فیلد ، cookieName را وارد کنید.
4. برای مقدار ، نام کوکی را وارد کنید، برای مثال myCookie .
5. برچسب را ذخیره و منتشر کنید.

توجه: الگوی تگ Universal Analytics در Tag Manager کل نام کوکی را تغییر می دهد. این رفتار با ویژگی cookie_prefix تگ Google متمایز است که هر دو متن را به ابتدای نام کوکی پیش‌فرض اضافه می‌کنند.

برای تبلیغات گوگل و برچسب های Floodlight :

تنظیمات پیشوند نام را می توان از تگ Conversion Linker تغییر داد:

1.  In Tag Manager, open your existing Conversion Linker tag, or create
    one if the tag doesn't yet exist in your container.

1. در قسمت Linker Options ، روی لغو تنظیمات کوکی (پیشرفته) کلیک کنید
2. در قسمت پیشوند نام ، پیشوند نام مورد نظر را وارد کنید. هر برچسبی که از این کوکی ها استفاده می کند (مثلاً تگ های تبدیل Google Ads) باید برای استفاده از همان پیشوند نیز پیکربندی شود.

انقضای کوکی

در هر صفحه بارگیری، زمان انقضای کوکی به‌روزرسانی می‌شود تا زمان فعلی به اضافه مقدار انقضای کوکی تعیین‌شده توسط تگ Google باشد. این بدان معناست که اگر انقضای کوکی روی یک هفته ( 604800 ثانیه) تنظیم شود و کاربر با استفاده از همان مرورگر در عرض پنج روز بازدید کند، کوکی برای یک هفته دیگر در دسترس خواهد بود و آنها به عنوان همان بازدید کننده در گزارش های شما ظاهر می شوند. اگر همان کاربر در عوض پس از منقضی شدن کوکی اصلی از آن بازدید کرده باشد، یک کوکی جدید ایجاد می‌شود و بازدیدهای اول و دوم آن‌ها به عنوان بازدیدکنندگان مشخص در گزارش‌های شما نشان داده می‌شود.

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

gtag.js

gtag('config', 'TAG_ID', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

مدیر تگ

برای تگ گوگل :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک برچسب Google موجود را ویرایش کنید یا یک برچسب جدید ایجاد کنید.

3. در تنظیمات پیکربندی ، یک پارامتر جدید اضافه کنید:

   • نام : cookie_expires
   • ارزش : 2419200
   توجه: مقدار 2419200 برابر با 28 روز است، اما می توانید هر مدت زمانی را که نیاز دارید تنظیم کنید.

4. برچسب را ذخیره کنید و ظرف را منتشر کنید.

برای برچسب های Universal Analytics :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک تگ Universal Analytics موجود را ویرایش کنید.
3. یک متغیر تنظیمات Google Analytics جدید ایجاد کنید. Variable Configuration > More Settings > Fields to Set را انتخاب کنید.
4. وقتی بخش Fields to Set بزرگ شد، روی Add Row کلیک کنید.
5. در نام فیلد ، cookieExpires وارد کنید.
6. برای مقدار ، تعداد ثانیه های قبل از انقضای کوکی را وارد کنید، به عنوان مثال برای 28 روز، 2419200 وارد کنید.
7. برچسب را ذخیره کنید و ظرف را منتشر کنید.

توجه: کوکی‌های Google Ads و Floodlight که توسط برچسب Conversion Linker تنظیم شده‌اند، در حال حاضر از cookie_expires پشتیبانی نمی‌کنند. اگر پشتیبانی از cookie_expires مورد نیاز است، از gtag.js برای پیکربندی این برچسب استفاده کنید.

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

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

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

gtag.js

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

مدیر تگ

برای تگ گوگل :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک برچسب Google موجود را ویرایش کنید یا یک برچسب جدید ایجاد کنید.

3. در تنظیمات پیکربندی ، یک پارامتر جدید اضافه کنید:

   • نام : cookie_update
   • مقدار : false

4. برچسب را ذخیره کنید و ظرف را منتشر کنید.

   توجه: کوکی‌های Google Ads و Floodlight که توسط برچسب Conversion Linker تنظیم شده‌اند، در حال حاضر cookie_update پشتیبانی نمی‌کنند. اگر پشتیبانی از cookie_update مورد نیاز است، از gtag.js برای پیکربندی این برچسب استفاده کنید.

برای برچسب های Universal Analytics :

1. در فضای کاری خود، منوی برچسب ها را باز کنید.
2. یک تگ Universal Analytics موجود را ویرایش کنید.
3. یک متغیر تنظیمات Google Analytics جدید ایجاد کنید. Variable Configuration > More Settings > Fields to Set را انتخاب کنید.
4. وقتی بخش Fields to Set بزرگ شد، روی Add Row کلیک کنید.
5. در نام فیلد ، cookieUpdate وارد کنید.
6. برای مقدار ، یک مقدار بولی، به عنوان مثال false وارد کنید.
7. برچسب را ذخیره کنید و ظرف را منتشر کنید.