پیکربندی

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

allow_google_signals

برای غیرفعال کردن گزارش‌های جمعیت‌شناسی و علاقه Google Analytics براساس شناسه تبلیغات طرف سوم، allow_google_signals را روی false تنظیم کنید.

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

allow_ad_personalization_signals

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_content

برای آزمایش A/B و آگهی‌های هدف‌یابی محتوا استفاده می‌شود. از campaign_content برای متمایز کردن آگهی‌ها یا پیوندهایی که به نشانی وب یکسانی اشاره می‌کنند استفاده کنید.

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_id

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_medium

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_name

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_source

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

campaign_term

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

پویش

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

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

• campaign_id
• campaign_source
• campaign_medium
• campaign_name
• campaign_term
• campaign_content

مثال

تنظیم جهانی

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

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

content_group

مثال

تنظیم جهانی

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 برای دامنه استفاده می‌کند.

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

cookie_expires

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

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

مثال

تنظیم جهانی

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

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

cookie_path

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

cookie_prefix

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

cookie_update

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

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

ignore_referrer

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

زبان

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

page_location

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

page_referrer

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

page_title

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

send_page_view

برای جلوگیری از ارسال صفحه_بازدید توسط تکه‌کد پیش‌فرض، روی «نادرست» تنظیم کنید.

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

screen_resolution

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

user_id

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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

به‌روز کردن

اگر روی true تنظیم شود، پارامتر update پارامترهای جدید یا به‌روزرسانی‌شده را در پیکربندی برچسب Google موجود ادغام می‌کند اما رویداد page_view را برای آن به‌روزرسانی ارسال نمی‌کند. این معمولاً در برنامه‌های تک‌صفحه‌ای برای به‌روزرسانی پارامترها بدون مقداردهی مجدد برچسب استفاده می‌شود.

مثال

تنظیم برای یک جاری‌سازی

gtag('config', 'STREAM_ID', {
  'update': true,
  'page_location': 'https://example.com/new-page'
});

user_properties

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

مثال

تنظیم جهانی

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

تنظیم برای یک جاری‌سازی

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