README

A unified analytics bridge for Laravel providing a consistent API across multiple analytics providers such as Google Analytics, Matomo, and others.

Features

Unified API for multiple analytics services
Drivers for Google Analytics, Matomo, and others
Returns time series (per day) for page views, visits, visit duration
Aggregates top countries and referrers
Integrates PageSpeed Insights (CrUX real-user data) for Web Vitals
Easily extendable with new drivers

Installation

Install the driver package you need:

# for Google Analytics
composer require aimeos/laravel-analytics-google
# for Matomo
composer require aimeos/laravel-analytics-matomo

Configuration

Publish the configuration file:

php artisan vendor:publish --tag=config

This creates the ./config/analytics-bridge.php file:

return [
    'default' => env('ANALYTICS_DRIVER', 'matomo'),

    'drivers' => [
        'google' => [
            'property_id' => env('ANALYTICS_GOOGLE_PROPERTY_ID'),
            'credentials' => storage_path('app/analytics/google.json'),
        ],

        'matomo' => [
            'url' => env('ANALYTICS_MATOMO_URL'),
            'site_id' => env('ANALYTICS_MATOMO_SITE_ID'),
            'token' => env('ANALYTICS_MATOMO_TOKEN'),
        ],
    ],
];

Set your .env accordingly.

API Usage

Import the facade:

use Aimeos\AnalyticsBridge\Facades\Analytics;

Page Time Series

// Number of page views for the last 30 days
$pageViews = Analytics::pageViews('/', 30);

// Number of visits for the last 30 days
$visits = Analytics::visits('/', 30);

// Average visit duration (seconds) per day
$durations = Analytics::visitDurations('/', 30);

Each returns arrays with one entry per day:

[
    ['key' => '2025-08-01', 'value' => 123],
    ['key' => '2025-08-02', 'value' => 97],
    ...
]

Top Aggregates

// Top countries by visit count
$countries = Analytics::countries('/', 30);

// Top referrers by visit count
$referrers = Analytics::referrers('/', 30);

Each returns total counts over timeframe:

[
    ['key' => 'Germany', 'value' => 321],
    ['key' => 'USA', 'value' => 244],
    ...
]

Combined Fetch

$data = Analytics::all('https://aimeos.org/features', 30);

Returns:

[
    'pageViews'     => [/* ... */],
    'visits'        => [/* ... */],
    'visitDuration' => [/* ... */],
    'countries'     => [/* ... */],
    'referrers'     => [/* ... */],
]

Implemnt new Driver

For a new analyics service (e.g. Foobar), create a new composer package, e.g. yourorg/laravel-analytics-foobar. Replace every occurrence of "yourorg" and "foobar" with own vendor name and resp. the service name.

Use this composer.json as template:

{
  "name": "yourorg/laravel-analytics-foobar",
  "description": "Foobar driver for Laravel Analytics Bridge",
  "type": "library",
  "license": "LGPL-2.1+",
  "autoload": {
    "psr-4": {
      "Aimeos\\AnalyticsBridge\\Drivers\\": "src/"
    }
  },
  "require": {
    "php": "^8.1",
    "aimeos/laravel-analytics-bridge": "~1.0"
  },
  "provide": {
    "aimeos/laravel-analytics-driver": "*"
  }
}

Create a ./src/Foobar.php file that implements fetching the data from the analytics service. The skeleton class is:

<?php

namespace Aimeos\AnalyticsBridge\Drivers;

use Aimeos\AnalyticsBridge\Contracts\Driver;

class Foobar implements Driver
{
    public function __construct(array $config = [])
    {
        // $config from ./config/analytics-bridge.php
    }

    public function pageViews(string $path, int $days = 30): array
    {
        return [];
    }

    public function visits(string $path, int $days = 30): array
    {
        return [];
    }

    public function visitDurations(string $path, int $days = 30): array
    {
        return [];
    }

    public function countries(string $path, int $days = 30): array
    {
        return [];
    }

    public function referrers(string $path, int $days = 30): array
    {
        return [];
    }
}

Install your package using composer:

composer require yourorg/laravel-analytics-foobar

'drivers' => [
    'foobar' => [
        'url' => env('FOOBAR_URL'),
        // more required settings
    ]
],

License

This package is released under the LGPL-2.1+ License.

aimeos / laravel-analytics-bridge

Maintainers

Details