پیکربندی

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

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'
});

camp_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 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 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' (مقدار پیش فرض) تنظیم کنید. به عنوان مثال، اگر 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'
});

هر بار که ضربه ای به 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 روی 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'
});

عنوان صفحه

عنوان صفحه یا سند. پیش‌فرض مقدار 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'
});

شناسه کاربر

یک شناسه شناخته شده برای کاربر ارائه شده توسط مالک سایت/کاربر کتابخانه مشخص می کند. خود نباید 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'
  }
});