این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پیکربندی

این سند تمام فیلدهای پیکربندی Google Analytics را فهرست می کند.

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 و تبلیغات هدفمند محتوا استفاده می شود. برای متمایز کردن تبلیغات یا پیوندهایی که به URL یکسانی اشاره می کنند، از campaign_content استفاده کنید.

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_content`	`string`	`undefined`

مثال

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

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

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

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

Campaign_id

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_id`	`string`	`undefined`

مثال

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

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

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

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

Campan_Medium

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_medium`	`string`	`undefined`

مثال

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

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

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

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

kampanya_نام

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_name`	`string`	`undefined`

مثال

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

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

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

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

Campaign_source

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_source`	`string`	`undefined`

مثال

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

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

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

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

مبارزات_ترم

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign_term`	`string`	`undefined`

مثال

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

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

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

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

کمپین

یک شی حاوی تمام مقادیر کمپین قابل تنظیم است.

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

Campaign_id
Campaign_source
Campan_Medium
kampanya_نام
مبارزات_ترم
کمپین_محتوا

نام فیلد	تایپ کنید	مقدار پیش فرض
`campaign`	`object`	`undefined`

مثال

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

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

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`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'
});

cookie_domain

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

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

برای تنظیم کوکی روی دامنه سطح بالا به اضافه یک زیر دامنه (eTLD +1) روی '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

هر بار که ضربه ای به Google Analytics ارسال می شود، زمان انقضای کوکی به روز می شود تا زمان فعلی به اضافه مقدار قسمت cookie_expires باشد. این بدان معنی است که اگر از زمان مقدار پیش فرض دو سال (63072000 ثانیه) استفاده کنید و کاربر هر ماه از سایت شما بازدید کند، کوکی آنها هرگز منقضی نمی شود.

اگر زمان 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

وقتی 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 تنظیم کنید تا به Analytics نشان دهد که ارجاع دهنده نباید به عنوان منبع ترافیک نمایش داده شود. یاد بگیرید چه زمانی از این فیلد استفاده کنید

نام فیلد	تایپ کنید	مقدار پیش فرض
`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'
});

page_location

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

نام فیلد	تایپ کنید	مقدار پیش فرض	محدودیت کاراکتر
`page_location`	`string`	مقدار پیش فرض `document.location` است	1000

مثال

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

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

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

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

page_referrer

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

نام فیلد	تایپ کنید	مقدار پیش فرض	محدودیت کاراکتر
`page_referrer`	`string`	مقدار پیش فرض `document.referrer` خواهد بود	420

مثال

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

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

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

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

page_title

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

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

مثال

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

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

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

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

send_page_view

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`send_page_view`	`boolean`	درست است

مثال

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

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

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

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

وضوح_صفحه

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

نام فیلد	تایپ کنید	مقدار پیش فرض
`screen_resolution`	`string`	مقدار پیش فرض از `window.screen` محاسبه می شود

مثال

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

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

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

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

user_id

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

نام فیلد	تایپ کنید	مقدار پیش فرض	محدودیت کاراکتر
`user_id`	`string`		256

مثال

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

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

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

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

user_properties

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

نام فیلد	تایپ کنید	مقدار پیش فرض	محدودیت کاراکتر
`user_properties`	`object`		نام ملک=24 ارزش ملک = 36

مثال

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

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

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

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