takt-angular

@vskstudio/takt-angular پیکیج Takt اینالیٹکس پلیٹ فارم کے لیے ایک native Angular انٹیگریشن فراہم کرتا ہے، جس کی توجہ پرائیویسی اول ڈیٹا کلیکشن پر ہے۔ اسے Angular 17 اور اس کے بعد کے ورژنز کے لیے ڈیزائن کیا گیا ہے، اور اسے ایک ہی پیکیج مینیجر کمانڈ کے ذریعے پروجیکٹ میں شامل کیا جا سکتا ہے۔ انسٹالیشن رن کریں: pnpm add @vskstudio/takt-angular @vskstudio/takt-core Bootstrap Integration روٹ bootstrap کال میں، provideTakt کا استعمال کرتے ہوئے provider کو رجسٹر کریں۔ provider صرف براؤزر میں کور اینالیٹکس لائبریری کو initialize کرتا ہے، ایک ابتدائی pageview بھیجتا ہے، اختیاری auto-capture فیچرز (outbound link clicks، فائل ڈاؤن لوڈز، SPA navigation وغیرہ) کو فعال کرتا ہے اور Angular ایپ کے ختم ہونے پر صفائی کرتا ہے۔ سرور سائیڈ پر provider غیر فعال رہتا ہے، جس سے لائبریری server-side rendering کے لیے محفوظ ہو جاتی ہے۔ Injectable Service TaktService کو ایپلی کیشن میں کہیں بھی inject کیا جا سکتا ہے۔ یہ track(eventName, options)، pageview()، optOut() اور optIn() جیسے طریقے فراہم کرتا ہے۔ لائبریری کے initialize ہونے سے پہلے یا سرور پر چلتے وقت تمام طریقے no-ops ہوتے ہیں، جس سے یہ یقینی بنتا ہے کہ وہ کبھی ایرر (throw) نہیں کریں گے۔ Declarative Click Tracking TaktEventDirective ڈویلپرز کو taktEvent ایٹریبیوٹ کے ذریعے کسی بھی کلک کے قابل ایلیمنٹ کے ساتھ ٹریکنگ منسلک کرنے کی اجازت دیتا ہے، جس میں اختیاری taktProps اور taktRevenue ان پٹس شامل ہیں۔ یہ directive کلک کے وقت لائیو اینالیٹکس انسٹنس کو حل کرتا ہے، جس سے مارک اپ صاف رہتا ہے۔ UI Widgets دو standalone components فراہم کیے گئے ہیں: - TaktBadgeComponent کسی دیے گئے ڈومین کے لیے سرور سے تیار کردہ SVG بیج رینڈر کرتا ہے۔ - TaktEmbedComponent ایک sandboxed iframe رینڈر کرتا ہے جو عوامی اینالیٹکس ڈیش بورڈز دکھاتا ہے۔ دونوں components کسی بھی Angular ٹیمپلیٹ میں استعمال کیے جا سکتے ہیں اور ڈومین، تھیم، سائز، زبان اور بصری ورژن کے لیے ان پٹس کو سپورٹ کرتے ہیں۔ Public Stats API createStats ہیلپر عوامی Takt API کے لیے ایک کلائنٹ بناتا ہے۔ یہ summary، timeseries، realtime اور breakdown جیسے async طریقے پیش کرتا ہے، جس سے ڈویلپرز پروگرام کے ذریعے مجموعی اینالیٹکس ڈیٹا حاصل کر سکتے ہیں۔ Framework-Agnostic Custom Element غیر Angular صفحات کے لیے takt-analytics نامی ایک خود مختار custom element ایکسپورٹ کیا گیا ہے۔ defineTaktElement کال کرنے کے بعد (یا اس ماڈیول کو امپورٹ کرنے کے بعد جو خودکار طور پر رجسٹریشن چلاتا ہے)، ایلیمنٹ کو سادہ HTML میں رکھا جا سکتا ہے اور یہ خود بخود پرائیویسی سیٹنگز جیسے outbound link tracking اور فائل ڈاؤن لوڈ ٹریکنگ کا احترام کرے گا۔ بلڈ سٹیپ کے بغیر فوری شمولیت کے لیے ایک CDN بنڈل بھی دستیاب ہے۔ Configuration Options TaktConfig آپشنز کے ایک وسیع سیٹ کو سپورٹ کرتا ہے، بشمول domain، endpoint، outbound link tracking، فائل ڈاؤن لوڈ ٹریکنگ، SPA navigation، Do Not Track کا احترام، localhost exclusion، sample rate، query string handling، path exclusions، URL scrubbing، اور tagged element tracking۔ زیادہ تر سائٹس کے لیے ڈیفالٹس مناسب ہیں، اور کنفیگریشن کو bootstrap کے وقت provideTakt کو فراہم کیا جا سکتا ہے۔ لائسنس لائبریری MIT لائسنس کے تحت جاری کی گئی ہے۔