مرجع فیلد Analytics.js

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

  1. فقط فیلدها را ایجاد کنید
  2. عمومی
  3. کاربر
  4. جلسه
  5. منابع ترافیک
  6. اطلاعات سیستم
  7. اصابت
  8. اطلاعات محتوا
  9. برنامه ها
  10. مناسبت ها
  11. تجارت الکترونیکی پیشرفته
  12. تعاملات اجتماعی
  13. زمان سنجی
  14. استثناها
  15. ابعاد / معیارهای سفارشی

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

فیلدهای زیر را فقط می‌توان در روش 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);