laravel-analytics

laravel-analytics Spatie द्वारा विकसित एक Laravel पैकेज है जो Google Analytics Data API का उपयोग करके Google Analytics से एनालिटिक्स डेटा प्राप्त करता है। ## क्षमताएँ पैकेज `Spatie\Analytics\Facades\Analytics` फ़ासाड के माध्यम से कई सुविधाजनक विधियाँ प्रकट करता है: - `fetchMostVisitedPages(Period $period, int $maxResults = 20)` — fullPageUrl, pageTitle, screenPageViews लौटाता है - `fetchVisitorsAndPageViews(Period $period)` — activeUsers और screenPageViews लौटाता है - `fetchVisitorsAndPageViewsByDate(Period $period)` — प्रत्येक पंक्ति के लिए तारीख़ कुंजी जोड़ता है - `fetchTotalVisitorsAndPageViews(Period $period)` — तारीख़ के अनुसार कुल योग जमा करता है - `fetchTopReferrers(Period $period, int $maxResults = 20)` — pageReferrer और screenPageViews लौटाता है - `fetchUserTypes(Period $period)` — नए बनाम लौटने वाले उपयोगकर्ता लौटाता है - `fetchTopBrowsers(Period $period, int $maxResults = 10)` — ब्राउज़र और screenPageViews लौटाता है - `fetchTopCountries(Period $period, int $maxResults = 10)` — देश और screenPageViews लौटाता है - `fetchTopOperatingSystems(Period $period, int $maxResults = 10)` — operatingSystem और screenPageViews लौटाता है - `get(Period $period, array $metrics, array $dimensions = [], ...)` — ऑर्डरिंग, पेजिंग, डिमेंशन फ़िल्टर और मेट्रिक फ़िल्टर के साथ मनमाने GA4 क्वेरी सभी विधियाँ `Illuminate\Support\Collection` ऑब्जेक्ट लौटाती हैं। ## इंस्टॉलेशन ```bash composer require spatie/laravel-analytics ``` वैकल्पिक रूप से कॉन्फ़िगरेशन प्रकाशित करें: ```bash php artisan vendor:publish --tag="analytics-config" ``` `config/analytics.php` पर प्रकाशित कॉन्फ़िग में आवश्यक है: - `property_id`: आपकी GA4 प्रॉपर्टी ID - `service_account_credentials_json`: सर्विस अकाउंट JSON कुंजी का मार्ग या क्रेडेंशियल्स वाला ऐरे - `cache_lifetime_in_minutes`: डिफ़ॉल्ट रूप से 1440 मिनट; कैशिंग को अक्षम करने के लिए 0 सेट करें - `cache.store` और अंतर्निहित कैश के लिए वैकल्पिक प्रीफ़िक्स/लाइफ़टाइम ## प्रमाणीकरण सेटअप 1. [Google Cloud Console](https://console.developers.google.com/apis) में एक प्रोजेक्ट बनाएँ 2. API लाइब्रेरी में **Google Analytics Data API** सक्षम करें 3. एक सर्विस अकाउंट बनाएं और उसकी JSON कुंजी डाउनलोड करें 4. कम से कम Analyst भूमिका के साथ अपनी GA4 प्रॉपर्टी को सर्विस अकाउंट ईमेल के साथ साझा करें 5. JSON फ़ाइल को सुरक्षित रूप से संग्रहीत करें और कॉन्फ़िग को उसकी ओर इशारा करें ## अवधियाँ `Spatie\Analytics\Period` वर्ग का समर्थन करता है: ```php Period::days(7) Period::months(6) Period::create($startDate, $endDate) // Carbon इंस्टेंस स्वीकार करता है ``` ## फ़ेक के साथ परीक्षण फ़ासाड यूनिट और फीचर परीक्षणों के लिए `fake` विधि प्रदान करता है: ```php use Spatie\Analytics\Facades\Analytics; Analytics::fake(); // या पूर्वनिर्धारित प्रतिक्रियाओं के साथ Analytics::fake([ ['pageTitle' => 'Home', 'activeUsers' => 10, 'screenPageViews' => 20], ]); ``` पैकेज परीक्षण निम्नलिखित से चलाए जा सकते हैं: ```bash vendor/bin/pest ``` ## लाइसेंस MIT लाइसेंस वाले। विवरण के लिए रिपॉज़िटरी LICENSE देखें।