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

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

مرجع فیلد 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 باشد. شاخص محصول باید یک عدد صحیح مثبت بین 1 تا 200 باشد. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شود.

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

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

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

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

اختیاری.

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

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

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

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

اندازه گیری سفارشی نمایش محصول

اختیاری.

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

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

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

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

اختیاری.

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

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

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

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

اختیاری.

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

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

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

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

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`(promo) creative`	`promo<promoIndex>cr`	متن	هیچ یک	هیچ یک	همه

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

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

اختیاری.

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

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

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

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

اختیاری.

نقش تبلیغات موجود در یک بازدید را مشخص می کند. اگر یک اقدام تبلیغاتی مشخص نشده باشد، اقدام تبلیغاتی پیش‌فرض، "مشاهده" در نظر گرفته می‌شود. برای اندازه گیری کلیک کاربر روی تبلیغ، این را روی "promo_click" تنظیم کنید. برای analytics.js افزونه Enhanced Ecommerce باید قبل از استفاده از این فیلد نصب شود.

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

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

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

کد ارز

اختیاری.

وقتی موجود است، واحد پول محلی را برای همه ارزش‌های ارز مبادله نشان می‌دهد. مقدار باید یک کد ارز معتبر ISO 4217 باشد.

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

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

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

شبکه اجتماعی

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

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

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

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

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

کنش اجتماعی

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

کنش تعامل اجتماعی را مشخص می کند. به عنوان مثال در گوگل پلاس، زمانی که کاربر روی دکمه 1+ کلیک می‌کند، اقدام اجتماعی «پلاس» است.

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

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

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

هدف اقدام اجتماعی

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

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

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

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

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

زمان سنجی

دسته زمان بندی کاربر

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

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`timingCategory`	`utc`	متن	هیچ یک	150 بایت	زمان سنجی

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

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

نام متغیر زمان بندی کاربر

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

متغیر زمان بندی کاربر را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`timingVar`	`utv`	متن	هیچ یک	500 بایت	زمان سنجی

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

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

زمان زمان بندی کاربر

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

مقدار زمان بندی کاربر را مشخص می کند. مقدار بر حسب میلی ثانیه است.

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

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

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

برچسب زمان بندی کاربر

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`timingLabel`	`utl`	متن	هیچ یک	500 بایت	زمان سنجی

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

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

استثناها

شرح استثنا

اختیاری.

شرح یک استثنا را مشخص می کند.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`exDescription`	`exd`	متن	هیچ یک	150 بایت	استثنا

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

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

آیا استثنا کشنده است؟

اختیاری.

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

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`exFatal`	`exf`	بولی	`1`	N/A	استثنا

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

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

ابعاد / معیارهای سفارشی

ابعاد سفارشی

اختیاری.

هر بعد سفارشی دارای یک شاخص مرتبط است. حداکثر 20 بعد سفارشی (200 برای حساب های Analytics 360) وجود دارد. شاخص بعد باید یک عدد صحیح مثبت بین 1 تا 200 باشد.

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

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

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

متریک سفارشی

اختیاری.

هر معیار سفارشی دارای یک شاخص مرتبط است. حداکثر 20 معیار سفارشی وجود دارد (200 معیار برای حساب های Analytics 360). شاخص متریک باید یک عدد صحیح مثبت بین 1 تا 200 باشد.

نام زمینه	پارامتر پروتکل	نوع ارزش	مقدار پیش فرض	بیشترین طول	پشتیبانی از انواع ضربه
`metric`	`cm<metricIndex>`	عدد	هیچ یک	هیچ یک	همه

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

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

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

تاریخ آخرین به‌روزرسانی 2024-04-22 به‌وقت ساعت هماهنگ جهانی.

خبرنامه، خبرنامه، خبرنامه
ثبت نام در خبرنامه توسعه دهندگان Google Analytics، ثبت نام در خبرنامه توسعه دهندگان Google Analytics، ثبت نام در خبرنامه توسعه دهندگان Google Analytics
اختلاف، اختلاف، اختلاف
به سرور Google Analytics Discord بپیوندید، به سرور Google Analytics Discord بپیوندید، به سرور Google Analytics Discord بپیوندید
GitHub,GitHub,GitHub
نمونه‌های Google Analytics را امتحان کنید، نمونه‌های Google Analytics را امتحان کنید، نمونه‌های Google Analytics را امتحان کنید
سرریز پشته، سرریز پشته، سرریز پشته
با استفاده از تگ google-analytics سوال بپرسید، با استفاده از برچسب google-analytics سوال بپرسید، با استفاده از برچسب google-analytics سوال بپرسید
ویدئوها، ویدئوها، ویدئوها
مشاهده ویدیوهای Google Analytics در YouTube، مشاهده ویدیوهای Google Analytics در YouTube، مشاهده ویدیوهای Google Analytics در YouTube