اندازه گیری اختیاری را فعال کنید

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

ما با محدود کردن شدید تعداد گزینه‌ها در اسکریپت پیش‌فرض به آن دست می‌یابیم. درعوض، ما اندازه‌گیری‌های پیشرفته‌تری را به عنوان پسوندهای اختیاری اسکریپت ارائه می‌دهیم که متناسب با نحوه استفاده از Histat هستند. این رویکرد مطمئن می شود که شما فقط کدی را بارگذاری می کنید که واقعاً در وب سایت شما استفاده می شود.

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

بسته به انتخاب شما از اندازه گیری ها، قطعه تغییر می کند

توجه داشته باشید که قطعه ردیابی که باید در سایت خود درج کنید بسته به انتخاب شما از اندازه گیری های پیشرفته تغییر می کند. هنگام ایجاد تغییرات در اندازه گیری های اختیاری خود، مطمئن شوید که جدیدترین قطعه را در سایت خود درج کنید تا همه ردیابی ها همانطور که انتظار می رود کار کند.

در اینجا لیستی از اندازه گیری های اختیاری ما آمده است:

| اندازه گیری اختیاری | توضیح | |------------------------------------------------ ------------------------------------------------ ----------------------------| | لینک های خروجی | به طور خودکار «پیگیری کلیک روی پیوندهای خروجی» | | دانلود فایل | به طور خودکار «دانلود فایل رهگیری» | | صفحات خطای 404 | "ردیابی صفحات خطای 404" به صورت خودکار | | مسیرهای صفحه هش شده | ردیابی خودکار مسیرهای صفحه که از «#» در URL «مسیریابی مبتنی بر هش» | استفاده می‌کنند | رویدادهای سفارشی | به شما امکان می‌دهد «رویدادهای سفارشی» مانند کلیک‌های پیوند، ارسال فرم و سایر کلیک‌های عنصر HTML | | خواص سفارشی | به شما امکان می‌دهد «ویژگی‌های سفارشی» (همچنین به عنوان ابعاد سفارشی در Google Analytics شناخته می‌شود) را هنگام ارسال نمایش صفحه یا رویداد سفارشی برای ایجاد معیارهای سفارشی پیوست کنید | | درآمد تجارت الکترونیک | به شما امکان می دهد «مقادیر پولی» پویا را به رویدادهای سفارشی اختصاص دهید و انتساب درآمد را دنبال کنید |

گزینه های ردیابی پیشرفته

علاوه بر لیست بالا («script.outbound-links.js»، «script.file-downloads.js»، «script.hash.js»، «script.tagged-events.js»، «script.pageview- props.js» و «script.revenue.js»)، ما همچنین گزینه‌های ردیابی پیشرفته‌تری در دسترس داریم. توجه داشته باشید که این موارد در لیست ورود به سایت موجود نیستند، بنابراین باید آنها را به صورت دستی در قطعه ردیابی خود درج کنید.

| پسوند | توضیح | |------------------------------------------------ ------------------------------------------------ ----------------------------| | script.compat.js | حالت سازگاری برای «ردیابی کاربران در اینترنت اکسپلورر» (≥IE11) | | script.local.js | به تجزیه و تحلیل ها اجازه دهید روی لوکال هاست نیز ردیابی کنند که در برنامه های ترکیبی مفید است | | script.manual.js | «بازدیدهای صفحه به طور خودکار فعال نشود». همچنین به شما امکان می‌دهد «موقعیت‌های سفارشی» را برای ویرایش URL‌ها با شناسه‌ها مشخص کنید. همچنین می‌توانید از آن برای ردیابی «پارامترهای درخواست سفارشی»| استفاده کنید

نحوه تغییر دستی قطعه ردیابی

برای مثال، نام اسکریپت پیش‌فرض در قطعه ما «script.js» است. اگر وب‌سایت شما بر روی یک میزبان محلی است و می‌خواهید این بازدیدها را دنبال کنید، می‌توانید اسکریپت را با پسوند دیگری بارگیری کنید: «script.local.js».

در این مورد، قطعه ای که باید در سایت خود درج کنید به شرح زیر است (حتما ویژگی data-domain را به دامنه ای که به هیستات اضافه کرده اید تغییر دهید):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

می‌توانید این افزونه‌ها را به هر شکلی که می‌خواهید ترکیب و مطابقت دهید. برای مثال، اگر می‌خواهید هم از مسیریابی مبتنی بر هش و هم از ردیابی کلیک پیوندهای خروجی ما استفاده کنید، می‌توانید آنها را به صورت زیر ترکیب کنید: «script.hash.outbound-links.js».

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

یا بگوییم که می‌خواهید از برنامه افزودنی «script.revenue.js» ما برای ردیابی درآمد تجارت الکترونیک و افزونه «script.local.js» برای ردیابی ترافیک لوکال هاست استفاده کنید، قطعه شما باید به شکل زیر باشد:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

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

script.compat.js

اسکریپت پیش‌فرض Hist در اینترنت اکسپلورر کار نمی‌کند زیرا از document.currentScript API برای خواندن گزینه‌های پیکربندی استفاده می‌کند. می‌توانید با گنجاندن پسوند «script.compat.js» و تعریف «id=plausible» روی برچسب اسکریپت، هیستات را در حالت سازگاری اجرا کنید تا بتواند خودش را پیدا کند. توجه داشته باشید که این فقط در IE11 ≥ کار می کند. در اینجا چگونه باید به نظر برسد:

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

به‌طور پیش‌فرض، اسکریپت هیستات هنگامی که برای اولین بار بارگذاری می‌شود، نمای صفحه را راه‌اندازی می‌کند. همچنین شنوندگان را به History API متصل می کند و هنگامی که از «history.pushState» استفاده می کنید، به طور خودکار بازدید از صفحه را فعال می کند. این برای اکثر وب‌سایت‌ها مفید است، اما در صورتی که می‌خواهید کنترل کاملی بر روی زمانی که بازدید از صفحه در وب‌سایت شما فعال می‌شود، حالت دستی را نیز ارائه می‌کنیم.

یکی از موارد استفاده برای این کار زمانی است که از Turbo (قبلاً Turbolinks) استفاده می کنید. در این صورت، بسته به کتابخانه ای که استفاده می کنید، می خواهید به صورت دستی بازدید از صفحه Hist را در رویداد مرورگر «turbo:load» یا «turbolinks:load» فعال کنید. در اینجا نحوه انجام این کار آمده است:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- تابع "قابل قبول" را برای راه اندازی دستی رویدادها تعریف کنید -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- باعث بازدید از صفحه در ناوبری توربولینک ها --> می شود
<script>
document.addEventListener("turbo:load", function() {
  قابل قبول ('نمایش صفحه')
})
</script>

هنگام استفاده از توربولینک ها، باید مطمئن شوید که اسکریپت هیستات در طول ناوبری توربو بارگذاری و اجرا نمی شود. ممکن است لازم باشد اسکریپت را به بخش <head> وب سایت خود منتقل کنید یا برای این کار از ویژگی «data-turbo-eval="false» استفاده کنید.

یادداشت

هنگام استفاده از manual.js، هر فراخوانی اسکریپت با «نمایش صفحه» منجر به شمارش یک صفحه نمایش جداگانه می‌شود، حتی اگر در همان صفحه فراخوانی شود.

مکان های سفارشی را برای URL های صفحه خود مشخص کنید

علاوه بر این، پسوند اسکریپت دستی به شما امکان می دهد گزینه خاصی به نام "u" را با رویدادهای خود ارائه دهید. این به شما امکان می دهد URL صفحه را مشخص کنید و می توان از آن برای تعیین مکان های سفارشی استفاده کرد.

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

پارامترهای پرس و جوی سفارشی را برای URL های کامل صفحه پیگیری کنید

به طور پیش‌فرض، هیستات تمام پارامترهای پرس و جو را برای اهداف حریم خصوصی «ref»، «source»، «utm_source»، «utm_medium»، «utm_campaign»، «utm_content» و «utm_term» حذف می‌کند.

این بدان معناست که صفحاتی مانند «yoursite.com/blog/index.php?article=some_article&page=11» به عنوان «yoursite.com/blog/index.php» در گزارش «صفحات برتر» گزارش شما گزارش می شود. داشبورد هیستات

گزینه های ردیابی پیشرفته​

نحوه تغییر دستی قطعه ردیابی​

script.compat.js​

script.manual.js​

مکان های سفارشی را برای URL های صفحه خود مشخص کنید​

پارامترهای پرس و جوی سفارشی را برای URL های کامل صفحه پیگیری کنید​