Weave Code
Analytics Statistics Laravel Package
spatie/analytics-statistics
Opinionated PHP package to fetch Google Analytics statistics. Provides a simple API for querying Analytics data using Google credentials. Works with PHP 5.3+; Laravel 5 users may prefer spatie/laravel-analytics.
An opinionated php package to retrieve Google Analytics data.
Frequently asked questions about Analytics Statistics
- Does this package support Laravel 8/9 or only Laravel 5?
- The package was built for Laravel 5 and lacks explicit Laravel 8/9 support. You may encounter dependency conflicts (e.g., Carbon or Illuminate contracts) and will likely need to manually bind the facade in a service provider or patch compatibility issues. Test thoroughly in a staging environment before production use.
- Will this package work with Google Analytics 4 (GA4) or only Universal Analytics (v3)?
- This package only supports the deprecated Google Analytics v3 API. GA4 requires the newer Measurement Protocol or GA4 API, which this package does not support. If you’re using GA4, consider alternatives like direct API integration or migrating to a GA4-compatible package.
- How do I set up Google API credentials for this package?
- You’ll need a Google Analytics API service account with OAuth2 credentials. Generate a JSON key file in the Google Cloud Console, then store the path securely (e.g., in `.env`). The package expects the key path in its configuration, but you may need to extend the config for Laravel’s environment system.
- Can I use this package for real-time analytics or only historical data?
- This package is optimized for historical data retrieval (e.g., daily/monthly reports) and not real-time analytics. Google Analytics v3 has inherent latency, and the package doesn’t support streaming or event-level data. For real-time needs, use the GA4 API or a dedicated analytics service.
- What are the limitations of the queries I can run with this package?
- The package provides a fluent interface for predefined metrics (e.g., sessions, pageviews) and dimensions (e.g., date, country). Custom metrics or complex queries aren’t supported—you’d need to bypass the package and use the raw Google API client. This limits flexibility for advanced reporting.
- How do I handle API rate limits or high query volumes?
- Google Analytics v3 has strict quotas (100k requests/day for free tier). Cache responses aggressively (e.g., Redis) to avoid hitting limits. Monitor your usage in the Google Cloud Console and consider batching requests or upgrading to a paid plan if needed.
- Is there a way to integrate this package’s results directly into Eloquent models?
- The package returns raw arrays or collections, but you can manually hydrate results into Eloquent models or store them in a database for later use. There’s no built-in ORM integration, so you’ll need to implement this logic yourself or extend the package.
- What should I do if I encounter dependency conflicts with modern Laravel or PHP?
- Since the package targets PHP 5.3 and Laravel 5, conflicts with newer Laravel versions (e.g., Carbon, Illuminate contracts) are likely. Start by manually binding the facade in a service provider. If issues persist, check for community patches or consider forking the package to update dependencies.
- Are there alternatives to this package for Laravel and Google Analytics?
- For GA4, consider `spatie/laravel-analytics` (a newer package) or direct integration with the Google Analytics Data API. For legacy GA3, alternatives include custom API clients or third-party services like Mixpanel or Amplitude. Evaluate your needs—this package is best for simple, read-only GA3 integrations.
- How do I contribute or report issues if the package is no longer maintained?
- The package is MIT-licensed and open-source, so you can fork it to fix issues or add features. Report bugs via GitHub issues, but note that Spatie may not actively maintain it. For critical fixes, consider self-hosting patches or switching to a more actively supported alternative.
Weaver
How can I help you explore Laravel packages today?