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

Clamp Analytics হলো একটি লাইটওয়েট JavaScript SDK যা কুকি বা ব্যক্তিগত আইডেন্টিফায়ার ছাড়াই আপনাকে প্রোডাক্ট ব্যবহারের ডাটা সংগ্রহ করতে দেয়। আপনার প্রজেক্ট আইডি দিয়ে লাইব্রেরিটি ইনিশিয়ালাইজ করার পর, পেজভিউ এবং সেশন তথ্য স্বয়ংক্রিয়ভাবে রেকর্ড হয়ে যায়, এবং আপনি কাস্টম ইভেন্ট পাঠাতে পারেন, লগ-ইন করা ব্যবহারকারীদের সনাক্ত (identify) করতে পারেন, রেভিনিউ ট্রানজ্যাকশন ক্যাপচার করতে পারেন এবং এরর লগ করতে পারেন। ইনস্টলেশন খুব সহজ: npm দিয়ে প্যাকেজটি যোগ করুন অথবা CDN-কে নির্দেশ করে এমন একটি একক স্ক্রিপ্ট ট্যাগ পেস্ট করুন। স্ক্রিপ্টটি একটি data-clamp-project অ্যাট্রিবিউট থেকে প্রজেক্ট আইডেন্টিফায়ার পড়ে এবং সাথে সাথেই ট্র্যাকিং শুরু করে। React, Next.js, Vite, Nuxt, SvelteKit, Astro এবং অন্যান্য ফ্রেমওয়ার্কের জন্য, SDK ডেডিকেটেড গাইড এবং একটি React কম্পোনেন্ট প্রদান করে যা রুট লেআউটে রাখা যেতে পারে। API-এর মধ্যে রয়েছে init, track, identify, reset, revenue, getAnonymousId এবং getUserId। Track আপনাকে ফ্ল্যাট কী-ভ্যালু প্রোপার্টি সহ যেকোনো নামযুক্ত ইভেন্ট রেকর্ড করতে দেয়। Revenue হলো একটি টাইপড হেল্পার যা ক্যানোনিকাল সাবস্ক্রিপশন এবং পারচেজ ইভেন্ট পাঠায়, যা বিলিং পিরিয়ডের ওপর ভিত্তি করে স্বয়ংক্রিয়ভাবে মান্থলি রিকারিং রেভিনিউ (MRR) ডেল্টা হিসাব করে। Identify ভবিষ্যতের ইভেন্টগুলোর সাথে একটি নির্দিষ্ট ইউজার আইডি যুক্ত করে, অন্যদিকে reset লগআউটের সময় এই সংযোগটি মুছে ফেলে। TypeScript-এ টাইপড ইভেন্ট ম্যাপ সংজ্ঞায়িত করা যেতে পারে, যা কাস্টম ইভেন্টের জন্য কম্পাইল-টাইম অটোকমপ্লিট এবং ভ্যালিডেশন প্রদান করে। Revenue ইভেন্টগুলো একটি কঠোর ইউনিয়ন টাইপ অনুসরণ করে যা সাবস্ক্রিপশন, এককালীন কেনাকাটা এবং রিফান্ডের জন্য সঠিক ফিল্ড কম্বিনেশন প্রয়োগ নিশ্চিত করে। আনকট এক্সেপশন এবং আনহ্যান্ডেলড প্রমিস রিজেকশনগুলোকে $error ইভেন্ট হিসেবে ক্যাপচার করতে এরর হ্যান্ডলিং সক্ষম করা যেতে পারে, যা সহজ বিশ্লেষণের জন্য ফিঙ্গারপ্রিন্ট অনুযায়ী গ্রুপ করা হয়। ঐচ্ছিক এক্সটেনশনগুলো আউটবাউন্ড লিংক, ফাইল ডাউনলোড, 404 পেজ, ডাটা-অ্যাট্রিবিউট চালিত ইভেন্ট, ওয়েব ভাইটালস এবং সেকশন ভিউ ভিজিবিলিটির জন্য অটো-ট্র্যাকিং যুক্ত করে। প্রতিটি এক্সটেনশন চাহিদামতো লোড হয়, যা বান্ডেল সাইজ সর্বনিম্ন রাখে। ব্যাকএন্ড সার্ভিস, ওয়েবহুক বা সার্ভার অ্যাকশন থেকে একই ইভেন্ট পাঠানোর জন্য একটি আলাদা বিল্ডের মাধ্যমে সার্ভার-সাইড ব্যবহার সমর্থিত, যার জন্য একটি API কি প্রয়োজন হয়; এটি একটি সমন্বিত ইভেন্ট স্ট্রিম নিশ্চিত করে। সংগৃহীত সমস্ত ডাটা Clamp Analytics প্ল্যাটফর্মে সংরক্ষিত হয়, যা প্রতি মাসে ১০০,০০০ (100 k) ইভেন্টের একটি ফ্রি টিয়ার এবং একটি বিল্ট-ইন Model Context Protocol সার্ভার প্রদান করে। এর ফলে ইভেন্টগুলো Claude, Cursor বা VS Code এক্সটেনশনের মতো AI এজেন্টদের দ্বারা সরাসরি কোয়েরিযোগ্য হয়, যা প্রাকৃতিক ভাষার অ্যানালিটিক্স এবং স্বয়ংক্রিয় ইনসাইট সক্ষম করে। SDK-টি MIT লাইসেন্সের অধীনে রিলিজ করা হয়েছে এবং clamp-sh/analytics রিপোজিটরিতে রক্ষণাবেক্ষণ করা হয়।