اختیاری پیمائش کو فعال کریں۔
ہمیں تجزیاتی صنعت میں سب سے ہلکے جاوا اسکرپٹ کے ٹکڑوں میں سے ایک پر فخر ہے۔
ہم اسے پہلے سے طے شدہ اسکرپٹ میں اختیارات کی تعداد کو یکسر محدود کرکے حاصل کرتے ہیں۔ اس کے بجائے، ہم بہتر پیمائشیں اختیاری اسکرپٹ ایکسٹینشن کے طور پر پیش کرتے ہیں جس کے مطابق آپ 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 | صفحہ کے ملاحظات کو خودکار طور پر متحرک نہ کریں۔ شناخت کنندگان کے ساتھ یو آر ایل کو دوبارہ ترتیب دینے کے لیے آپ کو حسب ضرورت مقامات کی وضاحت کرنے کی بھی اجازت دیتا ہے۔ آپ اسے کسٹم استفسار کے پیرامیٹرز کو ٹریک کرنے کے لیے بھی استعمال کر سکتے ہیں۔
ٹریکنگ اسنیپٹ کو دستی طور پر کیسے تبدیل کیا جائے۔
مثال کے طور پر، ہمارے ٹکڑوں میں پہلے سے طے شدہ اسکرپٹ کا نام script.js ہے۔ اگر آپ کی ویب سائٹ لوکل ہوسٹ پر ہے اور آپ ان دوروں کو ٹریک کرنا چاہتے ہیں، تو آپ کے پاس اسکرپٹ کو مختلف ایکسٹینشن کے ساتھ لوڈ کرنے کا اختیار ہے: script.local.js۔
اس صورت میں، آپ کو اپنی سائٹ میں جو ٹکڑا داخل کرنے کی ضرورت ہے وہ مندرجہ ذیل ہے (اس بات کو یقینی بنائیں کہ ڈیٹا ڈومین کی خصوصیت کو اس ڈومین میں تبدیل کریں جسے آپ نے ہسٹاٹ میں شامل کیا ہے):
<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
پہلے سے طے شدہ ہسٹاٹ اسکرپٹ انٹرنیٹ ایکسپلورر پر کام نہیں کرے گا کیونکہ یہ کنفیگریشن کے اختیارات کو پڑھنے کے لیے document.currentScript API کا استعمال کرتا ہے۔ آپ script.compat.js ایکسٹینشن کو شامل کرکے اور اسکرپٹ ٹیگ پر id="plausible" کی وضاحت کر کے مطابقت کے موڈ میں Hisstat کو چلا سکتے ہیں تاکہ یہ خود کو تلاش کر سکے۔ نوٹ کریں کہ یہ صرف ≥ IE11 پر کام کرتا ہے۔ یہاں یہ ہے کہ اسے کس طرح نظر آنا چاہئے:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
پہلے سے طے شدہ طور پر، ہسٹاٹ اسکرپٹ جب پہلی بار لوڈ ہوتا ہے تو صفحہ منظر کو متحرک کرتا ہے۔ یہ سننے والوں کو ہسٹری API سے بھی منسلک کرتا ہے اور جب آپ history.pushState استعمال کرتے ہیں تو صفحہ کے نظارے کو خود بخود متحرک کر دیتا ہے۔ یہ زیادہ تر ویب سائٹس کے لیے کارآمد ہے لیکن ہم ایک مینوئل وضع بھی پیش کرتے ہیں اگر آپ اپنی ویب سائٹ پر پیج ویوز کو متحرک ہونے پر مکمل کنٹرول چاہتے ہیں۔
اس کے استعمال کے معاملات میں سے ایک یہ ہے کہ جب آپ Turbo (پہلے Turbolinks) استعمال کرتے ہیں۔ اس صورت میں، آپ '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() {
plausible('pageview')
})
</script>
ٹربولنکس استعمال کرتے وقت، آپ کو یہ یقینی بنانا چاہیے کہ ٹربو نیویگیشن کے دوران ہسٹاٹ اسکرپٹ لوڈ اور عمل میں نہیں آیا ہے۔ آپ کو اسکرپٹ کو اپنی ویب سائٹ کے <head> سیکشن میں منتقل کرنے یا ایسا کرنے کے لیے data-turbo-eval="false" وصف استعمال کرنے کی ضرورت پڑ سکتی ہے۔
manual.js استعمال کرتے وقت 'pageview' کے ساتھ ہر اسکرپٹ کال کے نتیجے میں ایک علیحدہ صفحہ منظر شمار کیا جاتا ہے چاہے اسی صفحہ پر کال کی جائے
اپنے صفحہ کے URLs کے لیے حسب ضرورت مقامات کی وضاحت کریں۔
مزید برآں، دستی اسکرپٹ ایکسٹینشن آپ کو اپنے ایونٹس کے ساتھ u نام کا ایک خاص آپشن فراہم کرنے کی اجازت دیتی ہے۔ یہ آپ کو صفحہ کے URL کی وضاحت کرنے کی اجازت دیتا ہے اور اپنی مرضی کے مقامات کی وضاحت کے لیے استعمال کیا جا سکتا ہے۔
یہ خاص طور پر ایسے متعدد صفحات کو دوبارہ ترتیب دینے اور جمع کرنے میں مددگار ہے جن کے URLs میں ایسے شناخت کار ہوتے ہیں جو صارفین کے لیے مخصوص ہوتے ہیں۔
مکمل صفحہ URLs کے لیے حسب ضرورت استفسار کے پیرامیٹرز کو ٹریک کریں۔
پہلے سے طے شدہ طور پر، Histat رازداری کے مقاصد کے لیے تمام استفسار کے پیرامیٹرز کو ہٹا دیتا ہے 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 کے طور پر رپورٹ کیا جائے گا۔ ہسٹاٹ ڈیش بورڈ۔