از 1 ژوئیه 2023، ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را متوقف می‌کند (1 ژوئیه 2024 برای دارایی‌های UA 360). مهاجرت به Google Analytics 4 .

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

Switch to English

مرجع فیلد Analytics.js

این سند همه نام‌های فیلد قابل تنظیم برای analytics.js را فهرست می‌کند.

فقط فیلدها را ایجاد کنید
عمومی
کاربر
جلسه
منابع ترافیک
اطلاعات سیستم
اصابت
اطلاعات محتوا
برنامه ها
مناسبت ها
تجارت الکترونیکی پیشرفته
تعاملات اجتماعی
زمان سنجی
استثناها
ابعاد / معیارهای سفارشی

فقط فیلدها را ایجاد کنید

فیلدهای زیر را فقط می‌توان در روش create تنظیم کرد. برای جزئیات بیشتر، بخش Creating Tracker Objects را در راهنمای تنظیمات پیشرفته بخوانید.

شناسه ردیابی/ شناسه دارایی وب

برای همه انواع ضربه مورد نیاز است.

شناسه ردیابی / شناسه دارایی وب. فرمت UA-XXXX-Y است. تمام داده های جمع آوری شده توسط این شناسه مرتبط می شود.

نام زمینه	نوع ارزش	مقدار پیش فرض
`trackingId`	متن	هیچ یک

مقدار مثال: UA-XXXX-Y
مثال استفاده:

ga('create', 'UA-XXXX-Y');

// Alerts the tracking ID for the default tracker.
ga(function(tracker) {
  alert(tracker.get('trackingId'));
});

نام ردیاب

اختیاری. این ممکن است فقط در روش create تنظیم شود.

نام شی ردیاب.

نام زمینه	نوع ارزش	مقدار پیش فرض
`name`	متن	`t0`

مقدار مثال: myTracker
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});

شناسه مشتری

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`clientId`	متن	`Randomly Generated`

مقدار مثال: 35009a79-1a05-49d7-b876-2b884d0f825b
مثال استفاده:

ga('create', 'UA-XXXX-Y', {
  'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});

نرخ نمونه

اختیاری. این ممکن است فقط در روش create تنظیم شود.

مشخص می کند که چند درصد از کاربران باید ردیابی شوند. این به طور پیش‌فرض روی 100 است (هیچ کاربر نمونه‌گیری نمی‌شود) اما سایت‌های بزرگ ممکن است نیاز به استفاده از نرخ نمونه پایین‌تری داشته باشند تا در محدوده‌های پردازش Google Analytics باقی بمانند.

نام زمینه	نوع ارزش	مقدار پیش فرض
`sampleRate`	عدد	`100`

مقدار مثال: 5
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'sampleRate': 5});

نرخ نمونه سرعت سایت

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`siteSpeedSampleRate`	عدد	`1`

مقدار مثال: 10
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});

همیشه ارجاع ارسال کنید

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`alwaysSendReferrer`	بولی	`false`

مقدار مثال: true
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});

پارامترهای Anchor را مجاز کنید

اختیاری. این ممکن است فقط در روش create تنظیم شود.

به طور پیش‌فرض، analytics.js پارامترهای کمپین سفارشی مانند utm_source، utm_medium و غیره را هم در رشته کوئری و هم در لنگر URL صفحه فعلی جستجو می‌کند. تنظیم این فیلد روی false منجر به نادیده گرفتن پارامترهای کمپین سفارشی می شود که در انکر ظاهر می شود.

نام زمینه	نوع ارزش	مقدار پیش فرض
`allowAnchor`	بولی	`true`

مقدار مثال: false
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'allowAnchor': false});

نام کوکی

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`cookieName`	متن	`_ga`

مقدار مثال: gaCookie
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});

دامنه کوکی

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`cookieDomain`	متن	`document.location.hostname (normalized)`

مقدار مثال: example.com
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});

پرچم های کوکی

اختیاری. این ممکن است فقط در روش create تنظیم شود.

پرچم های اضافی را برای اضافه کردن به کوکی مشخص می کند. پرچم ها باید با نقطه ویرگول از هم جدا شوند.

نام زمینه	نوع ارزش	مقدار پیش فرض
`cookieFlags`	متن	هیچ یک

مقدار مثال: SameSite=None; Secure
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'cookieFlags': 'SameSite=None; Secure'});

انقضای کوکی

اختیاری. این ممکن است فقط در روش create تنظیم شود.

انقضای کوکی را در چند ثانیه مشخص می کند.

نام زمینه	نوع ارزش	مقدار پیش فرض
`cookieExpires`	عدد صحیح	`63072000 (two years)`

مقدار مثال: 86400
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});

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

اختیاری. این ممکن است فقط در روش create تنظیم شود.

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

نام زمینه	نوع ارزش	مقدار پیش فرض
`cookieUpdate`	بولی	`true`

مقدار مثال: true
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});

فروشگاه GAC

اختیاری. این ممکن است فقط در روش create تنظیم شود.

به طور پیش فرض analytics.js یک کوکی برای ذخیره اطلاعات کمپین می نویسد. از این فیلد می توان برای غیرفعال کردن نوشتن آن کوکی استفاده کرد.

نام زمینه	نوع ارزش	مقدار پیش فرض
`storeGac`	بولی	`true`

مقدار مثال: false
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'storeGac': false});

دامنه کوکی قدیمی

اختیاری. این ممکن است فقط در روش create تنظیم شود.

این فیلد برای پیکربندی نحوه جستجوی کوکی‌های ایجاد شده توسط اسکریپت‌های قبلی Google Analytics مانند ga.js و urchin.js از analytics.js استفاده می‌شود.

نام زمینه	نوع ارزش	مقدار پیش فرض
`legacyCookieDomain`	متن	هیچ یک

مقدار مثال: store.example.com
مثال استفاده:

ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});

واردات تاریخچه میراث

اختیاری. این ممکن است فقط در روش create تنظیم شود.

مشخص می‌کند که آیا analytics.js باید داده‌های تاریخچه را از کوکی‌های ga.js وارد کند یا خیر.

نام زمینه	نوع ارزش	مقدار پیش فرض
`legacyHistoryImport`	بولی	`true`

مقدار مثال: false
مثال استفاده:

ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});

پارامترهای Linker را مجاز کنید

اختیاری. این ممکن است فقط در روش create تنظیم شود.

تنظیم این فیلد روی true will تجزیه پارامترهای پیوند دهنده متقابل دامنه ای را که برای انتقال حالت در دامنه ها استفاده می شود، امکان پذیر می کند.

نام زمینه	نوع ارزش	مقدار پیش فرض
`allowLinker`	بولی	`false`

مقدار مثال: true
مثال استفاده:

ga('create', 'UA-XXXX-Y', {allowLinker: true});

عمومی

اجازه دادن به ویژگی های تبلیغاتی

اختیاری.

زمانی که این ویژگی ها از طریق افزونه displayfeatures یا از داخل Google Analytics (تنظیمات ویژگی > مجموعه داده) فعال شده باشند، این فیلد را روی false تنظیم کنید تا نشانگرها را برای ویژگی های تبلیغاتی Google Analytics غیرفعال کنید.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`allowAdFeatures`	هیچ یک	بولی	`true`	N/A	همه

مقدار مثال: false
مثال استفاده:

ga('set', 'allowAdFeatures', false)

ماسک IP

اختیاری.

در صورت وجود، آدرس IP فرستنده پنهان می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`anonymizeIp`	`aip`	بولی	هیچ یک	N/A	همه

مقدار مثال: true
مثال استفاده:

ga('set', 'anonymizeIp', true);

منبع اطلاعات

اختیاری.

منبع داده ضربه را نشان می دهد. بازدیدهای ارسال شده از analytics.js دارای منبع داده روی "وب" خواهند بود. بازدیدهای ارسال شده از یکی از SDK های تلفن همراه دارای منبع داده روی "برنامه" خواهند بود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`dataSource`	`ds`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: crm
مثال استفاده:

ga('set', 'dataSource', 'crm');

زمان صف

اختیاری.

برای جمع آوری بازدیدهای آفلاین / پنهان استفاده می شود. این مقدار نشان‌دهنده زمان دلتا (بر حسب میلی‌ثانیه) از زمان وقوع ضربه گزارش‌شده و زمان ارسال ضربه است. مقدار باید بزرگتر یا مساوی 0 باشد. مقادیر بیشتر از چهار ساعت ممکن است منجر به عدم پردازش بازدیدها شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`queueTime`	`qt`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 560
مثال استفاده:

ga('set', 'queueTime', 560);

SSL را اجباری کنید

اختیاری.

به‌طور پیش‌فرض، بیکن‌های ارسال شده از صفحات https با استفاده از https ارسال می‌شوند در حالی که بیکن‌های ارسال شده از صفحات http با استفاده از http ارسال می‌شوند. تنظیم forceSSL روی true، صفحات http را مجبور می‌کند تا تمام بیکن‌ها را با استفاده از https ارسال کنند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`forceSSL`	هیچ یک	بولی	`false`	N/A	همه

مقدار مثال: true
مثال استفاده:

ga('set', 'forceSSL', true);

حمل و نقل

اختیاری.

این مکانیسم انتقال بازدیدها را مشخص می کند. گزینه‌ها "beacon"، "xhr" یا "image" هستند. به طور پیش فرض، analytics.js سعی می کند بهترین روش را بر اساس اندازه بازدید و قابلیت های مرورگر کشف کند. اگر «beacon» را مشخص کنید و مرورگر کاربر از روش «navigator.sendBeacon» پشتیبانی نمی‌کند، بسته به اندازه ضربه به «تصویر» یا «xhr» برمی‌گردد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`transport`	هیچ یک	متن	`none (automatically determined)`	هیچ یک	همه

مقدار مثال: beacon
مثال استفاده:

ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});

از Beacon استفاده کنید

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`useBeacon`	هیچ یک	بولی	`false`	N/A	همه

مقدار مثال: true
مثال استفاده:

ga('send', 'event', 'click', 'download-me', {useBeacon: true});

پارامتر پیوند دهنده

اختیاری.

پارامتر پیوند دهنده برای اندازه گیری متقابل دامنه.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`linkerParam`	هیچ یک	متن	هیچ یک	هیچ یک	همه

مقدار مثال: _ga=1.231587807.1974034684.1435105198
مثال استفاده:

// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
  alert(tracker.get('linkerParam'));
});

برگشت به تماس را بزنید

اختیاری.

تابعی که پس از پردازش یک ضربه فراخوانی می شود. این تماس برگشتی طوری طراحی شده است که همیشه پس از ارسال موفقیت آمیز ضربه یا زمانی که مشخص شد که ضربه ارسال نمی شود یا ارسال نشد، تماس گرفته شود. هنگام فراخوانی، هیچ آرگومانی به تابع ارسال نمی شود. ممکن است بخواهید از استفاده از hitcallBack برای اجرای کدی که برای برنامه شما حیاتی است اجتناب کنید، زیرا ممکن است در موارد نادری (مثلاً اگر سرور پاسخ ندهد یا analytics.js بارگیری نشود) تماس گرفته نشود. در این حالت می توانید برای اطمینان از اجرا، یک بازه زمانی تعیین کنید.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`hitCallback`	هیچ یک	تابع	هیچ یک	هیچ یک	همه

مثال استفاده:

// Alerts the user when a hit is sent.
ga('send', 'pageview', {
  'hitCallback': function() {
    alert('hit sent');
  }
});

// Use a timeout to ensure the execution of critical application code.
ga('send', 'pageview', {'hitCallback': criticalCode});
setTimeout(criticalCode, 2000);

// Only run the critical code once.
var alreadyCalled = false;
function criticalCode() {
  if (alreadyCalled) return;
  alreadyCalled = true;

  // Run critical code here...
}

کاربر

شناسه کاربر

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`userId`	`uid`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: as8eknlll
مثال استفاده:

// Set the user ID when creating the tracker.
ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'});

// Alternatively, you may set the user ID via the `set` method.
ga('set', 'userId', 'as8eknlll');

جلسه

کنترل جلسه

اختیاری.

برای کنترل مدت جلسه استفاده می شود. مقدار 'شروع' جلسه جدیدی را مجبور می کند با این ضربه شروع شود و 'پایان' جلسه فعلی را مجبور می کند با این ضربه پایان یابد. تمام مقادیر دیگر نادیده گرفته می شوند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`sessionControl`	`sc`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: start
مثال استفاده:

// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});

منابع ترافیک

ارجاع دهنده سند

اختیاری.

مشخص می کند که کدام منبع ارجاع ترافیک را به یک وب سایت آورده است. این مقدار برای محاسبه منبع ترافیک نیز استفاده می شود. فرمت این مقدار یک URL است. این فیلد با دستور ایجاد مقدار دهی اولیه می شود و تنها زمانی تنظیم می شود که نام میزبان فعلی با نام میزبان ارجاع دهنده متفاوت باشد، مگر اینکه فیلد "alwaysSendReferrer" روی درست تنظیم شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`referrer`	`dr`	متن	`document.referrer`	2048 بایت	همه

مقدار مثال: http://example.com
مثال استفاده:

ga('set', 'referrer', 'http://example.com');

نام کمپین

اختیاری.

نام کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignName`	`cn`	متن	هیچ یک	100 بایت	همه

مقدار مثال: (direct)
مثال استفاده:

ga('set', 'campaignName', '(direct)');

منبع کمپین

اختیاری.

منبع کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignSource`	`cs`	متن	هیچ یک	100 بایت	همه

مقدار مثال: (direct)
مثال استفاده:

ga('set', 'campaignSource', '(direct)');

رسانه کمپین

اختیاری.

رسانه کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignMedium`	`cm`	متن	هیچ یک	50 بایت	همه

ارزش مثال: organic
مثال استفاده:

ga('set', 'campaignMedium', 'organic');

کلمه کلیدی کمپین

اختیاری.

کلمه کلیدی کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignKeyword`	`ck`	متن	هیچ یک	500 بایت	همه

ارزش مثال: Blue Shoes
مثال استفاده:

ga('set', 'campaignKeyword', 'Blue Shoes');

محتوای کمپین

اختیاری.

محتوای کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignContent`	`cc`	متن	هیچ یک	500 بایت	همه

ارزش مثال: content
مثال استفاده:

ga('set', 'campaignContent', 'content');

شناسه کمپین

اختیاری.

شناسه کمپین را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`campaignId`	`ci`	متن	هیچ یک	100 بایت	همه

مقدار مثال: ID
مثال استفاده:

ga('set', 'campaignId', 'ID');

اطلاعات سیستم

وضوح صفحه

اختیاری.

وضوح صفحه نمایش را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`screenResolution`	`sr`	متن	هیچ یک	20 بایت	همه

مقدار مثال: 800x600
مثال استفاده:

ga('set', 'screenResolution', '800x600');

اندازه پورت دید

اختیاری.

ناحیه قابل مشاهده مرورگر / دستگاه را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`viewportSize`	`vp`	متن	هیچ یک	20 بایت	همه

مقدار مثال: 123x456
مثال استفاده:

ga('set', 'viewportSize', '123x456');

رمزگذاری سند

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`encoding`	`de`	متن	`UTF-8`	20 بایت	همه

مقدار مثال: UTF-8
مثال استفاده:

ga('set', 'encoding', 'UTF-16');

رنگ های صفحه نمایش

اختیاری.

عمق رنگ صفحه را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`screenColors`	`sd`	متن	هیچ یک	20 بایت	همه

مقدار مثال: 24-bits
مثال استفاده:

ga('set', 'screenColors', '8-bit');

زبان کاربر

اختیاری.

زبان را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`language`	`ul`	متن	هیچ یک	20 بایت	همه

مقدار مثال: en-us
مثال استفاده:

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

جاوا فعال است

اختیاری.

مشخص می کند که جاوا فعال باشد یا خیر. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`javaEnabled`	`je`	بولی	هیچ یک	N/A	همه

مقدار مثال: true
مثال استفاده:

ga('set', 'javaEnabled', true);

نسخه فلش

اختیاری.

نسخه فلش را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`flashVersion`	`fl`	متن	هیچ یک	20 بایت	همه

مقدار مثال: 10 1 r103
مثال استفاده:

ga('set', 'flashVersion', '10 1 r103');

اصابت

نوع ضربه

برای همه انواع ضربه مورد نیاز است.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`hitType`	`t`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: pageview
مثال استفاده:

ga('send', {
  'hitType': 'pageview',
  'page': '/home'
});

ضربه بدون تعامل

اختیاری.

مشخص می کند که یک ضربه غیر تعاملی در نظر گرفته شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`nonInteraction`	`ni`	بولی	هیچ یک	N/A	همه

مقدار مثال: true
مثال استفاده:

ga('set', 'nonInteraction', true);

اطلاعات محتوا

نشانی وب مکان سند

اختیاری.

URL کامل صفحه (به استثنای لنگر) را مشخص می کند. این فیلد با دستور create مقداردهی اولیه می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`location`	`dl`	متن	هیچ یک	2048 بایت	همه

مقدار مثال: http://foo.com/home?a=b
مثال استفاده:

ga('set', 'location', 'http://foo.com/home?a=b');

نام میزبان سند

اختیاری.

نام میزبانی را که محتوا از آن میزبانی شده است را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`hostname`	`dh`	متن	هیچ یک	100 بایت	همه

مقدار مثال: foo.com
مثال استفاده:

ga('set', 'hostname', 'foo.com');

مسیر سند

اختیاری.

قسمت مسیر URL صفحه. باید با '/' شروع شود. برای بازدیدهای «نمایش صفحه»، باید &dl یا هر دو &dh و &dp مشخص شوند تا ضربه معتبر باشد. برای تعیین مسیرهای صفحه مجازی استفاده می شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`page`	`dp`	متن	هیچ یک	2048 بایت	همه

مقدار مثال: /foo
مثال استفاده:

ga('set', 'page', '/foo');

عنوان سند

اختیاری.

عنوان صفحه / سند. پیش‌فرض document.title.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`title`	`dt`	متن	هیچ یک	1500 بایت	همه

مقدار مثال: Settings
مثال استفاده:

ga('set', 'title', 'Settings');

نام صفحه نمایش

برای نوع ضربه نمایش صفحه مورد نیاز است.

این پارامتر در ویژگی‌های وب اختیاری است و در ویژگی‌های تلفن همراه برای بازدید از صفحه نمایش مورد نیاز است، جایی که برای «نام صفحه» بازدید از صفحه نمایش استفاده می‌شود. در ویژگی‌های وب، با استفاده از پارامتر &dl همانطور که هست یا جمع‌آوری آن از &dh و &dp، به‌طور پیش‌فرض به URL منحصربه‌فرد صفحه تبدیل می‌شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`screenName`	`cd`	متن	هیچ یک	2048 بایت	نمایش صفحه نمایش

مقدار مثال: High Scores
مثال استفاده:

ga('set', 'screenName', 'High Scores');

گروه محتوا

اختیاری.

شما می توانید حداکثر 5 گروه بندی محتوا داشته باشید که هر کدام دارای یک فهرست مرتبط بین 1 تا 5 هستند. هر گروه محتوا می تواند تا 100 گروه محتوا داشته باشد. مقدار یک گروه محتوا متن سلسله مراتبی است که با '/ مشخص شده است. همه اسلش های اصلی و انتهایی حذف می شوند و هر اسلش تکراری به یک اسلش کاهش می یابد. به عنوان مثال، '/a//b/' به تبدیل می شود "a/b".

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`contentGroup`	`cg<groupIndex>`	متن	هیچ یک	100 بایت	همه

ارزش مثال: news/sports
مثال استفاده:

ga('set', 'contentGroup5', '/news/sports');

شناسه پیوند

اختیاری.

شناسه یک عنصر DOM کلیک‌شده، برای رفع ابهام چندین پیوند به یک URL در گزارش‌های In-Page Analytics وقتی که Attribution Link Enhanced برای ویژگی فعال است، استفاده می‌شود.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`linkid`	`linkid`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: nav_bar
مثال استفاده:

ga('set', '&linkid', 'html-element-id');

برنامه ها

نام نرم افزار

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`appName`	`an`	متن	هیچ یک	100 بایت	همه

مقدار مثال: My App
مثال استفاده:

ga('set', 'appName', 'My App');

شناسه برنامه

اختیاری.

شناسه برنامه

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`appId`	`aid`	متن	هیچ یک	150 بایت	همه

مقدار مثال: com.company.app
مثال استفاده:

ga('set', 'appId', 'com.company.app');

نسخه برنامه

اختیاری.

نسخه برنامه را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`appVersion`	`av`	متن	هیچ یک	100 بایت	همه

مقدار مثال: 1.2
مثال استفاده:

ga('set', 'appVersion', '1.2');

شناسه نصب کننده برنامه

اختیاری.

شناسه نصب کننده برنامه

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`appInstallerId`	`aiid`	متن	هیچ یک	150 بایت	همه

مقدار مثال: com.platform.vending
مثال استفاده:

ga('set', 'appInstallerId', 'com.platform.vending');

مناسبت ها

دسته رویداد

برای نوع ضربه رویداد مورد نیاز است.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`eventCategory`	`ec`	متن	هیچ یک	150 بایت	رویداد

مقدار مثال: Category
مثال استفاده:

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

اقدام رویداد

برای نوع ضربه رویداد مورد نیاز است.

عمل رویداد را مشخص می کند. نباید خالی باشه

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`eventAction`	`ea`	متن	هیچ یک	500 بایت	رویداد

مقدار مثال: Action
مثال استفاده:

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

برچسب رویداد

اختیاری.

برچسب رویداد را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`eventLabel`	`el`	متن	هیچ یک	500 بایت	رویداد

مقدار مثال: Label
مثال استفاده:

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventLabel': 'Label'
});

ارزش رویداد

اختیاری.

مقدار رویداد را مشخص می کند. ارزش ها باید غیر منفی باشند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`eventValue`	`ev`	عدد صحیح	هیچ یک	هیچ یک	رویداد

مقدار مثال: 55
مثال استفاده:

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventValue': 55
});

تجارت الکترونیکی پیشرفته

SKU محصول

اختیاری.

SKU محصول. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) id`	`pr<productIndex>id`	متن	هیچ یک	500 بایت	همه

مقدار مثال: P12345
مثال استفاده:

ga('ec:addProduct', {'id': 'P12345'});

نام محصول

اختیاری.

نام محصول. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) name`	`pr<productIndex>nm`	متن	هیچ یک	500 بایت	همه

مقدار مثال: Android T-Shirt
مثال استفاده:

ga('ec:addProduct', {'name': 'Android T-Shirt'});

نام تجاری محصول

اختیاری.

برند مرتبط با محصول شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) brand`	`pr<productIndex>br`	متن	هیچ یک	500 بایت	همه

مقدار مثال: Google
مثال استفاده:

ga('ec:addProduct', {'brand': 'Google'});

رده محصولات

اختیاری.

دسته ای که محصول به آن تعلق دارد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. پارامتر دسته محصول می تواند سلسله مراتبی باشد. از / به عنوان یک جداکننده برای تعیین حداکثر 5 سطح سلسله مراتب استفاده کنید. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) category`	`pr<productIndex>ca`	متن	هیچ یک	500 بایت	همه

ارزش مثال: Apparel
مثال استفاده:

ga('ec:addProduct', {'category': 'Apparel'});

نوع محصول

اختیاری.

نوع محصول. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) variant`	`pr<productIndex>va`	متن	هیچ یک	500 بایت	همه

مقدار مثال: Black
مثال استفاده:

ga('ec:addProduct', {'variant': 'Black'});

قیمت کالا

اختیاری.

قیمت واحد یک محصول شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) price`	`pr<productIndex>pr`	واحد پول	هیچ یک	هیچ یک	همه

مقدار مثال: 29.20
مثال استفاده:

ga('ec:addProduct', {'price': '29.20'});

مقدار محصول

اختیاری.

مقدار یک محصول. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) quantity`	`pr<productIndex>qt`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 2
مثال استفاده:

ga('ec:addProduct', {'quantity': 2});

کد کوپن محصول

اختیاری.

کد کوپن مرتبط با یک محصول. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) coupon`	`pr<productIndex>cc`	متن	هیچ یک	500 بایت	همه

مقدار مثال: SUMMER_SALE13
مثال استفاده:

ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});

موقعیت محصول

اختیاری.

موقعیت محصول در یک لیست یا مجموعه. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) position`	`pr<productIndex>ps`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 2
مثال استفاده:

ga('ec:addProduct', {'position': 2});

ابعاد سفارشی محصول

اختیاری.

یک بعد سفارشی در سطح محصول که در آن شاخص ابعاد یک عدد صحیح مثبت بین 1 تا 200 است. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) dimension`	`pr<productIndex>cd<dimensionIndex>`	متن	هیچ یک	150 بایت	همه

مقدار مثال: Member
مثال استفاده:

ga('ec:addProduct', {'dimension1': 'Member'});

متریک سفارشی محصول

اختیاری.

یک متریک سفارشی در سطح محصول که در آن شاخص متریک یک عدد صحیح مثبت بین 1 تا 200 است. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product) metric`	`pr<productIndex>cm<metricIndex>`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 28
مثال استفاده:

ga('ec:addProduct', {'metric1': 28});

اقدام محصول

اختیاری.

نقش محصولات موجود در یک ضربه. اگر یک عملکرد محصول مشخص نشده باشد، تمام تعاریف محصول که با ضربه وارد شده است نادیده گرفته می شود. باید یکی از موارد زیر باشد: جزئیات، کلیک، افزودن، حذف، پرداخت، checkout_option، خرید، بازپرداخت. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action)`	`pa`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: detail
مثال استفاده:

ga('ec:setAction', 'detail');

شناسه تراکنش

اختیاری.

شناسه تراکنش این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) id`	`ti`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: T1234
مثال استفاده:

ga('ec:setAction', 'purchase', {'id': 'T1234'});

وابستگی

اختیاری.

فروشگاه یا وابستگی که این تراکنش از آن انجام شده است. این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) affiliation`	`ta`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Google Store
مثال استفاده:

ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});

درآمد

اختیاری.

ارزش کل معامله، از جمله مالیات و حمل و نقل. در صورت عدم ارسال، این مقدار به صورت خودکار با استفاده از فیلدهای مقدار محصول و قیمت همه محصولات در همان ضربه محاسبه می شود. این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) revenue`	`tr`	واحد پول	هیچ یک	هیچ یک	همه

مقدار مثال: 123.21
مثال استفاده:

ga('ec:setAction', 'purchase', {'revenue': '123.21'});

مالیات

اختیاری.

کل مالیات مربوط به معامله. این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) tax`	`tt`	واحد پول	هیچ یک	هیچ یک	همه

مقدار مثال: 10.78
مثال استفاده:

ga('ec:setAction', 'purchase', {'tax': '10.78'});

حمل دریایی

اختیاری.

هزینه حمل و نقل مرتبط با معامله. این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) shipping`	`ts`	واحد پول	هیچ یک	هیچ یک	همه

مقدار مثال: 3.55
مثال استفاده:

ga('ec:setAction', 'purchase', {'shipping': '3.55'});

کد کوپن

اختیاری.

کوپن معامله با معامله بازخرید شد. این یک پارامتر اضافی است که می‌تواند زمانی که Product Action روی «خرید» یا «بازپرداخت» تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) coupon`	`tcc`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: SUMMER08
مثال استفاده:

ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});

لیست اقدام محصول

اختیاری.

فهرست یا مجموعه ای که یک اقدام محصول از آن رخ داده است. این یک پارامتر اضافی است که می تواند زمانی که Product Action روی "جزئیات" یا "کلیک" تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) list`	`pal`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Search Results
مثال استفاده:

ga('ec:setAction', 'click', {'list': 'Search Results'});

مرحله پرداخت

اختیاری.

شماره مرحله در یک قیف پرداخت. این یک پارامتر اضافی است که می تواند زمانی که Product Action روی "تسویه حساب" تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) step`	`cos`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 2
مثال استفاده:

ga('ec:setAction', 'checkout', {'step': 2});

گزینه مرحله پرداخت

اختیاری.

اطلاعات اضافی درباره مرحله تسویه حساب. این یک پارامتر اضافی است که می تواند زمانی که Product Action روی "تسویه حساب" تنظیم شده است ارسال شود. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(product action) option`	`col`	متن	هیچ یک	هیچ یک	همه

ارزش مثال: Visa
مثال استفاده:

ga('ec:setAction', 'checkout', {'option': 'Visa'});

نام فهرست نمایش محصول

اختیاری.

فهرست یا مجموعه ای که یک محصول به آن تعلق دارد. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) list`	`il<listIndex>nm`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Search Results
مثال استفاده:

ga('ec:addImpression', {'list': 'Search Results'});

SKU نمایش محصول

اختیاری.

شناسه محصول یا SKU. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) id`	`il<listIndex>pi<productIndex>id`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: P67890
مثال استفاده:

ga('ec:addImpression', {'id': 'P67890'});

نام نمایش محصول

اختیاری.

نام محصول. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) name`	`il<listIndex>pi<productIndex>nm`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Android T-Shirt
مثال استفاده:

ga('ec:addImpression', {'name': 'Android T-Shirt'});

برند تاثیرگذار محصول

اختیاری.

برند مرتبط با محصول فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) brand`	`il<listIndex>pi<productIndex>br`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Google
مثال استفاده:

ga('ec:addImpression', {'brand': 'Google'});

دسته نمایش محصول

اختیاری.

دسته ای که محصول به آن تعلق دارد. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) category`	`il<listIndex>pi<productIndex>ca`	متن	هیچ یک	هیچ یک	همه

ارزش مثال: Apparel
مثال استفاده:

ga('ec:addImpression', {'category': 'Apparel'});

نوع برداشت محصول

اختیاری.

نوع محصول. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) variant`	`il<listIndex>pi<productIndex>va`	متن	هیچ یک	هیچ یک	همه

مقدار مثال: Black
مثال استفاده:

ga('ec:addImpression', {'variant': 'Black'});

موقعیت نمایش محصول

اختیاری.

موقعیت محصول در یک لیست یا مجموعه. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شده باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(impression) position`	`il<listIndex>pi<productIndex>ps`	عدد صحیح	هیچ یک	هیچ یک	همه

مقدار مثال: 2
مثال استفاده:

ga('ec:addImpression', {'position': 2});

قیمت برداشت محصول

اختیاری.

قیمت یک محصول. فهرست Impression List باید یک عدد صحیح مثبت بین 1 تا 200 باشد. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(impression) price`	`il<listIndex>pi<productIndex>pr`	currency	None	None	all

Example value: 29.20
Example usage:

ga('ec:addImpression', {'price': '29.20'});

Product Impression Custom Dimension

Optional.

A product-level custom dimension where dimension index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(impression) dimension`	`il<listIndex>pi<productIndex>cd<dimensionIndex>`	text	None	None	all

Example value: Member
Example usage:

ga('ec:addImpression', {'dimension1': 'Member'});

Product Impression Custom Metric

Optional.

A product-level custom metric where metric index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(impression) metric`	`il<listIndex>pi<productIndex>cm<metricIndex>`	integer	None	None	all

Example value: 28
Example usage:

ga('ec:addImpression', {'metric1': '28'});

Optional.

The promotion ID. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(promo) id`	`promo<promoIndex>id`	text	None	None	all

Example value: SHIP
Example usage:

ga('ec:addPromo', {'id': 'SHIP'});

Optional.

The name of the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(promo) name`	`promo<promoIndex>nm`	text	None	None	all

Example value: Free Shipping
Example usage:

ga('ec:addPromo', {'name': 'Free Shipping'});

Optional.

The creative associated with the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(promo) creative`	`promo<promoIndex>cr`	text	None	None	all

Example value: Shipping Banner
Example usage:

ga('ec:addPromo', {'creative': 'Shipping Banner'});

Optional.

The position of the creative. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(promo) position`	`promo<promoIndex>ps`	text	None	None	all

Example value: banner_slot_1
Example usage:

ga('ec:addPromo', {'position': 'banner_slot_1'});

Optional.

Specifies the role of the promotions included in a hit. If a promotion action is not specified, the default promotion action, 'view', is assumed. To measure a user click on a promotion set this to 'promo_click'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`(promo) action`	`promoa`	text	None	None	all

Example value: click
Example usage:

ga('ec:setAction', 'promo_click'});

Currency Code

Optional.

When present indicates the local currency for all transaction currency values. Value should be a valid ISO 4217 currency code.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`currencyCode`	`cu`	text	None	10 Bytes	all

Example value: EUR
Example usage:

ga('set', 'currencyCode', 'EUR');

Social Network

Required for social hit type.

Specifies the social network, for example Facebook or Google Plus.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`socialNetwork`	`sn`	text	None	50 Bytes	social

Example value: facebook
Example usage:

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Social Action

Required for social hit type.

Specifies the social interaction action. For example on Google Plus when a user clicks the +1 button, the social action is 'plus'.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`socialAction`	`sa`	text	None	50 Bytes	social

Example value: like
Example usage:

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Social Action Target

Required for social hit type.

Specifies the target of a social interaction. This value is typically a URL but can be any text.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`socialTarget`	`st`	text	None	2048 Bytes	social

Example value: http://foo.com
Example usage:

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Timing

User timing category

Required for timing hit type.

Specifies the user timing category.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`timingCategory`	`utc`	text	None	150 Bytes	timing

Example value: category
Example usage:

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing variable name

Required for timing hit type.

Specifies the user timing variable.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`timingVar`	`utv`	text	None	500 Bytes	timing

Example value: lookup
Example usage:

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing time

Required for timing hit type.

Specifies the user timing value. The value is in milliseconds.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`timingValue`	`utt`	integer	None	None	timing

Example value: 123
Example usage:

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing label

Optional.

Specifies the user timing label.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`timingLabel`	`utl`	text	None	500 Bytes	timing

Example value: label
Example usage:

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123,
  'timingLabel': 'label'
});

Exceptions

Exception Description

Optional.

Specifies the description of an exception.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`exDescription`	`exd`	text	None	150 Bytes	exception

Example value: DatabaseError
Example usage:

ga('send', 'exception', {
  'exDescription': 'DatabaseError'
});

Is Exception Fatal?

Optional.

Specifies whether the exception was fatal.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`exFatal`	`exf`	boolean	`1`	N/A	exception

Example value: true
Example usage:

ga('send', 'exception', {
  'exFatal': true
});

Custom Dimensions / Metrics

Custom Dimension

Optional.

Each custom dimension has an associated index. There is a maximum of 20 custom dimensions (200 for Analytics 360 accounts). The dimension index must be a positive integer between 1 and 200, inclusive.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`dimension`	`cd<dimensionIndex>`	text	None	150 Bytes	all

Example value: Sports
Example usage:

ga('set', 'dimension14', 'Sports');

Custom Metric

Optional.

Each custom metric has an associated index. There is a maximum of 20 custom metrics (200 for Analytics 360 accounts). The metric index must be a positive integer between 1 and 200, inclusive.

Field Name	Protocol Parameter	Value Type	Default Value	Max Length	Supported Hit Types
`metric`	`cm<metricIndex>`	number	None	None	all

Example value: 47
Example usage:

ga('set', 'metric7', 47);

جز در مواردی که غیر از این ذکر شده باشد،‌محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers‏ مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.

تاریخ آخرین به‌روزرسانی 2022-12-20 به‌وقت ساعت هماهنگ جهانی.

خبرنامه
برای خبرنامه توسعه دهندگان Google Analytics ثبت نام کنید
اختلاف نظر
به سرور Google Analytics Discord بپیوندید
GitHub
نمونه های گوگل آنالیتیکس را امتحان کنید
سرریز پشته
با استفاده از تگ google-analytics سوال بپرسید
فیلم های
ویدیوهای Google Analytics را در یوتیوب مشاهده کنید