conversion: Konversionsleiter mit Herkunft auf dem Magic-Link-Token (Block 0)
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>
This commit is contained in:
parent
748a0d4b7e
commit
45f2d90e4e
24 changed files with 1260 additions and 9 deletions
94
app/Services/Conversion/ConversionFunnelReport.php
Normal file
94
app/Services/Conversion/ConversionFunnelReport.php
Normal file
|
|
@ -0,0 +1,94 @@
|
|||
<?php
|
||||
|
||||
namespace App\Services\Conversion;
|
||||
|
||||
use App\Enums\ConversionEventType;
|
||||
use App\Enums\ConversionSource;
|
||||
use App\Models\ConversionEvent;
|
||||
use Illuminate\Support\Carbon;
|
||||
|
||||
/**
|
||||
* Der Trichter je Herkunft und Zeitraum (Roadmap 0.6).
|
||||
*
|
||||
* Gezählt wird je Stufe die Zahl der EINDEUTIGEN FIRMEN, nicht die Zahl der
|
||||
* Ereignisse. Zwei Gründe: Ein doppelter Klick ist kein doppelter Interessent,
|
||||
* und nur mit derselben Einheit auf allen Stufen ist der Übergang von einer
|
||||
* Stufe zur nächsten überhaupt eine Quote.
|
||||
*
|
||||
* Ereignisse ohne Firmenbezug werden gesondert ausgewiesen statt mitgezählt.
|
||||
* Sie sind nicht wertlos — „Konto angelegt" hat naturgemäß keine Firma —, aber
|
||||
* sie gehören nicht in eine Quote, deren Nenner Firmen sind.
|
||||
*/
|
||||
class ConversionFunnelReport
|
||||
{
|
||||
/**
|
||||
* @return array{
|
||||
* from: string,
|
||||
* to: string,
|
||||
* sources: list<array{
|
||||
* source: string,
|
||||
* label: string,
|
||||
* steps: list<array{step: int, type: string, label: string, diagnosis: string, firmen: int, uebergang: float|null, ohne_firma: int}>,
|
||||
* }>,
|
||||
* }
|
||||
*/
|
||||
public function build(Carbon $from, ?Carbon $to = null): array
|
||||
{
|
||||
$to ??= Carbon::now();
|
||||
|
||||
$rows = ConversionEvent::query()
|
||||
->whereBetween('created_at', [$from, $to])
|
||||
->get(['type', 'source', 'company_id']);
|
||||
|
||||
$sources = [];
|
||||
|
||||
foreach (ConversionSource::cases() as $source) {
|
||||
$forSource = $rows->where('source', $source);
|
||||
|
||||
if ($forSource->isEmpty()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$steps = [];
|
||||
$previous = null;
|
||||
|
||||
foreach (ConversionEventType::ladder() as $type) {
|
||||
$forType = $forSource->where('type', $type);
|
||||
|
||||
$companies = $forType
|
||||
->pluck('company_id')
|
||||
->filter(static fn ($id): bool => $id !== null)
|
||||
->unique()
|
||||
->count();
|
||||
|
||||
$steps[] = [
|
||||
'step' => $type->step(),
|
||||
'type' => $type->value,
|
||||
'label' => $type->label(),
|
||||
'diagnosis' => $type->diagnosis(),
|
||||
'firmen' => $companies,
|
||||
// Übergang von der VORIGEN Stufe. Die erste Stufe hat
|
||||
// keinen Vorgänger und damit keine Quote.
|
||||
'uebergang' => $previous === null || $previous === 0
|
||||
? null
|
||||
: round($companies / $previous * 100, 1),
|
||||
'ohne_firma' => $forType->whereNull('company_id')->count(),
|
||||
];
|
||||
|
||||
$previous = $companies;
|
||||
}
|
||||
|
||||
$sources[] = [
|
||||
'source' => $source->value,
|
||||
'label' => $source->label(),
|
||||
'steps' => $steps,
|
||||
];
|
||||
}
|
||||
|
||||
return [
|
||||
'from' => $from->toDateString(),
|
||||
'to' => $to->toDateString(),
|
||||
'sources' => $sources,
|
||||
];
|
||||
}
|
||||
}
|
||||
138
app/Services/Conversion/ConversionRecorder.php
Normal file
138
app/Services/Conversion/ConversionRecorder.php
Normal file
|
|
@ -0,0 +1,138 @@
|
|||
<?php
|
||||
|
||||
namespace App\Services\Conversion;
|
||||
|
||||
use App\Enums\ConversionEventType;
|
||||
use App\Enums\ConversionSource;
|
||||
use App\Models\Company;
|
||||
use App\Models\ConversionEvent;
|
||||
use App\Models\MagicLink;
|
||||
use App\Models\PressRelease;
|
||||
use App\Models\User;
|
||||
use App\Scopes\PortalScope;
|
||||
|
||||
/**
|
||||
* Schreibt die Ereignisse der Konversionsleiter (Roadmap 0.5).
|
||||
*
|
||||
* Zwei Regeln, die für alle Schreibstellen gelten:
|
||||
*
|
||||
* 1. **Fehler werden geschluckt.** Die Messung begleitet einen Vorgang, sie ist
|
||||
* nicht der Vorgang. Eine kaputte Statistik darf keine Anmeldung, keinen
|
||||
* Magic Link und erst recht keine Buchung scheitern lassen.
|
||||
* 2. **Kein Personenbezug.** Festgehalten werden Firma und Meldung, nie ein
|
||||
* Mensch. Der rote Faden durch den Trichter ist die Firma; für die Frage
|
||||
* „an welcher Stufe bricht es ab" reicht das vollständig.
|
||||
*/
|
||||
class ConversionRecorder
|
||||
{
|
||||
public function record(
|
||||
ConversionEventType $type,
|
||||
ConversionSource $source,
|
||||
?Company $company = null,
|
||||
?PressRelease $pressRelease = null,
|
||||
): void {
|
||||
try {
|
||||
ConversionEvent::query()->create([
|
||||
'type' => $type,
|
||||
'source' => $source,
|
||||
'company_id' => $company?->getKey(),
|
||||
'press_release_id' => $pressRelease?->getKey(),
|
||||
]);
|
||||
} catch (\Throwable $e) {
|
||||
report($e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Wie record(), aber höchstens einmal je Firma und Stufe.
|
||||
*
|
||||
* Für Stufen, deren Name eine Einmaligkeit behauptet — „Konto angelegt",
|
||||
* „Erste Buchung". Eine zweite Buchung ist keine erste, und ein Ereignis,
|
||||
* das bei jeder Zahlung mitschreibt, würde die Stufe unbrauchbar machen.
|
||||
*
|
||||
* Ohne Firmenbezug greift die Sperre nicht: Dann fehlt der Schlüssel, gegen
|
||||
* den geprüft würde. Solche Ereignisse landen ohne Prüfung im Log und
|
||||
* werden im Trichter ohnehin nur als Randnotiz geführt.
|
||||
*/
|
||||
public function recordOnce(
|
||||
ConversionEventType $type,
|
||||
ConversionSource $source,
|
||||
?Company $company = null,
|
||||
?PressRelease $pressRelease = null,
|
||||
): void {
|
||||
try {
|
||||
if ($company !== null && $this->alreadyRecorded($type, $company)) {
|
||||
return;
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
report($e);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$this->record($type, $source, $company, $pressRelease);
|
||||
}
|
||||
|
||||
/**
|
||||
* Herkunft eines Magic-Link-Tokens.
|
||||
*
|
||||
* Genau hier zahlt sich die Entscheidung aus, den Wert auf dem Token statt
|
||||
* in der Session zu führen: Der Domainwechsel zwischen Mail, Spoke und Hub
|
||||
* hat die Sitzung längst zerrissen, das Token trägt die Herkunft trotzdem
|
||||
* noch.
|
||||
*/
|
||||
public function sourceOf(MagicLink $magicLink): ConversionSource
|
||||
{
|
||||
return ConversionSource::parse($magicLink->source);
|
||||
}
|
||||
|
||||
/**
|
||||
* Firma zu einer Meldung — scope-frei, weil die Schreibstellen auch aus
|
||||
* Jobs und Webhooks ohne passenden Portal-Host laufen.
|
||||
*/
|
||||
public function companyOf(?PressRelease $pressRelease): ?Company
|
||||
{
|
||||
if ($pressRelease?->company_id === null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return Company::query()
|
||||
->withoutGlobalScope(PortalScope::class)
|
||||
->find($pressRelease->company_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Stufe 5 der Konversionsleiter.
|
||||
*
|
||||
* Der Trichter läuft über die FIRMA, gezahlt wird aber vom Konto. Die
|
||||
* Brücke ist die Firma des Kontos — bevorzugt die eigene, sonst die erste
|
||||
* zugeordnete. Ohne Firma bleibt der Bezug leer; das Ereignis ist dann
|
||||
* für die Trichter-Auswertung wertlos, aber immer noch eine ehrliche Zeile
|
||||
* im Log.
|
||||
*/
|
||||
public function recordFirstBooking(?User $user): void
|
||||
{
|
||||
if ($user === null) {
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
$company = $user->ownedCompanies()->withoutGlobalScope(PortalScope::class)->first()
|
||||
?? $user->companies()->withoutGlobalScope(PortalScope::class)->first();
|
||||
} catch (\Throwable $e) {
|
||||
report($e);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$this->recordOnce(ConversionEventType::FirstBooking, ConversionSource::Organic, $company);
|
||||
}
|
||||
|
||||
private function alreadyRecorded(ConversionEventType $type, Company $company): bool
|
||||
{
|
||||
return ConversionEvent::query()
|
||||
->where('type', $type->value)
|
||||
->where('company_id', $company->getKey())
|
||||
->exists();
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue