Kevin Adametz
45f2d90e4e
Die zu messende Strecke führt von einer Mail über presseecho.de per Magic Link auf pressekonto.com und endet in einer Buchung — drei Wechsel, zwei Domains. Ein cookiefreies Analytics-Tool verliert die Sitzung genau dort, wo die interessante Konversion passiert. Claim, Registrierung und Buchung sind außerdem keine Seitenaufrufe, sondern Zustandsänderungen in dieser Datenbank, bei denen die Identität ohnehin bekannt ist. Deshalb eigene Ereignisdaten statt Umami; Umami behält Seitenaufrufe und Suchbegriffe. `conversion_events` hält Ereignistyp, Herkunft sowie Firmen- und Meldungsbezug — keine Personen, keine Klartextadressen, keine IP. Der rote Faden durch den Trichter ist die Firma; für die Frage "an welcher Stufe bricht es ab" reicht das vollständig. Der Kern ist die Herkunft auf dem Token (neue Spalte magic_links.source). Ohne sie weiß die Auswertung am Ende, dass jemand gebucht hat, aber nicht, ob er aus einer Ablehnungsmail kam. Eine Session überlebt den Domainwechsel nicht, das Token schon. Die Mail-Links tragen zusätzlich `?src=` und `&pr=`; die Meldungs-ID ist fälschbar, schaltet aber nichts frei und verfälscht im schlimmsten Fall nur unsere eigene Statistik. Mit dem Magic-Link-Zugang aus 1b.2 entfällt sie. Fünf Stufen statt gleichrangiger Punkte, jede mit ihrer Diagnose am Enum: Vier beliebige Konversionspunkte sagen nicht, WO es hakt. Geschrieben wird an Stufe 1 (globale Middleware — die Mail-Links zeigen auf Hub, Spokes und öffentliche Seiten, eine vergessene Route wäre eine unsichtbare Lücke), Stufe 2 (Magic-Link-Einlösung), Stufe 4 (Registrierung) und Stufe 5 (beide Zahlungspfade, je Firma dedupliziert — eine zweite Buchung ist keine erste). Stufe 3 ist definiert und wird ausgewertet; ihre Schreibstelle kommt mit der Profilpflege aus 1b.3. Für alle Schreibstellen gilt: Fehler werden geschluckt. Die Messung begleitet einen Vorgang, sie ist nicht der Vorgang — eine kaputte Statistik darf keine Anmeldung und erst recht keine Buchung scheitern lassen. `conversion:funnel` zählt je Stufe die eindeutigen Firmen, nicht die Ereignisse: Ein doppelter Klick ist kein doppelter Interessent, und nur mit derselben Einheit auf allen Stufen ist ein Übergang überhaupt eine Quote. Ereignisse ohne Firmenbezug stehen daneben statt im Nenner. Aufbewahrung 395 Tage, zusammen mit der Tabelle festgelegt statt nachgetragen, täglich im Scheduler bereinigt. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
80 lines
2.9 KiB
PHP
80 lines
2.9 KiB
PHP
<?php
|
||
|
||
namespace App\Console\Commands;
|
||
|
||
use App\Services\Conversion\ConversionFunnelReport;
|
||
use Illuminate\Console\Command;
|
||
use Illuminate\Support\Carbon;
|
||
|
||
/**
|
||
* Trichter je Herkunft und Zeitraum (Roadmap 0.6).
|
||
*
|
||
* Die Leiter beantwortet nicht „wie viele konvertieren", sondern „an welcher
|
||
* Stufe bricht es ab" — deshalb steht neben jeder Stufe, was ein Abbruch dort
|
||
* bedeutet.
|
||
*/
|
||
class ReportConversionFunnel extends Command
|
||
{
|
||
protected $signature = 'conversion:funnel
|
||
{--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 = 'Konversionstrichter je Herkunft: Firmen je Stufe und Übergangsquoten.';
|
||
|
||
public function handle(ConversionFunnelReport $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("Konversionstrichter — {$data['from']} bis {$data['to']}");
|
||
|
||
if ($data['sources'] === []) {
|
||
$this->newLine();
|
||
$this->warn('Keine Ereignisse im Zeitraum. Herkunftsdaten lassen sich nicht rückwirkend erzeugen — '
|
||
.'wenn hier dauerhaft nichts steht, greift eine Schreibstelle nicht.');
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
|
||
foreach ($data['sources'] as $source) {
|
||
$this->newLine();
|
||
$this->line("<comment>{$source['label']}</comment>");
|
||
|
||
$rows = [];
|
||
|
||
foreach ($source['steps'] as $step) {
|
||
$rows[] = [
|
||
$step['step'],
|
||
$step['label'],
|
||
$step['firmen'],
|
||
$step['uebergang'] === null ? '–' : $step['uebergang'].' %',
|
||
$step['ohne_firma'] > 0 ? $step['ohne_firma'] : '',
|
||
$step['diagnosis'],
|
||
];
|
||
}
|
||
|
||
$this->table(
|
||
['#', 'Stufe', 'Firmen', 'Übergang', 'ohne Firma', 'Ein Abbruch hier bedeutet'],
|
||
$rows,
|
||
);
|
||
}
|
||
|
||
$this->newLine();
|
||
$this->line(' Gezählt werden eindeutige Firmen je Stufe — ein doppelter Klick ist kein doppelter Interessent.');
|
||
$this->line(' „ohne Firma" steht daneben statt darin: Diese Ereignisse gehören nicht in eine Quote, deren Nenner Firmen sind.');
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
}
|