---
title: "Dotazy na štatistiky — Plausible for Laravel | Roundly"
description: "Realtime návštevníci, súhrny, časové rady a rozpady cez fluentný builder s typovanými výsledkami a skratkami období."
url: https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel/statistiky
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Plausible for Laravel](https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel.md)

# Dotazy na štatistiky

Odporúčaný spôsob čítania štatistík je fluentný builder. Začnite ho cez for($site) — alebo query() pre nakonfigurovaný predvolený web — pridajte voľby a ukončite terminálnym volaním, ktoré vráti typovaný výsledok, takže JSON už nemusíte parsovať ručne. Enumy dávajú typovo bezpečné metriky, obdobia, intervaly a vlastnosti; bežné reťazce fungujú všade tiež.

```php
use RoundlyConsulting\Plausible\Facades\Plausible;

Plausible::stats()->for('my-site.com');  // a fluent PendingStatsQuery for one site
Plausible::stats()->query();             // the same, for the configured PLAUSIBLE_SITE
```

## Návštevníci v reálnom čase

```php
$live = Plausible::stats()->for('my-site.com')->realtime(); // int — visitors on the site right now
```

## Súhrn (aggregate)

aggregate() vráti AggregateResult. metric() dá hodnotu metriky (0, ak chýba), change() rozdiel oproti predchádzajúcemu obdobiu pri zapnutom compare() a has() to, či je metrika v odpovedi:

```php
use RoundlyConsulting\Plausible\Enums\Metric;

// Aggregate metrics for a custom range, compared with the previous period
$result = Plausible::stats()
    ->for('my-site.com')
    ->metrics(Metric::Visitors, Metric::Pageviews, Metric::BounceRate)
    ->between(now()->subDays(7), now())           // auto-sets period=custom
    ->compare()
    ->aggregate();                                // -> AggregateResult

$visitors = $result->metric(Metric::Visitors);    // typed int
$change   = $result->change(Metric::Visitors);    // comparison delta (or null)
$result->has(Metric::BounceRate);                 // bool
$result->results;                                 // ['visitors' => ['value' => 2001, 'change' => 30], …]
$raw      = $result->response();                  // escape hatch to the Response
```

## Časový rad (timeseries)

timeseries() vráti TimeseriesResult s objektmi TimeseriesPoint — každý má dátum ako Carbon a svoje metriky. Endpoint časových radov vo v1 prijme iba intervaly date (alias day) a month; minute, hour či week vyhodia UnsupportedRequest ešte pred odoslaním — hodinové alebo týždenné úseky získate cez run() s Dimension::TimeHour alebo Dimension::TimeWeek (Dotazy Stats v2):

```php
use RoundlyConsulting\Plausible\Enums\Interval;
use RoundlyConsulting\Plausible\Enums\Metric;
use RoundlyConsulting\Plausible\Enums\Period;

// Day-by-day trend you can chart
$points = Plausible::stats()
    ->for('my-site.com')
    ->metrics(Metric::Visitors, Metric::Pageviews)
    ->period(Period::ThirtyDays)
    ->interval(Interval::Date)                    // date or month — hourly or weekly buckets go through run()
    ->timeseries()                                // -> TimeseriesResult
    ->points();                                   // list<TimeseriesPoint>

foreach ($points as $point) {
    $point->date;                                 // Carbon
    $point->metric(Metric::Visitors);             // int|float
}
```

## Rozpad (breakdown)

breakdown() potrebuje vlastnosť — odovzdajte ju terminálnemu volaniu alebo ju nastavte skôr cez property(); bez nej vyhodí MissingConfiguration s upozornením na chýbajúcu vlastnosť. Riadky zachovávajú kľúče z odpovede Plausible, takže dimenziu čítate cez get() (page pre event:page) a metriky cez metric():

```php
use RoundlyConsulting\Plausible\Enums\Metric;
use RoundlyConsulting\Plausible\Enums\Property;

// Top pages, ranked and paginated
$rows = Plausible::stats()
    ->for('my-site.com')
    ->metrics(Metric::Visitors)
    ->last30Days()
    ->perPage(20)                                 // default 100
    ->breakdown(Property::EventPage)              // -> BreakdownResult
    ->rows();                                     // list<BreakdownRow>

foreach ($rows as $row) {
    $row->get('page');                            // "/pricing" — the dimension, by its response key
    $row->metric(Metric::Visitors);               // int|float
}

// Or set the property first
Plausible::stats()->for('my-site.com')->property(Property::VisitSource)->breakdown();
```

## Obdobia a rozsahy dátumov

Pre bežné rozsahy použite pomenované skratky namiesto enumu, prípadne zadajte ľubovoľné Period alebo explicitný rozsah:

```php
use RoundlyConsulting\Plausible\Enums\Period;

Plausible::stats()->for('my-site.com')->today()->aggregate();
Plausible::stats()->for('my-site.com')->yesterday()->aggregate();      // custom range
Plausible::stats()->for('my-site.com')->last7Days()->timeseries();
Plausible::stats()->for('my-site.com')->last30Days()->aggregate();
Plausible::stats()->for('my-site.com')->last6Months()->timeseries();
Plausible::stats()->for('my-site.com')->last12Months()->timeseries();
Plausible::stats()->for('my-site.com')->thisMonth()->aggregate();
Plausible::stats()->for('my-site.com')->lastMonth()->aggregate();      // custom range
Plausible::stats()->for('my-site.com')->thisYear()->aggregate();     // v1: custom range, 1 January to today
Plausible::stats()->for('my-site.com')->allTime()->run();            // run() only — v1 terminals throw UnsupportedRequest

// Any Period, or an explicit range
Plausible::stats()->for('my-site.com')->period(Period::SixMonths)->aggregate();
Plausible::stats()->for('my-site.com')->between(now()->subDays(14), now())->aggregate();
Plausible::stats()->for('my-site.com')->since(now()->startOfYear())->aggregate();   // year to date — through today
```

| Skratka | Odošle |
| --- | --- |
| `today()` | period=day |
| `yesterday()` | vlastný rozsah — včerajšok od začiatku do konca dňa |
| `last7Days()` | period=7d |
| `last30Days()` | period=30d |
| `last6Months()` | period=6mo |
| `last12Months()` | period=12mo |
| `thisMonth()` | period=month |
| `lastMonth()` | vlastný rozsah — predchádzajúci kalendárny mesiac |
| `thisYear()` | period=year |
| `allTime()` | period=all |

between(Carbon $start, Carbon $end) aj since(Carbon $start) za vás nastavia period=custom s uzavretým rozsahom: terminály v1 pošlú date=start,end a run() pošle date\_range: \[start, end\]. since() siaha po dnešok v časovom pásme aplikácie, určený v momente volania. Neskoršie period() alebo skratka ako last7Days() nahradí skorší rozsah z between(), since(), yesterday() či lastMonth(). Terminály v1 nepoznajú obdobie year ani all: thisYear() im balík pošle ako vlastný rozsah od 1. januára po dnešok, kým allTime() vyhodí UnsupportedRequest s odkazom na run(), ktorý obe obdobia pošle nezmenené. Nenastavené voľby majú predvolené hodnoty buildera: metrika visitors, obdobie 30d, interval date, strana 1 a 100 riadkov na stranu.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel.md)