reports: Basiswerte für die Konversionsmessung (Roadmap 0.1 und 0.2)
Beide Werte müssen gemessen sein, bevor die erste Maßnahme aus Block 1 live geht — ohne Vergleichspunkt wäre jede spätere Bewertung eine Vermutung. press-releases:view-distribution gibt die Verteilung der Aufrufzahlen je Portal aus: Median, Quartile, P10/P90 und eine Häufigkeitsverteilung. Ein Mittelwert allein trägt hier nicht — eine Handvoll Ausreißer zieht ihn nach oben, während der typische Absender darunter liegt. Genau davor soll E2 schützen, deshalb wird die Schiefe (Mittelwert gegen Median) ausdrücklich mit ausgewiesen. Altbestand und seit dem Relaunch eingegangene Meldungen stehen getrennt: Ihre Zähler haben unterschiedliche Vorgeschichten, und eine Einordnung, die beide vermischt, vergleicht Äpfel mit Birnen. Mit 410 entfernte Meldungen zählen nicht mit, eine Meldung auf beiden Portalen bei beiden. press-releases:rejection-rate gibt die Ablehnungsquote je Einreichungsquelle aus. Gezählt wird je EINREICHUNG, nicht je Meldung: Ein Übergang nach `review` eröffnet eine Einreichung, die nächste Entscheidung schließt sie. Eine überarbeitete und erneut eingereichte Meldung ist damit ein zweiter Vorgang mit eigenem Ausgang — und genau das ist die Größe, die die Infoseite (1d) später verändern soll. Gruppiert wird nach dem Einreichenden, nicht nach dem Entscheider; letzterer ist immer die KI-Prüfung und als Gruppierung wertlos. Jeder API-Client bekommt eine eigene Zeile, Einreichungen aus dem Kundenbereich fallen zu "direkt" zusammen. Noch offene Prüfungen zählen nicht in den Nenner, sonst sänke die Quote allein dadurch, dass der Zeitraum bis heute reicht. Entscheidungen zu Einreichungen von vor dem Zeitraum werden gemeldet statt verschluckt — ein zu kurz gewählter Zeitraum sähe sonst wie eine niedrige Quote aus. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
81d9c43ab7
commit
aab22401d0
6 changed files with 819 additions and 7 deletions
105
app/Console/Commands/ReportPressReleaseViews.php
Normal file
105
app/Console/Commands/ReportPressReleaseViews.php
Normal file
|
|
@ -0,0 +1,105 @@
|
|||
<?php
|
||||
|
||||
namespace App\Console\Commands;
|
||||
|
||||
use App\Services\PressRelease\ViewDistributionReport;
|
||||
use Illuminate\Console\Command;
|
||||
use Illuminate\Support\Carbon;
|
||||
|
||||
/**
|
||||
* Basiswert der Aufrufzahlen (Roadmap 0.1).
|
||||
*
|
||||
* Muss gemessen sein, BEVOR die erste Maßnahme aus Block 1 live geht — ohne
|
||||
* Vergleichspunkt wird jede spätere Bewertung eine Vermutung. Die Verteilung
|
||||
* entscheidet zugleich E2: ob die Absenderansicht Rohzahlen zeigt oder eine
|
||||
* Einordnung gegen den Portalschnitt.
|
||||
*/
|
||||
class ReportPressReleaseViews extends Command
|
||||
{
|
||||
protected $signature = 'press-releases:view-distribution
|
||||
{--months=3 : Zeitraum in Monaten rückwärts}
|
||||
{--from= : Startdatum, überschreibt --months}
|
||||
{--to= : Enddatum (Standard: heute)}
|
||||
{--json : Ausgabe als JSON statt als Tabelle}';
|
||||
|
||||
protected $description = 'Basiswert: Verteilung der Aufrufzahlen je Portal (Median, Quartile, Häufigkeiten).';
|
||||
|
||||
public function handle(ViewDistributionReport $report): int
|
||||
{
|
||||
$to = $this->option('to') !== null ? Carbon::parse((string) $this->option('to')) : Carbon::now();
|
||||
$from = $this->option('from') !== null
|
||||
? Carbon::parse((string) $this->option('from'))
|
||||
: $to->copy()->subMonths(max(1, (int) $this->option('months')));
|
||||
|
||||
$data = $report->build($from, $to);
|
||||
|
||||
if ($this->option('json')) {
|
||||
$this->line((string) json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
|
||||
$this->info("Aufrufzahlen je Portal — veröffentlicht {$data['from']} bis {$data['to']}");
|
||||
|
||||
foreach ($data['portals'] as $portal) {
|
||||
$this->newLine();
|
||||
$this->line("<comment>{$portal['label']}</comment>");
|
||||
|
||||
$rows = [];
|
||||
|
||||
foreach ($portal['segments'] as $segment) {
|
||||
$s = $segment['stats'];
|
||||
|
||||
if ($s['anzahl'] === 0) {
|
||||
$rows[] = [$segment['segment'], 0, '–', '–', '–', '–', '–', '–', '–'];
|
||||
|
||||
continue;
|
||||
}
|
||||
|
||||
$rows[] = [
|
||||
$segment['segment'],
|
||||
$s['anzahl'],
|
||||
$s['min'],
|
||||
$s['p10'],
|
||||
$s['p25'],
|
||||
$s['median'],
|
||||
$s['p75'],
|
||||
$s['p90'],
|
||||
$s['max'],
|
||||
];
|
||||
}
|
||||
|
||||
$this->table(['Bestand', 'PMs', 'Min', 'P10', 'P25', 'Median', 'P75', 'P90', 'Max'], $rows);
|
||||
|
||||
$gesamt = $portal['segments'][0]['stats'];
|
||||
|
||||
if ($gesamt['anzahl'] === 0) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$this->line(sprintf(
|
||||
' Mittelwert %s gegenüber Median %d%s',
|
||||
$gesamt['mittelwert'],
|
||||
$gesamt['median'],
|
||||
// Die Schiefe ist die eigentliche Antwort auf E2: Zieht eine
|
||||
// Handvoll Ausreißer den Schnitt nach oben, liegt der typische
|
||||
// Absender darunter und eine Rohzahl liest sich für ihn als
|
||||
// Misserfolg.
|
||||
$gesamt['mittelwert'] > $gesamt['median'] * 1.25
|
||||
? ' ← rechtsschief, Rohzahlen wirken für die Mehrheit enttäuschend'
|
||||
: '',
|
||||
));
|
||||
|
||||
$verteilung = [];
|
||||
|
||||
foreach ($gesamt['verteilung'] as $klasse => $anzahl) {
|
||||
$anteil = $gesamt['anzahl'] > 0 ? round($anzahl / $gesamt['anzahl'] * 100) : 0;
|
||||
$verteilung[] = [$klasse.' Aufrufe', $anzahl, $anteil.' %'];
|
||||
}
|
||||
|
||||
$this->table(['Klasse', 'PMs', 'Anteil'], $verteilung);
|
||||
}
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
}
|
||||
90
app/Console/Commands/ReportRejectionRate.php
Normal file
90
app/Console/Commands/ReportRejectionRate.php
Normal file
|
|
@ -0,0 +1,90 @@
|
|||
<?php
|
||||
|
||||
namespace App\Console\Commands;
|
||||
|
||||
use App\Services\PressRelease\RejectionRateReport;
|
||||
use Illuminate\Console\Command;
|
||||
use Illuminate\Support\Carbon;
|
||||
use Symfony\Component\Console\Helper\TableSeparator;
|
||||
|
||||
/**
|
||||
* Basiswert der Ablehnungsquote je Quelle (Roadmap 0.2).
|
||||
*
|
||||
* Als wiederkehrende Auswertung angelegt: Die Zahl wird für das
|
||||
* connektar-Gespräch gebraucht und ist zugleich der Vergleichspunkt, gegen den
|
||||
* später die Wirkung der Infoseite (1d) gemessen wird.
|
||||
*/
|
||||
class ReportRejectionRate extends Command
|
||||
{
|
||||
protected $signature = 'press-releases:rejection-rate
|
||||
{--months=3 : Zeitraum in Monaten rückwärts}
|
||||
{--from= : Startdatum, überschreibt --months}
|
||||
{--to= : Enddatum (Standard: jetzt)}
|
||||
{--json : Ausgabe als JSON statt als Tabelle}';
|
||||
|
||||
protected $description = 'Basiswert: Ablehnungsquote je Einreichungsquelle (API-Client, Kundenbereich, Redaktion).';
|
||||
|
||||
public function handle(RejectionRateReport $report): int
|
||||
{
|
||||
$to = $this->option('to') !== null ? Carbon::parse((string) $this->option('to')) : Carbon::now();
|
||||
$from = $this->option('from') !== null
|
||||
? Carbon::parse((string) $this->option('from'))
|
||||
: $to->copy()->subMonths(max(1, (int) $this->option('months')));
|
||||
|
||||
$data = $report->build($from, $to);
|
||||
|
||||
if ($this->option('json')) {
|
||||
$this->line((string) json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
|
||||
$this->info("Ablehnungsquote je Quelle — {$data['from']} bis {$data['to']}");
|
||||
$this->newLine();
|
||||
|
||||
if ($data['sources'] === []) {
|
||||
$this->warn('Keine Einreichungen im Zeitraum.');
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
|
||||
$rows = [];
|
||||
|
||||
foreach ($data['sources'] as $source) {
|
||||
$rows[] = [
|
||||
$source['label'],
|
||||
$source['eingereicht'],
|
||||
$source['veroeffentlicht'],
|
||||
$source['abgelehnt'],
|
||||
$source['offen'],
|
||||
$source['quote'] === null ? '–' : $source['quote'].' %',
|
||||
];
|
||||
}
|
||||
|
||||
$t = $data['totals'];
|
||||
$rows[] = new TableSeparator;
|
||||
$rows[] = [
|
||||
'<comment>gesamt</comment>',
|
||||
$t['eingereicht'],
|
||||
$t['veroeffentlicht'],
|
||||
$t['abgelehnt'],
|
||||
$t['offen'],
|
||||
$t['quote'] === null ? '–' : '<comment>'.$t['quote'].' %</comment>',
|
||||
];
|
||||
|
||||
$this->table(['Quelle', 'Eingereicht', 'Veröffentlicht', 'Abgelehnt', 'Offen', 'Quote'], $rows);
|
||||
|
||||
$this->line(' Quote = abgelehnt / entschieden. Noch offene Prüfungen zählen nicht in den Nenner.');
|
||||
|
||||
if ($data['entscheidungen_ohne_einreichung'] > 0) {
|
||||
$this->newLine();
|
||||
$this->warn(sprintf(
|
||||
'%d Entscheidungen betreffen Einreichungen von VOR dem Zeitraum und sind keiner Quelle zugeordnet. '
|
||||
.'Für einen belastbaren Basiswert den Zeitraum weiter zurück legen.',
|
||||
$data['entscheidungen_ohne_einreichung'],
|
||||
));
|
||||
}
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
}
|
||||
204
app/Services/PressRelease/RejectionRateReport.php
Normal file
204
app/Services/PressRelease/RejectionRateReport.php
Normal file
|
|
@ -0,0 +1,204 @@
|
|||
<?php
|
||||
|
||||
namespace App\Services\PressRelease;
|
||||
|
||||
use App\Enums\PressReleaseStatus;
|
||||
use App\Models\PressReleaseStatusLog;
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Carbon;
|
||||
|
||||
/**
|
||||
* Basiswert der Ablehnungsquote je Quelle (Roadmap 0.2).
|
||||
*
|
||||
* Zwei Verwendungen: als Zahl für das connektar-Gespräch, und als
|
||||
* Vergleichspunkt, gegen den später die Wirkung der Infoseite (1d) gemessen
|
||||
* wird. Die Wiedereinreichung nach Ablehnung gehört ausdrücklich NICHT in die
|
||||
* Konversionsleiter, sondern wird gegen diesen Basiswert geführt.
|
||||
*
|
||||
* Gezählt wird je EINREICHUNG, nicht je Meldung: Ein Übergang nach `review`
|
||||
* eröffnet eine Einreichung, die nächste Entscheidung (`published` oder
|
||||
* `rejected`) schließt sie. Wird eine abgelehnte Meldung überarbeitet und
|
||||
* erneut eingereicht, sind das zwei Einreichungen mit eigenem Ausgang — und
|
||||
* genau das ist die Größe, die 1d verändern soll.
|
||||
*
|
||||
* Die Quelle stammt vom Übergang nach `review` (wer eingereicht hat), nicht
|
||||
* von der Entscheidung — die trifft immer die KI-Prüfung und wäre als
|
||||
* Gruppierung wertlos.
|
||||
*/
|
||||
class RejectionRateReport
|
||||
{
|
||||
/**
|
||||
* @return array{
|
||||
* from: string,
|
||||
* to: string,
|
||||
* sources: list<array{key: string, label: string, eingereicht: int, veroeffentlicht: int, abgelehnt: int, offen: int, quote: float|null}>,
|
||||
* totals: array{eingereicht: int, veroeffentlicht: int, abgelehnt: int, offen: int, quote: float|null},
|
||||
* entscheidungen_ohne_einreichung: int,
|
||||
* }
|
||||
*/
|
||||
public function build(Carbon $from, ?Carbon $to = null): array
|
||||
{
|
||||
$to ??= Carbon::now();
|
||||
|
||||
$logs = PressReleaseStatusLog::query()
|
||||
->whereIn('to_status', [
|
||||
PressReleaseStatus::Review->value,
|
||||
PressReleaseStatus::Published->value,
|
||||
PressReleaseStatus::Rejected->value,
|
||||
])
|
||||
->whereBetween('created_at', [$from, $to])
|
||||
->orderBy('press_release_id')
|
||||
->orderBy('id')
|
||||
->get(['press_release_id', 'to_status', 'source', 'changed_by_user_id']);
|
||||
|
||||
$buckets = [];
|
||||
$orphans = 0;
|
||||
$open = null;
|
||||
|
||||
foreach ($logs as $log) {
|
||||
$status = $log->to_status;
|
||||
|
||||
if ($status === PressReleaseStatus::Review) {
|
||||
// Zwei Einreichungen ohne Entscheidung dazwischen: die erste
|
||||
// ist noch offen (in Prüfung) und wird als solche gezählt.
|
||||
if ($open !== null) {
|
||||
$this->add($buckets, $open, 'offen');
|
||||
}
|
||||
|
||||
$open = ['source' => (string) $log->source, 'user_id' => $log->changed_by_user_id];
|
||||
$this->add($buckets, $open, 'eingereicht');
|
||||
|
||||
continue;
|
||||
}
|
||||
|
||||
if ($open === null) {
|
||||
// Entscheidung zu einer Einreichung, die vor dem Zeitraum lag.
|
||||
// Nicht zuordenbar — wird gemeldet statt stillschweigend
|
||||
// verschluckt, sonst sähe ein zu kurz gewählter Zeitraum wie
|
||||
// eine niedrige Quote aus.
|
||||
$orphans++;
|
||||
|
||||
continue;
|
||||
}
|
||||
|
||||
$this->add($buckets, $open, $status === PressReleaseStatus::Rejected ? 'abgelehnt' : 'veroeffentlicht');
|
||||
$open = null;
|
||||
}
|
||||
|
||||
if ($open !== null) {
|
||||
$this->add($buckets, $open, 'offen');
|
||||
}
|
||||
|
||||
return $this->summarise($buckets, $from, $to, $orphans);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, array<string, mixed>> $buckets
|
||||
* @param array{source: string, user_id: int|null} $submission
|
||||
*/
|
||||
private function add(array &$buckets, array $submission, string $field): void
|
||||
{
|
||||
$key = $this->bucketKey($submission);
|
||||
|
||||
$buckets[$key] ??= [
|
||||
'key' => $key,
|
||||
'user_id' => $submission['user_id'],
|
||||
'source' => $submission['source'],
|
||||
'eingereicht' => 0,
|
||||
'veroeffentlicht' => 0,
|
||||
'abgelehnt' => 0,
|
||||
'offen' => 0,
|
||||
];
|
||||
|
||||
$buckets[$key][$field]++;
|
||||
}
|
||||
|
||||
/**
|
||||
* Jeder API-Client ist eine eigene Quelle — der Sinn der Auswertung ist ja
|
||||
* gerade, sie zu vergleichen. Einreichungen aus dem Kundenbereich fallen
|
||||
* dagegen zu „direkt" zusammen; dort ist der einzelne Absender keine
|
||||
* Quelle, sondern ein Einzelfall.
|
||||
*
|
||||
* @param array{source: string, user_id: int|null} $submission
|
||||
*/
|
||||
private function bucketKey(array $submission): string
|
||||
{
|
||||
return $submission['source'] === 'api'
|
||||
? 'api:'.($submission['user_id'] ?? 0)
|
||||
: $submission['source'];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, array<string, mixed>> $buckets
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private function summarise(array $buckets, Carbon $from, Carbon $to, int $orphans): array
|
||||
{
|
||||
$names = User::query()
|
||||
->whereIn('id', array_filter(array_column($buckets, 'user_id')))
|
||||
->get(['id', 'name', 'agency_name'])
|
||||
->mapWithKeys(fn (User $u): array => [$u->id => trim((string) $u->agency_name) ?: (string) $u->name]);
|
||||
|
||||
$sources = [];
|
||||
$totals = ['eingereicht' => 0, 'veroeffentlicht' => 0, 'abgelehnt' => 0, 'offen' => 0];
|
||||
|
||||
foreach ($buckets as $bucket) {
|
||||
$sources[] = [
|
||||
'key' => $bucket['key'],
|
||||
'label' => $this->label($bucket, $names->all()),
|
||||
'eingereicht' => $bucket['eingereicht'],
|
||||
'veroeffentlicht' => $bucket['veroeffentlicht'],
|
||||
'abgelehnt' => $bucket['abgelehnt'],
|
||||
'offen' => $bucket['offen'],
|
||||
'quote' => $this->rate($bucket['veroeffentlicht'], $bucket['abgelehnt']),
|
||||
];
|
||||
|
||||
foreach ($totals as $field => $value) {
|
||||
$totals[$field] = $value + $bucket[$field];
|
||||
}
|
||||
}
|
||||
|
||||
usort($sources, static fn (array $a, array $b): int => $b['eingereicht'] <=> $a['eingereicht']);
|
||||
|
||||
$totals['quote'] = $this->rate($totals['veroeffentlicht'], $totals['abgelehnt']);
|
||||
|
||||
return [
|
||||
'from' => $from->toDateString(),
|
||||
'to' => $to->toDateString(),
|
||||
'sources' => $sources,
|
||||
'totals' => $totals,
|
||||
'entscheidungen_ohne_einreichung' => $orphans,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $bucket
|
||||
* @param array<int, string> $names
|
||||
*/
|
||||
private function label(array $bucket, array $names): string
|
||||
{
|
||||
if ($bucket['source'] !== 'api') {
|
||||
return match ($bucket['source']) {
|
||||
'customer', 'web' => 'direkt (Kundenbereich)',
|
||||
'admin' => 'Redaktion',
|
||||
default => (string) $bucket['source'],
|
||||
};
|
||||
}
|
||||
|
||||
$userId = $bucket['user_id'];
|
||||
|
||||
return sprintf('API: %s (#%s)', $names[$userId] ?? 'unbekannt', $userId ?? '?');
|
||||
}
|
||||
|
||||
/**
|
||||
* Bezugsgröße sind die ENTSCHIEDENEN Einreichungen. Noch offene Prüfungen
|
||||
* gehören nicht in den Nenner — sonst sänke die Quote allein dadurch, dass
|
||||
* der Zeitraum bis an den heutigen Tag reicht.
|
||||
*/
|
||||
private function rate(int $published, int $rejected): ?float
|
||||
{
|
||||
$decided = $published + $rejected;
|
||||
|
||||
return $decided === 0 ? null : round($rejected / $decided * 100, 1);
|
||||
}
|
||||
}
|
||||
171
app/Services/PressRelease/ViewDistributionReport.php
Normal file
171
app/Services/PressRelease/ViewDistributionReport.php
Normal file
|
|
@ -0,0 +1,171 @@
|
|||
<?php
|
||||
|
||||
namespace App\Services\PressRelease;
|
||||
|
||||
use App\Enums\Portal;
|
||||
use App\Enums\PressReleaseStatus;
|
||||
use App\Models\PressRelease;
|
||||
use App\Scopes\PortalScope;
|
||||
use Illuminate\Database\Eloquent\Builder;
|
||||
use Illuminate\Support\Carbon;
|
||||
|
||||
/**
|
||||
* Basiswert der Aufrufzahlen (Roadmap 0.1): Verteilung der Aufrufe je Portal
|
||||
* über einen Zeitraum.
|
||||
*
|
||||
* Wozu: Die geplante Absenderansicht (1c.1) macht öffentlich, was bisher
|
||||
* niemand belegen musste. Fällt die Verteilung schwach aus, werden Rohzahlen
|
||||
* zum Nachteil und es braucht eine Einordnung gegen den Portalschnitt — das
|
||||
* ist Entscheidung E2, und sie muss VOR dem Bau fallen. Dafür reicht kein
|
||||
* Mittelwert: Eine Handvoll Ausreißer zieht ihn nach oben, während der
|
||||
* typische Absender darunter liegt. Maßgeblich ist der Median.
|
||||
*
|
||||
* Der Mittelwert wird trotzdem mitgeführt, aber nur, damit die Schiefe der
|
||||
* Verteilung sichtbar wird: Liegt er deutlich über dem Median, ist genau der
|
||||
* Fall eingetreten, vor dem E2 schützen soll.
|
||||
*
|
||||
* Gezählt wird `press_releases.hits` — der Gesamtzähler. Das Ereignis-Log
|
||||
* taugt für diesen Basiswert nicht: Es läuft erst seit dem Umbau des
|
||||
* Aufruf-Zählers und kennt den Altbestand nicht.
|
||||
*
|
||||
* Legacy-Bestand und seit dem Relaunch eingegangene Meldungen werden getrennt
|
||||
* ausgewiesen. Ihre Zähler haben unterschiedliche Vorgeschichten (im
|
||||
* Altsystem gesammelt gegenüber hier gezählt), und eine Einordnung, die beide
|
||||
* vermischt, vergleicht Äpfel mit Birnen.
|
||||
*/
|
||||
class ViewDistributionReport
|
||||
{
|
||||
/**
|
||||
* Grenzen der Häufigkeitsverteilung (Untergrenze je Klasse).
|
||||
*
|
||||
* @var list<int>
|
||||
*/
|
||||
private const Buckets = [0, 25, 50, 100, 200, 500, 1000];
|
||||
|
||||
/**
|
||||
* @return array{
|
||||
* from: string,
|
||||
* to: string,
|
||||
* portals: list<array{portal: string, label: string, segments: list<array{segment: string, stats: array{anzahl: int, min?: int, p10?: int, p25?: int, median?: int, p75?: int, p90?: int, max?: int, mittelwert?: float, verteilung?: array<string, int>}}>}>,
|
||||
* }
|
||||
*/
|
||||
public function build(Carbon $from, ?Carbon $to = null): array
|
||||
{
|
||||
$to ??= Carbon::now();
|
||||
|
||||
$portals = [];
|
||||
|
||||
foreach ([Portal::Presseecho, Portal::Businessportal24] as $portal) {
|
||||
$segments = [];
|
||||
|
||||
foreach (['gesamt' => null, 'seit Relaunch' => true, 'Altbestand' => false] as $label => $onlyNew) {
|
||||
$hits = $this->hits($portal, $from, $to, $onlyNew);
|
||||
|
||||
if ($hits === [] && $label !== 'gesamt') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$segments[] = ['segment' => $label, 'stats' => $this->describe($hits)];
|
||||
}
|
||||
|
||||
$portals[] = [
|
||||
'portal' => $portal->value,
|
||||
'label' => $portal->label(),
|
||||
'segments' => $segments,
|
||||
];
|
||||
}
|
||||
|
||||
return [
|
||||
'from' => $from->toDateString(),
|
||||
'to' => $to->toDateString(),
|
||||
'portals' => $portals,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Aufrufzahlen der im Zeitraum veröffentlichten Meldungen.
|
||||
*
|
||||
* Eine Meldung mit `portal = both` erscheint auf beiden Portalen und zählt
|
||||
* deshalb bei beiden mit — der Zähler ist einer, die Sichtbarkeit doppelt.
|
||||
*
|
||||
* @return list<int>
|
||||
*/
|
||||
private function hits(Portal $portal, Carbon $from, Carbon $to, ?bool $onlyNew): array
|
||||
{
|
||||
return PressRelease::query()
|
||||
->withoutGlobalScope(PortalScope::class)
|
||||
->whereIn('portal', [$portal->value, Portal::Both->value])
|
||||
->where('status', PressReleaseStatus::Published->value)
|
||||
->whereNull('gone_at')
|
||||
->whereBetween('published_at', [$from, $to])
|
||||
->when($onlyNew === true, fn (Builder $query) => $query->whereNull('legacy_portal'))
|
||||
->when($onlyNew === false, fn (Builder $query) => $query->whereNotNull('legacy_portal'))
|
||||
->orderBy('hits')
|
||||
->pluck('hits')
|
||||
->map(static fn ($hits): int => (int) $hits)
|
||||
->all();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<int> $hits aufsteigend sortiert
|
||||
* @return array{anzahl: int, min?: int, p10?: int, p25?: int, median?: int, p75?: int, p90?: int, max?: int, mittelwert?: float, verteilung?: array<string, int>}
|
||||
*/
|
||||
private function describe(array $hits): array
|
||||
{
|
||||
$count = count($hits);
|
||||
|
||||
if ($count === 0) {
|
||||
return ['anzahl' => 0];
|
||||
}
|
||||
|
||||
return [
|
||||
'anzahl' => $count,
|
||||
'min' => $hits[0],
|
||||
'p10' => $this->percentile($hits, 0.10),
|
||||
'p25' => $this->percentile($hits, 0.25),
|
||||
'median' => $this->percentile($hits, 0.50),
|
||||
'p75' => $this->percentile($hits, 0.75),
|
||||
'p90' => $this->percentile($hits, 0.90),
|
||||
'max' => $hits[$count - 1],
|
||||
'mittelwert' => round(array_sum($hits) / $count, 1),
|
||||
'verteilung' => $this->histogram($hits),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Perzentil nach der „nearest rank"-Methode: Der zurückgegebene Wert ist
|
||||
* immer eine tatsächlich gemessene Aufrufzahl, kein interpolierter
|
||||
* Zwischenwert. Für eine Einordnung („die Hälfte der Meldungen liegt
|
||||
* darunter") ist das die ehrlichere Angabe.
|
||||
*
|
||||
* @param list<int> $sorted
|
||||
*/
|
||||
private function percentile(array $sorted, float $fraction): int
|
||||
{
|
||||
$rank = (int) ceil($fraction * count($sorted));
|
||||
|
||||
return $sorted[max(0, $rank - 1)];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<int> $hits
|
||||
* @return array<string, int>
|
||||
*/
|
||||
private function histogram(array $hits): array
|
||||
{
|
||||
$bounds = self::Buckets;
|
||||
$result = [];
|
||||
|
||||
foreach ($bounds as $i => $lower) {
|
||||
$upper = $bounds[$i + 1] ?? null;
|
||||
$label = $upper === null ? "{$lower}+" : "{$lower}–".($upper - 1);
|
||||
|
||||
$result[$label] = count(array_filter(
|
||||
$hits,
|
||||
static fn (int $h): bool => $h >= $lower && ($upper === null || $h < $upper),
|
||||
));
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue