سنجش برنامه‌های تک‌صفحه‌ای

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

برنامه‌های تک‌صفحه‌ای (SPA) وب‌سایت‌هایی هستند که سند HTML را یک‌بار بار می‌کنند و هرگونه محتوای اضافی را بااستفاده از میاناهای برنامه‌سازی کاربردی جاوا اسکریپت واکشی می‌کنند.

مثال: فرض کنید فرمی برای به‌دست آوردن مشتریان بالقوه دارید. فرم سه صفحه دارد: > * صفحه اول برای دریافت اطلاعات مشتری. * صفحه دوم که مشتریان در آن علاقه خود را به خدمات خاصی نشان می‌دهند. * صفحه سوم برای ثبت‌نام در وبینارهای مرتبط با علایق مشتری.

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

قبل‌از شروع

این صفحه فرض می‌کند که ازقبل این موارد را دارید:

پیاده‌سازی سنجش برنامه تک‌صفحه‌ای

برای پیاده‌سازی اندازه‌گیری دقیق SPA، از یکی از این روش‌ها برای راه‌اندازی بازدید صفحه مجازی جدید استفاده کنید:

  • تغییرات سابقه مرورگر (توصیه‌شده): اگر SPA شما از History API، به‌ویژه روش pushState() و replaceState() برای به‌روزرسانی صفحه‌ها استفاده می‌کند، از این گزینه استفاده کنید.

  • رویدادهای سفارشی: اگر وب‌سایت شما از شیء DocumentFragment برای ارائه صفحه‌های مختلف استفاده می‌کند، از این گزینه استفاده کنید.

پیاده‌سازی تغییر سابقه مرورگر

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

فعال کردن سنجش به‌سازی‌شده در Google Analytics

برای اندازه‌گیری page_views به‌طور خودکار براساس سابقه مرورگر:

  1. Google Analytics را باز کنید

  2. در سرپرست، در بخش جمع‌آوری و اصلاح داده‌ها، روی «جاری‌سازی‌های داده» > «وب» کلیک کنید.

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

  4. برای ویرایش گزینه‌های تکی کلیک کنید. در بخش بازدیدهای صفحه، روی نمایش تنظیمات پیشرفته کلیک کنید. حتماً هم بار شدن صفحه و هم تغییرات صفحه براساس رویدادهای سابقه مرورگر را فعال کنید.

    تصویری که تنظیمات بازدیدهای صفحه را نشان می‌دهد

  5. تغییرات را ذخیره کنید.

راه‌اندازی سیستم سنجش را به‌تأیید برسانید

برای درستی‌سنجی اینکه برنامه تک‌صفحه‌ای شما بازدیدهای صفحه را به‌درستی اندازه‌گیری می‌کند:

  1. حالت اشکال‌زدایی را برای هر برچسب در راه‌اندازی سیستم سنجش SPA فعال کنید. با نحوه پایش رویدادها در DebugView آشنا شوید.

  2. روی برنامه تک‌صفحه‌ای‌تان کلیک کنید. وقتی با کلیک کردن به صفحه مجازی جدیدی می‌روید، باید رویداد page_view جدیدی در DebugView ببینید. پارامترهای رویداد page_view را با رویداد page_view قبلی مقایسه کنید تا بررسی کنید آیا ارجاع‌دهنده صفحه و مکان صفحه به‌درستی به‌روز شده‌اند یا نه.

ملاحظات بیشتر برای برنامه‌های تک‌صفحه‌ای

علاوه‌بر ارسال رویدادهای page_view، این جنبه‌های اضافی را برای ادغام قوی SPA با Google Analytics و تجربه کاربری بهتر درنظر بگیرید:

مدیریت موقعیت پیمایش

وقتی کاربران بین نماها در SPA پیمایش می‌کنند، مرورگر معمولاً موقعیت پیمایش فعلی را حفظ می‌کند. این یعنی کاربران ممکن است بالای صفحه مجازی جدید را نبینند و این موضوع می‌تواند بر ردیابی عمق پیمایش تأثیر بگذارد.

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

// Example: Reset window scroll position on a route change in your SPA
window.scrollTo(0, 0);

// Or, if your content is within a specific element:
// document.getElementById('main-content').scrollTo(0, 0);

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

اطمینان از دسترس‌پذیری محتوا برای ویژگی‌های مرورگر

اگر کاربران مشکلاتی را در ویژگی‌های مرورگر گزارش کنند، مثلاً کار نکردن جستجوی درون‌صفحه‌ای (Ctrl+F) پس‌از بار شدن صفحه مجازی، این امر می‌تواند نشان‌دهنده نحوه به‌روزرسانی DOM توسط SPA شما باشد.

توصیه: مطمئن شوید که چارچوب SPA و منطق مسیریابی شما به‌طور کامل و هم‌زمان بخش‌های مربوطه DOM را با محتوای صفحه جدید به‌روزرسانی می‌کنند. ممکن است رندر کردن با تأخیر یا محتوای پنهان‌شده از درخت DOM اصلی فوراً توسط عملکرد جستجوی مرورگر قابل‌نمایه‌سازی نباشد. جستجوی درون‌صفحه‌ای را پس‌از پیمایش‌های مجازی آزمایش کنید تا از دسترس‌پذیری محتوا مطمئن شوید.

تأثیر بر رویدادهای خودکار

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

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

وقتی اندازه‌گیری بازدید از صفحه مجازی به‌درستی پیاده‌سازی شده باشد:

  • رویداد user_engagement زمانی ارسال می‌شود که کاربر از یک صفحه مجازی به صفحه دیگری می‌رود.
  • زمان تعامل برای صفحه مجازی قبلی محاسبه و همراه با رویداد user_engagement ارسال می‌شود، معمولاً درست قبل‌از پردازش رویداد page_view برای صفحه مجازی جدید.
  • رویدادهای دیگر، مثل کلیک‌ها یا پیمایش‌ها، با page_location صفحه مجازی‌ای که کاربر درحال‌حاضر مشاهده می‌کند مرتبط است.

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