منصوبے کے بارے میں

laravel-analytics ایک لارویل پیکیج ہے جسے Spatie نے Google Analytics Data API استعمال کرتے ہوئے GA4 سے آنالٹکس ڈیٹا حاصل کرنے کے لیے تیار کیا ہے۔ ## صلاحیتیں یہ پیکیج `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)` — آپریٹنگ سسٹم اور screenPageViews واپس کرتی ہے - `get(Period $period, array $metrics, array $dimensions = [], ...)` — ترتیب، پیجینیشن، ڈائمینشن فلٹرز اور میٹرک فلٹرز کے ساتھ اختیاری GA4 کوئریز تمام طریقے `Illuminate\Support\Collection` آرتھس کے arrays واپس کرتے ہیں۔ ## تنصیب ```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 کنی کا راستہ، یا credentials کا array - `cache_lifetime_in_minutes`: ڈیفالٹ 1440 منٹ؛ کیچنگ کو غیر فعال کرنے کے لیے 0 سیٹ کریں - `cache.store` اور بنیادی کیچ کے لیے اختیاری prefix/lifetime ## تصدیق کی ترتیب 1. [Google Cloud Console](https://console.developers.google.com/apis) میں پروجیکٹ بنائیں 2. API لائبریری میں **Google Analytics Data API** کو فعال کریں 3. سروس اکاؤنٹ بنائیں اور اس کی JSON کنی ڈاؤن لوڈ کریں 4. کم از کم Analyst کردار کے ساتھ GA4 پراپرٹی کو سروس اکاؤنٹ ای میل سے شیئر کریں 5. JSON فائل کو محفوظ جگہ ذخیرہ کریں اور config کو اس کی طرف اشارہ کریں ## مدتیں `Spatie\Analytics\Period` کلاس سپورٹ کرتی ہے: ```php Period::days(7) Period::months(6) Period::create($startDate, $endDate) // Carbon instances قبول کرتی ہے ``` ## fakes کے ساتھ ٹیسٹنگ فیسڈ میں یونٹ اور فیچر ٹیسٹس کے لیے `fake` طریقہ فراہم کرتی ہے: ```php use Spatie\Analytics\Facades\Analytics; Analytics::fake(); // یا predefined responses کے ساتھ Analytics::fake([ ['pageTitle' => 'Home', 'activeUsers' => 10, 'screenPageViews' => 20], ]); ``` پیکیج ٹیسٹس چلائیں: ```bash vendor/bin/pest ``` ## لائسنس MIT لائسنس یافتہ۔ تفصیلات کے لیے repository LICENSE دیکھیں۔