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

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

کد رهگیری: پیکربندی پایه

این مرجع روش‌هایی را که برای سفارشی‌سازی تمام جنبه‌های گزارش Google Analytics استفاده می‌کنید، توضیح می‌دهد.

روش های پایه ga.js

_deleteCustomVar (index)
_getName ()
_getAccount ()
_getVersion ()
_getVisitorCustomVar (index)
_initData () منسوخ شد
_setAccount (accountID)
_setCookiePersistence (milliseconds) منسوخ شده است
_setCustomVar (index, name, value, opt_scope)
_setSampleRate (newRate)
_setSessionTimeout (newTimeout) منسوخ شده است
_setSessionCookieTimeout (cookieTimeoutMillis)
_setSiteSpeedSampleRate (sampleRate)
_setVar (newVal) منسوخ شده است
_setVisitorCookieTimeout (cookieTimeoutMillis)
_trackPageLoadTime () منسوخ شده است
_trackPageview (opt_pageURL)

جزئیات روش

_deleteCustomVar()

_deleteCustomVar(index)

این روش متغیر اختصاص داده شده به شاخص ارائه شده را در صورت وجود حذف می کند. برای مثال، ممکن است یک متغیر سفارشی در سطح بازدیدکننده تنظیم کنید و بعداً تصمیم بگیرید که دیگر نمی‌خواهید از این متغیر سطح بازدیدکننده استفاده کنید.

Async Snippet (توصیه می شود)

_gaq.push(['_deleteCustomVar', 1]);

قطعه سنتی (ga.js).

pageTracker._deleteCustomVar(1);

مولفه های

Int index شاخص متغیر سفارشی برای حذف.

_getName()

_getName()

نامی را که ردیاب هنگام ایجاد آن داده شده است، برمی گرداند.

Async Snippet (توصیه می شود)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

قطعه سنتی (ga.js).

pageTracker._getName();

برمی گرداند

String نام ردیاب.

_getAccount()

_getAccount()

شناسه Google Analytics را برای این شی ردیاب برمی‌گرداند. اگر صفحات وب سایت خود را در چندین حساب ردیابی می کنید، می توانید از این روش برای تعیین حسابی که با یک شی ردیاب خاص مرتبط است استفاده کنید.

Async Snippet (توصیه می شود)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

قطعه سنتی (ga.js).

pageTracker._getAccount();

برمی گرداند

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

_getVersion()

_getVersion()

شماره نسخه GATC را برمی‌گرداند.

Async Snippet (توصیه می شود)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

قطعه سنتی (ga.js).

pageTracker._getVersion();

برمی گرداند

شماره نسخه String GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

مقدار متغیر سفارشی سطح بازدیدکننده را که برای نمایه مشخص شده تخصیص داده شده است، برمی گرداند.

Async Snippet (توصیه می شود)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

قطعه سنتی (ga.js).

pageTracker._getVisitorCustomVar(1);

مولفه های

Int index شاخص متغیر سفارشی سطح بازدیدکننده.

برمی گرداند

String مقدار متغیر سفارشی سطح بازدیدکننده. اگر قادر به بازیابی متغیر برای شاخص مشخص شده نباشد، تعریف نشده برمی‌گرداند.

_initData()

_initData() منسوخ شد. initData () اکنون به طور خودکار در کد رهگیری ga.js اجرا می شود.

شی GATC (Google Analytics Tracker Code) را مقداردهی اولیه یا مجدداً راه اندازی می کند.

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

منحصراً در ردیابی ناهمزمان استفاده می شود. شناسه ویژگی وب را برای شی ردیابی تنظیم می کند.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

مولفه های

String accountID شناسه کامل ویژگی وب (به عنوان مثال UA-65432-1 ) برای شی ردیاب.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

این روش منسوخ شده است. لطفاً به جای آن از _setVisitorCookieTimeout (cookieTimeoutMillis) استفاده کنید.

انقضای کوکی بازدیدکنندگان Google Analytics را بر حسب میلی ثانیه تنظیم می کند. به طور پیش‌فرض، کوکی بازدیدکننده قرار است تا ۲ سال دیگر منقضی شود. در صورت تمایل، می توانید تاریخ انقضای کوکی بازدیدکننده را با استفاده از این روش تغییر دهید. به عنوان مثال، برای تنظیم انقضای کوکی بازدیدکننده به 7 روز، از کد زیر استفاده کنید:

pageTracker._setCookiePersistence(604800000);

مولفه های

Number milliseconds زمان انقضای کوکی بازدیدکننده جدید.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

یک متغیر سفارشی را با نام، مقدار و محدوده ارائه شده برای متغیر تنظیم می کند. یک محدودیت 128 بایتی برای name و value ترکیبی وجود دارد.

Async Snippet (توصیه می شود)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

قطعه سنتی (ga.js).

pageTracker._setCustomVar(
    1,                   // Required - This custom var is set to slot #1
    "Section",           // Required - The top-level name for your online content categories
    "Life & Style",  // Required - Sets the value of "Section" to "Life & Style" for this particular article
    3                    // Optional - Sets the scope to page-level
);

برمی گرداند

Boolean اگر متغیر سفارشی با موفقیت تنظیم شده باشد، این روش true برمی‌گرداند، و اگر تنظیم نشده باشد، false برمی‌گرداند (مثلاً اگر طول رشته نام/مقدار شما از 128 بایت بیشتر باشد، یا اگر از شکاف نادرستی استفاده کنید).

مولفه های

Int index مورد نیاز است. اسلات مورد استفاده برای متغیر سفارشی. مقادیر ممکن شامل 1-5 است.

String name الزامی است. نام متغیر سفارشی.

String value مورد نیاز است. مقدار برای متغیر سفارشی.

Int opt_scope اختیاری است . محدوده مورد استفاده برای متغیر سفارشی. مقادیر ممکن 1 برای سطح بازدیدکننده، 2 برای سطح جلسه و 3 برای سطح صفحه است.

_setSampleRate()

_setSampleRate(newRate)

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

شما فقط باید این روش را همزمان با فراخوانی _setAccount() مشخص کنید، معمولاً یک بار در هر صفحه یا برنامه (هرجا که خود کد رهگیری را مقداردهی اولیه کنید). به خاطر داشته باشید که مقدار نرخ نمونه ای که مشخص می کنید تا زمانی که خود شی ردیابی پابرجاست، به قوت خود باقی می ماند.

Async Snippet (توصیه می شود)

_gaq.push(['_setSampleRate', '2.5']);

قطعه سنتی (ga.js).

pageTracker._setSampleRate("2.5"); //sets sampling rate to 2.5%

مولفه های

String newRate نرخ نمونه جدید برای تنظیم. یک رشته عددی بین 0 تا 100 (دقیق تا دو رقم اعشار) ارائه دهید.

_setSessionTimeout()

_setSessionTimeout(newTimeout)

این روش منسوخ شده است. لطفاً به جای آن از _setSessionCookieTimeout (cookieTimeoutMillis) استفاده کنید.

زمان پایان جلسه جدید را در چند ثانیه تنظیم می کند. به‌طور پیش‌فرض، زمان پایان جلسه روی 30 دقیقه (1800 ثانیه) تنظیم شده است. زمان پایان جلسه برای محاسبه بازدیدها استفاده می شود ( به نحوه تعریف یک جلسه در Analytics مراجعه کنید). اگر می‌خواهید تعریف «جلسه» را برای نیازهای خاص خود تغییر دهید، می‌توانید در عرض چند ثانیه مقدار جدیدی را تعریف کنید. این امر بر گزارش‌های بازدید در هر بخش که تعداد بازدیدها محاسبه می‌شود و جایی که بازدیدها برای محاسبه مقادیر دیگر استفاده می‌شوند، تأثیر می‌گذارد. به عنوان مثال، اگر مدت زمان جلسه را کوتاه کنید، تعداد بازدیدها به طور کلی افزایش می یابد و در صورت افزایش مدت زمان جلسه، به طور کلی کاهش می یابد.

مولفه های

String newTimeout زمان پایان جلسه جدید برای تنظیم در چند ثانیه.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

زمان پایان کوکی جلسه جدید را بر حسب میلی ثانیه تنظیم می کند. به طور پیش‌فرض، زمان پایان جلسه روی 30 دقیقه تنظیم شده است. زمان پایان جلسه برای محاسبه بازدیدها استفاده می شود، زیرا یک بازدید پس از 30 دقیقه عدم فعالیت مرورگر یا پس از خروج از مرورگر به پایان می رسد. اگر می‌خواهید تعریف «جلسه» را برای نیازهای خاص خود تغییر دهید، می‌توانید تعداد میلی‌ثانیه را برای تعریف یک مقدار جدید ارسال کنید. این امر بر گزارش‌های بازدید در هر بخش که تعداد بازدیدها محاسبه می‌شود و جایی که بازدیدها برای محاسبه مقادیر دیگر استفاده می‌شوند، تأثیر می‌گذارد. به عنوان مثال، اگر مدت زمان جلسه را کوتاه کنید، تعداد بازدیدها افزایش می یابد و در صورت افزایش مدت زمان جلسه کاهش می یابد. شما می توانید زمان انقضا را به 0 تغییر دهید تا نشان دهد که این کوکی باید زمانی که مرورگر بسته است حذف شود.

Async Snippet (توصیه می شود)

_gaq.push(['_setSessionCookieTimeout', 1800000]);

قطعه سنتی (ga.js).

pageTracker._setSessionCookieTimeout(1800000); //number of milliseconds in 30 minutes

مولفه های

Number cookieTimeoutMillis زمان پایان جلسه جدید در میلی ثانیه یا 0 برای حذف کوکی در صورت بسته شدن مرورگر.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

اندازه مجموعه نمونه جدیدی را برای جمع آوری داده های سرعت سایت تعریف می کند. به طور پیش‌فرض، یک نمونه ثابت 1% از بازدیدکنندگان سایت شما مجموعه داده‌هایی را تشکیل می‌دهد که معیارهای سرعت سایت از آن مشتق شده‌اند. اگر تعداد نسبتاً کمی بازدیدکننده روزانه از سایت خود دارید، مثلاً 100000 یا کمتر، ممکن است بخواهید نمونه برداری را با نرخ بیشتری تنظیم کنید. این باعث افزایش جزئیات برای زمان بارگذاری صفحه و سایر معیارهای سرعت سایت می شود. (برای جزئیات بیشتر درباره گزارش‌های سرعت سایت، به سرعت سایت در مرکز راهنمایی مراجعه کنید.)

متد _setSiteSpeedSampleRate() باید قبل از _trackPageview() فراخوانی شود تا موثر باشد.

Analytics بازدیدهای مجموعه سرعت سایت را برای یک ویژگی منفرد به بیش از 1٪ کاربران یا 10 هزار بازدید در روز محدود می کند تا از توزیع عادلانه منابع سیستم برای این ویژگی اطمینان حاصل کند.

توجه: ما شدیداً از سایت هایی با بیش از 1 میلیون بازدید در روز تشویق می کنیم که انتخاب نمونه خود را روی نرخ پیش فرض 1٪ تنظیم کنند. تنظیم حجم نمونه به تعداد بیشتر، حجم نمونه شما را افزایش نمی دهد.

Async Snippet (توصیه می شود)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

قطعه سنتی (ga.js).

pageTracker._setSiteSpeedSampleRate(5);
pageTracker._trackPageview();

مولفه های

Number sampleRate مقدار بین 0 - 100 برای تعیین درصد بازدیدکنندگان سایت شما که برای اهداف سرعت سایت اندازه گیری می شود. به عنوان مثال، مقدار 5 ، نمونه مجموعه سرعت سایت را روی 5 درصد قرار می دهد.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

انقضای کوکی بازدیدکنندگان Google Analytics را بر حسب میلی ثانیه تنظیم می کند. به طور پیش‌فرض، کوکی بازدیدکننده قرار است تا ۲ سال دیگر منقضی شود. در صورت تمایل، می توانید تاریخ انقضای کوکی بازدیدکننده را با استفاده از این روش تغییر دهید. شما می توانید زمان انقضا را به 0 تغییر دهید تا نشان دهد که این کوکی باید زمانی که مرورگر بسته است حذف شود.

Async Snippet (توصیه می شود)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

قطعه سنتی (ga.js).

pageTracker._setVisitorCookieTimeout(63072000000); //number of milliseconds in 2 years

مولفه های

Number cookieTimeoutMillis زمان انقضای کوکی بازدیدکننده جدید بر حسب میلی ثانیه یا 0 برای حذف کوکی وقتی مرورگر بسته است.

_setVar()

_setVar(newVal)

این روش منسوخ شده است. لطفاً به جای آن از _setCustomVar() استفاده کنید.

یک بخش بازدیدکننده سفارشی را با رشته ارائه شده تنظیم یا تعریف می کند. شما می توانید از این مقدار برای ارائه بخش بندی اضافی کاربران به وب سایت خود استفاده کنید. برای مثال، می‌توانید یک صفحه ورود به سیستم یا فرمی داشته باشید که مقداری را بر اساس ورودی بازدیدکننده، مانند اولویتی که بازدیدکننده انتخاب می‌کند، یا یک گزینه حریم خصوصی، راه‌اندازی می‌کند. سپس این متغیر در کوکی برای آن بازدیدکننده به روز می شود. هنگامی که در سایت شما پیاده سازی می شود و داده ها از طریق این روش جمع آوری می شوند، بخش جدید تعریف شده در گزارش های تعریف شده توسط کاربر در بخش بازدیدکنندگان در گزارش های تحلیلی ظاهر می شود. علاوه بر این، می‌توانید به بخش ارزش تعریف‌شده کاربر در گزارش جزئیات محتوا دسترسی داشته باشید تا ببینید چه درصدی از بازدیدکنندگان یک صفحه متعلق به بخش خاصی است که شما تعریف کرده‌اید.

مولفه های

String newVal مقدار تعریف شده توسط کاربر جدید برای تنظیم.

_trackPageLoadTime()

_trackPageLoadTime()

این روش منسوخ شده است زیرا گزارش سرعت سایت به طور خودکار برای همه کاربران فعال است. لطفاً از _setSiteSpeedSampleRate() برای تنظیم نرخ نمونه برداری برای گزارش سرعت سایت استفاده کنید.

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

بررسی تغییرات شما

اگر مشاهده کردید که داده‌ها در گزارش‌ها ظاهر می‌شوند، تنظیمات شما درست است. اگر بعد از 24 ساعت هیچ داده ای مشاهده نکردید، سفارشی سازی خود را بررسی کنید تا مطمئن شوید که خطایی نداشته اید. برای مشاهده لیستی از خطاهای رایج کد رهگیری به عیب یابی کد رهگیری مراجعه کنید. این راهنمای عیب یابی همچنین شامل مراحل اولیه اشکال زدایی و اطلاعات بیشتر در مورد اشکال زدایی است.

توجه داشته باشید که فعال کردن ردیابی سرعت سایت برای سایت شما منجر به درخواست اضافی از سرورهای Google Analytics می شود، جدا از درخواست GIF ردیابی صفحه که برای بازدید از صفحه انجام می شود. برای به حداقل رساندن تأثیر بر تأخیر کلی سایت، این درخواست فقط بر روی نمونه ای از بازدید از صفحه به سایت شما ارسال می شود. به همین دلیل، ممکن است همیشه هنگام تلاش برای اشکال زدایی این ویژگی در Firebug یا ابزارهای دیگر، درخواست GIF سرعت سایت را مشاهده نکنید. این امری طبیعی و قابل انتظار است.

Async Snippet (توصیه می شود)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

قطعه سنتی (ga.js).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();
pageTracker._trackPageLoadTime();

_trackPageview()

_trackPageview(opt_pagePath)

منطق اصلی برای GATC (Google Analytic Tracker Code). اگر عملکردهای پیوند دهنده فعال باشد، سعی می کند مقادیر کوکی را از URL استخراج کند. در غیر این صورت، سعی می کند مقادیر کوکی را از document.cookie استخراج کند. همچنین در صورت لزوم کوکی ها را به روز می کند یا ایجاد می کند، سپس آنها را در شیء سند باز می نویسد. تمام معیارهای مناسب را برای ارسال به UCFE (انتخاب جمع کننده جوجه تیغی) جمع آوری می کند.

Async Snippet (توصیه می شود)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

قطعه سنتی (ga.js).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview("/home/landingPage");

مولفه های

String opt_pagePath پارامتر اختیاری برای نشان دادن مسیر صفحه برای ردیابی معیارهای زیر. هنگام استفاده از این گزینه، از یک اسلش ابتدایی (/) برای نشان دادن مسیر صفحه استفاده کنید.