این راهنما نحوه استفاده از analytics.js را برای اندازهگیری فعالیت صفحه در سایتهایی که محتوای آنها به صورت پویا و بدون بارگذاری کامل صفحه سنتی بارگذاری میشود، توضیح میدهد.
بررسی اجمالی
برنامه تک صفحه ای (SPA) یک برنامه وب یا وب سایتی است که تمام منابع مورد نیاز برای پیمایش در سراسر سایت را در بارگذاری صفحه اول بارگیری می کند. همانطور که کاربر روی لینک ها کلیک می کند و با صفحه تعامل می کند، محتوای بعدی به صورت پویا بارگذاری می شود. این برنامه اغلب URL را در نوار آدرس بهروزرسانی میکند تا پیمایش صفحه سنتی را شبیهسازی کند، اما درخواست کامل صفحه دیگری هرگز انجام نمیشود.
تگ پیشفرض Google Analytics با وبسایتهای سنتی به خوبی کار میکند، زیرا کد قطعه هر بار که کاربران صفحه جدیدی را بارگذاری میکنند اجرا میشود. با این حال، برای یک برنامه تک صفحه ای که در آن سایت محتوای صفحه جدید را به جای بارگیری کامل صفحه به صورت پویا بارگیری می کند، کد قطعه analytics.js فقط یک بار اجرا می شود. این بدان معنی است که بازدیدهای بعدی (مجازی) صفحه باید به صورت دستی با بارگیری محتوای جدید ضبط شوند.
پیگیری بازدید از صفحات مجازی
هنگامی که برنامه شما محتوا را به صورت پویا بارگیری می کند و URL را در نوار آدرس به روز می کند، داده های ذخیره شده در ردیاب شما نیز باید به روز شوند.
برای به روز رسانی ردیاب، از دستور set
استفاده کنید و مقدار page
جدید را وارد کنید:
ga('set', 'page', '/new-page.html');
بعد از اینکه مقدار صفحه جدید را تنظیم کردید، تمام بازدیدهای بعدی ارسال شده از آن مقدار جدید استفاده خواهند کرد. برای ضبط صفحه نمایش، بلافاصله پس از به روز رسانی ردیاب، یک ضربه بازدید از صفحه ارسال کنید.
ga('set', 'page', '/new-page.html'); ga('send', 'pageview');
در حالی که از نظر فنی، فرمان send
برای بازدید از صفحه نمایش، یک فیلد page
اختیاری را به عنوان پارامتر سوم می پذیرد، ارسال فیلد page
به این ترتیب هنگام اندازه گیری برنامه های کاربردی یک صفحه توصیه نمی شود. این به این دلیل است که فیلدهای ارسال شده از طریق دستور send
در ردیاب تنظیم نشده اند - آنها فقط برای ضربه فعلی اعمال می شوند. بهروزرسانی نکردن ردیاب در صورتی که برنامه شما بازدیدهای غیرنمایش صفحه (مثلاً رویدادها یا تعاملات اجتماعی) ارسال کند، مشکل ایجاد میکند، زیرا این بازدیدها با هر مقدار page
که ردیاب هنگام ایجاد آن داشته است، مرتبط میشود.
مدیریت چندین URL برای یک منبع
برخی از SPA ها فقط هنگام بارگذاری پویا محتوا، بخش هش URL را به روز می کنند. این عمل می تواند به موقعیت هایی منجر شود که بسیاری از مسیرهای صفحه مختلف به یک منبع اشاره می کنند. در چنین مواردی، معمولاً بهتر است یک URL متعارف انتخاب کنید و فقط آن مقدار page
به Google Analytics ارسال کنید.
برای مثال، وبسایتی را در نظر بگیرید که صفحه «درباره ما» آن از طریق هر یک از نشانیهای اینترنتی زیر قابل دسترسی است:
-
/about.html
-
/#about.html
-
/home.html#about.html
برای جلوگیری از تکرار در گزارشهای خود، بهتر است همه این بازدیدها از صفحه را به صورت /about.html
ثبت کنید.
ملاحظات مهم
ارجاع دهنده سند را به روز نکنید
هنگامی که با استفاده از دستور create
یک شی ردیاب ایجاد می کنید، مقدار document.referrer
در قسمت referrer
ردیاب ذخیره می شود. در زمینه یک برنامه کاربردی تک صفحه ای که از بارگیری کامل صفحه استفاده نمی کند، فیلد referrer
همیشه ثابت می ماند.
با وجود این، لازم نیست قبل از ارسال بازدیدهای صفحه نمایش، فیلد ارجاع دهنده را به صورت دستی به روز کنید. گوگل آنالیتیکس قادر است به طور خودکار مسیر ناوبری صحیح را تعیین کند.
مکان سند را به روز نکنید
همانطور که ردیاب document.referrer
برای فیلد referrer
استفاده می کند، از document.location
برای فیلد location
استفاده می کند که ممکن است حاوی داده های کمپین یا سایر متا داده ها به شکل پارامترهای پرس و جو به انتهای URL باشد.
بهروزرسانی هر یک از فیلدهای کمپین یا سایر دادههای متا که Google Analytics در حال بررسی آن است، ممکن است باعث شود جلسه فعلی به پایان برسد و جلسه جدیدی شروع شود. برای جلوگیری از این مشکل، هنگام اندازه گیری بازدید از صفحه مجازی در یک برنامه تک صفحه ای، فیلد location
را به روز نکنید. به جای آن از فیلد page
استفاده کنید.
ردیاب های جدید ایجاد نکنید
ردیابهای جدید را در یک برنامه تک صفحهای ایجاد نکنید تا از آنچه که قطعه ردیابی جاوا اسکریپت برای وبسایتهای سنتی انجام میدهد تقلید کنید. انجام این کار خطر ارسال ارجاع دهنده نادرست و همچنین داده های کمپین نادرست همانطور که در بالا توضیح داده شد را به دنبال دارد.