پیکربندی

این سند تمام فیلدهای پیکربندی گوگل آنالیتیکس را فهرست می‌کند.

توجه: از هیچ یک از فیلدهای ذکر شده در این صفحه به عنوان نام برای پارامترهای سفارشی خود استفاده نکنید.

allow_google_signals

برای غیرفعال کردن ویژگی‌های تبلیغاتی مبتنی بر شناسه‌های تبلیغاتی شخص ثالث، allow_google_signals را روی false تنظیم کنید.

نام فیلد	نوع	مقدار پیش‌فرض
allow_google_signals	boolean	درست

مثال

تنظیم جهانی

gtag('set', 'allow_google_signals', true);

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

برای غیرفعال کردن ویژگی‌های شخصی‌سازی تبلیغات، روی false تنظیم کنید.

نام فیلد	نوع	مقدار پیش‌فرض
allow_ad_personalization_signals	boolean	درست

مثال

تنظیم جهانی

gtag('set', 'allow_ad_personalization_signals', true);

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

محتوای_کمپین

برای تست A/B و تبلیغات هدفمند محتوا استفاده می‌شود. campaign_content برای تمایز تبلیغات یا لینک‌هایی که به URL یکسانی اشاره می‌کنند، استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_content	string	undefined

مثال

نکته: تنظیم این مقدار، پارامتر کوئری utm_content را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_content', 'logolink');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

شناسه کمپین

برای شناسایی اینکه این ارجاع به کدام کمپین ارجاع می‌دهد، استفاده می‌شود. campaign_id برای شناسایی یک کمپین خاص استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_id	string	undefined

مثال

نکته: تنظیم این مقدار، پارامتر کوئری utm_id را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_id', 'abc.123');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

کمپین_متوسط

campaign_medium برای شناسایی رسانه‌ای مانند ایمیل یا هزینه به ازای هر کلیک استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_medium	string	undefined

مثال

نکته: تنظیم این مقدار، پارامتر کوئری utm_medium را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_medium', 'cpc');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

نام_کمپین

برای تحلیل کلمات کلیدی استفاده می‌شود. campaign_name برای شناسایی یک تبلیغ محصول خاص یا یک کمپین استراتژیک استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_name	string	undefined

مثال

توجه: تنظیم این مقدار، پارامتر کوئری utm_campaign را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_name', 'spring_sale');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

کمپین_منبع

campaign_source برای شناسایی موتور جستجو، نام خبرنامه یا منبع دیگر استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_source	string	undefined

مثال

نکته: تنظیم این مقدار، پارامتر کوئری utm_source را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_source', 'google');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

کمپین_ترم

برای جستجوی پولی استفاده می‌شود. برای یادداشت کلمات کلیدی این تبلیغ campaign_term استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign_term	string	undefined

مثال

نکته: تنظیم این مقدار، پارامتر کوئری utm_term را لغو می‌کند.

تنظیم جهانی

gtag('set', 'campaign_term', 'running+shoes');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

کمپین

یک شیء شامل تمام مقادیر کمپین که می‌توانند تنظیم شوند.

شیء campaign برای پشتیبانی از پیاده‌سازی‌های قدیمی ارائه شده است و در اکثر موارد توصیه نمی‌شود. در عوض، باید از نسخه پیشوندی campaign برای هر فیلد استفاده کنید:

• شناسه کمپین
• کمپین_منبع
• کمپین_متوسط
• نام_کمپین
• کمپین_ترم
• محتوای_کمپین

نکته کلیدی: به جای این فیلد، از نسخه پیشوند campaign_ برای هر مقدار کمپین استفاده کنید.

نام فیلد	نوع	مقدار پیش‌فرض
campaign	object	undefined

مثال

توجه: هرگونه جزئیات کمپینی که ارائه می‌دهید، پارامترهای کوئری utm_ را نادیده می‌گیرد.

تنظیم جهانی

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

شناسه مشتری

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

نام فیلد	نوع	مقدار پیش‌فرض
client_id	string	یک مقدار تصادفی تولید شده برای هر کاربر.

مثال

تنظیم جهانی

gtag('set', 'client_id', 'aaa.bbb');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

گروه_محتوا

نام فیلد	نوع	مقدار پیش‌فرض
content_group	string

مثال

تنظیم جهانی

gtag('set', 'content_group', '/news/sports');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

دامنه کوکی

دامنه مورد استفاده برای ذخیره کوکی تحلیلی را مشخص می‌کند.

برای تنظیم کوکی بدون مشخص کردن دامنه، روی 'none' تنظیم کنید.

برای تنظیم کوکی روی دامنه سطح بالا به علاوه یک زیر دامنه (eTLD +1)، آن را روی 'auto' (auto) تنظیم کنید. برای مثال، اگر cookie_domain روی 'auto' تنظیم شده باشد، https://example.com example.com برای دامنه استفاده می‌کند و https://subdomain.example.com نیز example.com برای دامنه استفاده می‌کند.

نام فیلد	نوع	مقدار پیش‌فرض
cookie_domain	string	'auto'

مثال

تنظیم جهانی

gtag('set', 'cookie_domain', 'example.com');

برای یک جریان واحد تنظیم کنید

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

کوکی_منقضی می‌شود

هر بار که یک بازدید به گوگل آنالیتیکس ارسال می‌شود، زمان انقضای کوکی برابر با زمان فعلی به علاوه‌ی مقدار فیلد cookie_expires به‌روزرسانی می‌شود. این بدان معناست که اگر از مقدار پیش‌فرض زمان دو سال (۶۳۰۷۲۰۰۰ ثانیه) استفاده کنید و کاربری هر ماه از سایت شما بازدید کند، کوکی او هرگز منقضی نخواهد شد.

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

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

نام فیلد	نوع	مقدار پیش‌فرض
cookie_expires	number	63072000

مثال

تنظیم جهانی

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

برای یک جریان واحد تنظیم کنید

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

کوکی_فلگ‌ها

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

نام فیلد	نوع	مقدار پیش‌فرض
cookie_flags	string

مثال

تنظیم جهانی

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

برای یک جریان واحد تنظیم کنید

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

مسیر کوکی

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

نام فیلد	نوع	مقدار پیش‌فرض
cookie_path	string	'/'

مثال

تنظیم جهانی

gtag('set', 'cookie_path', '/example_path');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

پیشوند کوکی

پیشوندی را برای اضافه شدن به نام کوکی‌های تحلیلی مشخص می‌کند.

نام فیلد	نوع	مقدار پیش‌فرض
cookie_prefix	string

مثال

تنظیم جهانی

gtag('set', 'cookie_prefix', 'prefix');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

کوکی_آپدیت

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

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

نام فیلد	نوع	مقدار پیش‌فرض
cookie_update	boolean	true

مثال

تنظیم جهانی

gtag('set', 'cookie_update', true);

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

ignore_referrer

برای اینکه به آنالیتیکس نشان دهید که ارجاع‌دهنده نباید به عنوان منبع ترافیک نمایش داده شود، آن را روی true تنظیم کنید. یاد بگیرید چه زمانی از این فیلد استفاده کنید

نام فیلد	نوع	مقدار پیش‌فرض
ignore_referrer	boolean	نادرست

مثال

تنظیم جهانی

gtag('set', 'ignore_referrer', true);

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

زبان

زبان مورد نظر کاربر را مشخص می‌کند. مقدار پیش‌فرض navigator.language است.

نام فیلد	نوع	مقدار پیش‌فرض
language	string	مقدار پیش‌فرض navigator.language خواهد بود.

مثال

تنظیم جهانی

gtag('set', 'language', 'en-us');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

مکان_صفحه

آدرس کامل صفحه را مشخص می‌کند. به طور پیش‌فرض مقدار document.location کاربر را در نظر می‌گیرد.

نام فیلد	نوع	مقدار پیش‌فرض	محدودیت کاراکتر
page_location	string	مقدار پیش‌فرض document.location است.	۱۰۰۰

مثال

تنظیم جهانی

gtag('set', 'page_location', 'https://example.com/page1');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

ارجاع‌دهنده صفحه

مشخص می‌کند که کدام منبع ارجاع، ترافیک را به یک صفحه آورده است. این مقدار همچنین برای محاسبه منبع ترافیک استفاده می‌شود. قالب این مقدار یک URL است. به طور پیش‌فرض مقدار document.referrer کاربر است.

نام فیلد	نوع	مقدار پیش‌فرض	محدودیت کاراکتر
page_referrer	string	مقدار پیش‌فرض document.referrer خواهد بود.	۴۲۰

مثال

تنظیم جهانی

gtag('set', 'page_referrer', 'https://example.com');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

عنوان صفحه

عنوان صفحه یا سند. به طور پیش‌فرض مقدار document.title کاربر را دارد.

نام فیلد	نوع	مقدار پیش‌فرض	محدودیت کاراکتر
page_title	string	مقدار پیش‌فرض document.title خواهد بود.	۳۰۰

مثال

تنظیم جهانی

gtag('set', 'page_title', 'Settings');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

ارسال_صفحه_مشاهده

برای جلوگیری از ارسال page_view توسط قطعه کد پیش‌فرض، آن را روی false تنظیم کنید.

نام فیلد	نوع	مقدار پیش‌فرض
send_page_view	boolean	درست

مثال

تنظیم جهانی

gtag('set', 'send_page_view', false);

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

وضوح_صفحه

وضوح صفحه نمایش را مشخص می‌کند. باید دو عدد صحیح مثبت باشد که با x از هم جدا شده‌اند. برای مثال، برای صفحه نمایشی با ابعاد ۸۰۰ پیکسل در ۶۰۰ پیکسل، مقدار 800x600 خواهد بود. از مقدار window.screen کاربر محاسبه می‌شود.

نام فیلد	نوع	مقدار پیش‌فرض
screen_resolution	string	مقدار پیش‌فرض از window.screen محاسبه خواهد شد.

مثال

تنظیم جهانی

gtag('set', 'screen_resolution', '800x600');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

شناسه_کاربر

یک شناسه شناخته‌شده برای یک کاربر که توسط مالک سایت/کاربر کتابخانه ارائه شده است را مشخص می‌کند. خود این شناسه نباید PII (اطلاعات شخصی قابل شناسایی) باشد. این مقدار هرگز نباید در کوکی‌های Google Analytics یا سایر فضای ذخیره‌سازی ارائه شده توسط Analytics ذخیره شود.

نام فیلد	نوع	مقدار پیش‌فرض	محدودیت کاراکتر
user_id	string		۲۵۶

مثال

تنظیم جهانی

gtag('set', 'user_id', 'id');

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

ویژگی‌های کاربر

ویژگی‌های کاربر، ویژگی‌هایی هستند که می‌توانند برای توصیف بخش‌هایی از پایگاه کاربر شما، مانند ترجیح زبان یا موقعیت جغرافیایی، استفاده شوند. حداکثر ۲۵ ویژگی کاربر اضافی را می‌توان برای هر پروژه تنظیم کرد.

نام فیلد	نوع	مقدار پیش‌فرض	محدودیت کاراکتر
user_properties	object		نام ملک=24 ارزش ملک=۳۶

مثال

تنظیم جهانی

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

برای یک جریان واحد تنظیم کنید

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});