nicdev/ga-reporter

A PHP client for the Google Analytics API

Maintainers

Details

github.com/nicdev/ga-reporter

Source

Issues

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

dev-main 2025-07-08 01:04 UTC

Requires

Requires (Dev)

MIT c6d98e41979de77e262535939e1b8bfb5e65de23

This package is auto-updated.

Last update: 2025-07-08 01:05:51 UTC

README

A modern PHP client for the Google Analytics API

Installation

composer require nicdev/ga-reporter

Setup

  1. Create a Google Cloud Project
  2. Enable the Google Analytics API
  3. Create credentials (OAuth 2.0 or Service Account)
  4. Download your credentials JSON file

Usage

// Initialize with credentials
$client = new \Nicdev\GoogleAnalytics\Client([
    'credentials_path' => '/path/to/credentials.json'
]);

// Create Reporter instance
$reporter = new \Nicdev\GoogleAnalytics\Reporter($client);

// Get page views for last 30 days
$startDate = new DateTime('30 days ago');
$endDate = new DateTime();
$pageViews = $reporter->getPageViews('VIEW_ID', $startDate, $endDate);

// Get real-time users
$activeUsers = $reporter->getRealTimeUsers('VIEW_ID');

Features

  • Universal Analytics (UA) and GA4 support
  • Real-time reporting
  • Audience metrics
  • Event tracking
  • Custom dimensions and metrics
  • Automatic token refresh
  • PSR-4 compliant

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.