Analytics

প্রতিটি প্রকাশিত Proyecta অ্যাপের জন্য বিল্ট-ইন analytics। ট্র্যাফিক, Web Vitals এবং ডিভাইস বিশ্লেষণ দেখতে builder-এ Admin > Analytics খোলো।

প্রতিটি Proyecta অ্যাপ analytics-সহ তৈরি হয়। ইনস্টল করার কিছু নেই, কোনো snippet পেস্ট করতে হবে না, এবং কোনো তৃতীয় পক্ষের অ্যাকাউন্টেরও প্রয়োজন নেই। প্রতিটি প্রকাশিত অ্যাপে ডেটা সংগ্রহ স্বয়ংক্রিয়ভাবে চলে; builder-এর ভেতরে analytics dashboard Pro প্ল্যান এবং তার উপরে পাওয়া যায়। প্রকাশিত সাইটের ডেটা দেখতে builder-এ Admin > Analytics খোলো।

তিনটি ভিউ

Analytics-এ তিনটি ভিউ আছে, যেগুলো admin sidebar-এ তালিকাভুক্ত:

ভিউ	কী দেখায়
Overview	ট্র্যাফিক — page views, visitors, sessions, শীর্ষ পেজ এবং একটি দৈনিক time-series চার্ট (referrer-গুলো Devices ট্যাবে দেখা যায়)
Web Vitals	প্রকৃত ব্যবহারকারীদের কাছ থেকে সংগৃহীত Core Web Vitals (LCP, INP, CLS)
Devices	Browser এবং ট্র্যাফিকের উৎস (referrer)

কোন ডেটা ট্র্যাক করা হয়?

তোমার প্রকাশিত সাইট (তোমার *.proyecta.live সাবডোমেইন বা কাস্টম ডোমেইন) থেকে analytics স্বয়ংক্রিয়ভাবে সংগ্রহ করা হয়। Builder-এর ভেতরে preview ট্র্যাফিক গণনা করা হয় না।

বর্তমান উইন্ডো হলো শেষ ৭ দিন। কনফিগারযোগ্য date range picker roadmap-এ রয়েছে।

কীভাবে অ্যাক্সেস করব?

Builder-এ তোমার প্রজেক্ট খোলো, Admin ভিউতে যাও, তারপর sidebar থেকে Analytics বেছে নাও। এটি দেখতে Pro প্ল্যান বা তার উপরে থাকতে হবে — Free প্ল্যানে এটি আপগ্রেডের প্রম্পট দেখাবে। পেইড প্ল্যানে ডিফল্টভাবে Overview লোড হয়; Overview, Web Vitals এবং Devices-এর মধ্যে যেতে sidebar ব্যবহার করো।

কাস্টম ইভেন্ট ট্র্যাক করো

স্বয়ংক্রিয় pageview এবং Web Vitals সংগ্রহের পাশাপাশি, তোমার অ্যাপ নিজস্ব কাস্টম ইভেন্ট রেকর্ড করতে পারে — signup, purchase, ফিচার ব্যবহার, যা-ই তোমার কাছে গুরুত্বপূর্ণ। কাস্টম ইভেন্টগুলো স্বয়ংক্রিয়ভাবে তোমার অ্যাপের সাথে সম্পর্কিত হয়।

তোমার অ্যাপে tracker আগে থেকেই সংযুক্ত থাকে, তাই তুমি React কোডের যেকোনো জায়গা থেকে শুধু track() কল করো:

import { track } from '@proyecta-ai/analytics';

// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

Properties হলো strings এবং numbers-এর একটি flat object। track() কখনো throw করে না এবং null check-এর প্রয়োজন নেই — analytics এখনো initialize না হলে call টি সহজভাবে বাদ পড়ে যায়, তাই render-এর সময় বা first paint-এ কল করা নিরাপদ।

AI-কে এটি সেট আপ করতে বলো: "Track a 'signup' event whenever a new user registers."

সাধারণ প্রশ্নাবলি

Google Analytics বা Mixpanel যোগ করতে হবে কি?

না। Analytics বিল্ট-ইন এবং প্রতিটি প্রকাশিত অ্যাপের জন্য স্বয়ংক্রিয়ভাবে চালু থাকে। যদি তুমি অতিরিক্তভাবে কোনো তৃতীয় পক্ষের প্রোভাইডার ব্যবহার করতে চাও, AI-কে একটি integrate করতে বলতে পারো — Settings পেজের Environment Variables সেকশনে তোমার প্রোভাইডারের API key যোগ করো এবং বলো "Add Google Analytics to my app"।

পেইড প্ল্যান দরকার কি?

প্ল্যান নির্বিশেষে প্রতিটি প্রকাশিত অ্যাপে সংগ্রহ চলে। Admin-এর Analytics section একটি Pro ফিচার — Free প্ল্যানে এটি আপগ্রেডের প্রম্পট দেখায়। কাস্টম ইভেন্ট ট্র্যাকিং যেকোনো প্ল্যানে কাজ করে।

কোনো ডেটা দেখছি না কেন?

Analytics শুধুমাত্র তোমার অ্যাপের প্রকাশিত ভার্সন ট্র্যাক করে। যদি তুমি এখনো publish না করে থাকো, অথবা শেষ ৭ দিনে তোমার প্রকাশিত সাইটে কোনো ট্র্যাফিক না এসে থাকে, তাহলে প্যানেলটি খালি থাকবে। Builder-এর ভেতরে preview ট্র্যাফিক গণনা করা হয় না। (এছাড়া নিশ্চিত করো যে তুমি Pro প্ল্যানে আছো — dashboard-টি নিজেই Pro-গেটেড।)

ডেটা export করা যাবে কি?

এখনো না। CSV export roadmap-এ রয়েছে।

ভিন্ন date range বেছে নিতে পারব কি?

এখনো না। প্যানেলটি শেষ ৭ দিন দেখায়। কাস্টম range roadmap-এ রয়েছে।

ভিজিটরের ডেটা কি anonymize করা?

Proyecta analytics রিটার্নিং ভিজিটরদের শনাক্ত করতে একটি first-party cookie (_pry_vid) ব্যবহার করে। এটি তৃতীয় পক্ষের সাইটে ব্যবহারকারীদের ট্র্যাক করে না। তোমার cookie consent ব্যানারের প্রয়োজন আছে কিনা তা নির্ভর করে তোমার ব্যবহারকারীদের অধিক্ষেত্রের উপর (যেমন EU-তে GDPR persistent identifier-এর জন্য সম্মতি প্রয়োজন হতে পারে)। তোমার আইনি পরামর্শদাতার সাথে পরামর্শ করো।

শীঘ্রই আসছে

• কনফিগারযোগ্য date range (24h, 30d, কাস্টম)
• CSV export
• Conversion এবং goal ট্র্যাকিং