প্রকল্প সম্পর্কে

# Analytics পৃষ্ঠা ভিউ, কাস্টম ইভেন্ট এবং ভিজিটর শনাক্তকরণ ট্র্যাক করার জন্য একটি হালকা বিশ্লেষণ চিকনায়ন স্তর। কোনো তৃতীয় পক্ষের বিশ্লেষণ টুল বা আপনার নিজস্ব ব্যাকএন্ডের সাথে কাজ করতে ডিজাইন করা হয়েছে, প্লাগযোগ্য আর্কিটেকচারের মাধ্যমে। ## বৈশিষ্ট্য - তৃতীয় পক্ষের ইন্টিগ্রেশনের জন্য এক্সটেন্ডেবল প্লাগইন সিস্টেম - টাইম ট্র্যাভেল এবং অফলাইন মোড দিয়ে টেস্ট ও ডিবাগ করুন - ট্র্যাকিং কল পরিবর্তন করার জন্য লাইফসাইকেল হুক - আইসোমরফিক — ব্রাউজার এবং Node.js উভয় জায়গাতেই কাজ করে - বিশ্লেষণ লাইব্রেরি লোড হওয়া পর্যন্ত ইভেন্ট কো অপেক্ষায় রাখে - শর্ত সাপেক্ষে তৃতীয় পক্ষের স্ক্রিপ্ট লোড করে - অফলাইনে কাজ করে - TypeScript সমর্থন ## ইনস্টলেশন ```bash npm install analytics --save ``` npx yarn, pnpm, এবং bun এর মাধ্যমেও পাওয়া যায়। ## ব্যবহার ```js import Analytics from 'analytics' import googleAnalytics from '@analytics/google-analytics' import customerIo from '@analytics/customerio' const analytics = Analytics({ app: 'my-app-name', version: 100, plugins: [ googleAnalytics({ measurementIds: ['G-XXXXXXXX'] }), customerIo({ siteId: '123-xyz' }) ] }) analytics.page() analytics.track('userPurchase', { price: 20, item: 'pink socks' }) analytics.identify('user-id-xyz', { firstName: 'bill', lastName: 'murray' }) ``` ## কোর API - `analytics.identify(userId, traits)` — একজন ভিজিটরকে শনাক্ত করুন এবং তাদের ডেটা localStorage তে সেট করুন - `analytics.track(eventName, payload)` — কাস্টম বিশ্লেষণ ইভেন্ট ট্র্যাক করুন - `analytics.page(data)` — পৃষ্ঠা ভিউ ট্র্যাকিং ট্রিগার করুন - `analytics.user(key)` — সংরক্ষিত ইউজার ডেটা প্রাপ্ত করুন - `analytics.reset()` — ভিজিটর তথ্য মুছে ফেলুন এবং স্টেট রিসেট করুন - `analytics.ready(callback)` — সব প্রোভাইডর লোড হলে চালু করুন - `analytics.on(event, callback)` / `analytics.once(event, callback)` — লাইফসাইকেল ইভেন্ট শুনুন - `analytics.getState(key)` — অভ্যন্তরীণ স্টেটের সাব-কীতে অ্যাক্সেস করুন - `analytics.storage` — ডেটা স্থায়ীকরণের যোগ্য (localStorage, cookies) - `analytics.plugins.enable/disable(namespace)` — ডায়নামিকভাবে প্লাগইন পরিচালনা করুন ## প্লাগইন সিস্টেম লাইব্রেরিটি Google Analytics, Segment, Amplitude, AWS Pinpoint, Countly, Crazy Egg, Churnzero, এবং activity-utils সহ অনেক আনুষ্ঠানিক প্লাগইন নিয়ে আসে। কমিউনিটি প্লাগইনও পাওয়া যায়। ইভেন্টের প্রতিক্রিয়া জানাতে বা কাস্টম মেথড যোগ করতে কাস্টম প্লাগইন তৈরি করা যেতে পারে। ## দর্শন - কখনো একক বিশ্লেষণ টুলে আবদ্ধ হবেন না - প্লাগইন অ্যারে সামঞ্জস্য করে প্রোভাইডার যোগ/বাদ দেওয়া সহজ - ভিজিটর গোপনীয়তা সম্মান করুন এবং অপ্ট-আউট পদ্ধতি নির্ধারণ করুন - ব্যবসা লজিক সম্প্রসারণযোগ্যতার জন্য প্লাগযোগ্য API