laravel-metrics-plausible

Laravel Metrics Plausible एक PHP लाइब्रेरी है जो Plausible Analytics Stats API v2 को रैप करती है, जो एनालिटिक्स डेटा को पुनः प्राप्त करने और प्रबंधित करने के लिए एक सहज, Laravel-नेटिव इंटरफ़ेस प्रदान करती है। मुख्य विशेषताएं: - कुल योग (विज़िटर्स, पेजव्यू, बाउंस रेट, आदि) प्राप्त करें। - कस्टम तिथि सीमाओं और आयामों (प्रति घंटा, दैनिक, मासिक) के साथ टाइम-सीरीज़ डेटा क्वेरी करें। - पेजों, एंट्री/एग्जिट पेजों, स्रोतों, चैनलों, UTM पैरामीटर्स, देशों, क्षेत्रों, शहरों, डिवाइसों, ब्राउज़रों, ऑपरेटिंग सिस्टम के आधार पर ब्रेकडाउन प्राप्त करें। - लक्ष्य रूपांतरण, कस्टम इवेंट्स और रीयल-टाइम विज़िटर काउंट तक पहुंचें। - Plausible साइटों और लक्ष्यों का प्रबंधन (सूचीबद्ध करना, बनाना, हटाना) करें। - एक क्वेरी बिल्डर का उपयोग करके कस्टम क्वेरी बनाएं जो API पेलोड को मिरर करता है। - प्रमाणीकरण, रेट-लिमिट और सामान्य API त्रुटियों को विशिष्ट अपवादों के साथ संभालता है। - Plausible Cloud और सेल्फ-होस्टेड कम्युनिटी एडिशन दोनों के साथ काम करता है। - कॉन्फ़िगरेशन spatie/laravel-settings के माध्यम से डेटाबेस में संग्रहीत होता है, जिससे कॉन्फ़िग फ़ाइलों की आवश्यकता समाप्त हो जाती है। इंस्टॉलेशन: 1. पैकेज जोड़ें: composer require jeffersongoncalves/laravel-metrics-plausible 2. सेटिंग्स टेबल बनाने के लिए माइग्रेशन चलाएं: php artisan migrate कॉन्फ़िगरेशन: माइग्रेशन के बाद, एनवायरनमेंट वेरिएबल्स सेटिंग्स को सीड करते हैं: PLAUSIBLE_API_KEY – Plausible सेटिंग्स → API Keys से API कुंजी। PLAUSIBLE_SITE_ID – साइट का डोमेन (जैसे, example.com)। PLAUSIBLE_BASE_URL – Plausible का बेस URL (डिफ़ॉल्ट https://plausible.io, सेल्फ-होस्टेड के लिए बदलें)। सेटिंग्स को PlausibleSettings क्लास के माध्यम से प्रोग्रामेटिक रूप से भी अपडेट किया जा सकता है। उपयोग का अवलोकन: सभी इंटरैक्शन Plausible फ़ैकेड के माध्यम से किए जाते हैं। कुल योग: $stats = Plausible::aggregate(); $stats->visitors(); // 1234 $stats->pageviews(); // 4321 टाइम-सीरीज़: $rows = Plausible::timeseries(DateRange::Last30Days, Dimension::TimeDay); foreach ($rows as $row) { echo $row->label . ': ' . $row->visitors(); } ब्रेकडाउन (पेज, स्रोत, देश, डिवाइस, आदि) समर्पित विधियों जैसे Plausible::pages(), Plausible::countries(), Plausible::devices() के माध्यम से उपलब्ध हैं। रीयल-टाइम विज़िटर्स: $visitors = Plausible::realtimeVisitors(); कस्टम क्वेरीज़: $query = Plausible::query() ->metrics(Metric::Visitors, Metric::Pageviews) ->dateRange(DateRange::Last7Days) ->dimensions(Dimension::Page) ->filter('is', Dimension::Country, ['BR', 'PT']) ->orderBy(Metric::Visitors, 'desc') ->limit(50); $rows = Plausible::rows($query); साइट प्रबंधन: Plausible::sites(); Plausible::createSite('example.com', 'America/Sao_Paulo'); Plausible::deleteSite('example.com'); लक्ष्य प्रबंधन: Plausible::goals(); Plausible::createEventGoal('Signup'); Plausible::deleteGoal(1); Enums: Metric – Visitors, Visits, Pageviews, BounceRate, VisitDuration, Events, आदि। DateRange – Day, Last7Days, Last30Days, Last12Months, Year, All, आदि। Dimension – Page, Hostname, Source, Referrer, Device, Browser, Country, City, TimeHour, TimeDay, आदि। त्रुटि प्रबंधन: - AuthenticationException: गायब/अमान्य API कुंजी या साइट ID, या 403 रिस्पॉन्स। - RateLimitException: HTTP 429 रिस्पॉन्स। - PlausibleException: सामान्य API विफलताएं (उपरोक्त के लिए बेस क्लास)। परीक्षण और विकास: composer test के साथ टेस्ट सूट चलाएं, composer format के साथ कोड को फॉर्मेट करें, और composer analyse के साथ स्टेटिक विश्लेषण करें। लाइसेंस: MIT लाइसेंस के तहत वितरित।