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>

database/migrations/2026_09_01_100000_create_conversion_events_table.php

@@ -0,0 +1,52 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Ereignisse der Konversionsleiter (Roadmap 0.3).
+ *
+ * Warum eine eigene Tabelle und nicht Umami: Die zu messende Strecke führt über
+ * zwei Domains und einen Magic Link, und ein cookiefreies Analytics-Tool
+ * verliert die Sitzung genau an der Stelle, an der die 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.
+ *
+ * DATENSPARSAMKEIT: Die Tabelle referenziert ausschließlich Firmen- und
+ * Meldungs-IDs. Keine Personen, keine Klartextadressen, keine IP, kein
+ * User-Agent. Damit bleibt sie interne Statistik. Der rote Faden durch den
+ * Trichter ist die FIRMA, nicht der Mensch — das reicht für die Frage „an
+ * welcher Stufe bricht es ab" vollständig aus.
+ *
+ * Aufbewahrung: 395 Tage, gleicher Horizont wie das Aufruf-Ereignis-Log
+ * (siehe config/conversion.php und `conversion:purge-events`).
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('conversion_events', function (Blueprint $table) {
+            $table->id();
+            $table->string('type', 32);
+            $table->string('source', 32);
+            $table->foreignId('company_id')->nullable()->constrained()->nullOnDelete();
+            $table->foreignId('press_release_id')->nullable()->constrained()->nullOnDelete();
+            $table->timestamp('created_at')->useCurrent();
+
+            // Der Trichter zählt je Stufe die eindeutigen Firmen im Zeitraum,
+            // aufgeschlüsselt nach Herkunft — genau diese drei Spalten.
+            $table->index(['type', 'source', 'created_at'], 'conversion_events_type_source_created_idx');
+            // Der Weg einer einzelnen Firma durch die Leiter.
+            $table->index(['company_id', 'type'], 'conversion_events_company_type_idx');
+            // Aufräumen läuft über das Alter.
+            $table->index('created_at', 'conversion_events_created_idx');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('conversion_events');
+    }
+};

database/migrations/2026_09_01_100100_add_source_to_magic_links_table.php

@@ -0,0 +1,42 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Herkunft auf dem Magic-Link-Token (Roadmap 0.4).
+ *
+ * Der Kern der ganzen Messung. Die Strecke führt von einer Mail über
+ * presseecho.de per Magic Link auf pressekonto.com und endet in einer Buchung —
+ * drei Wechsel, zwei Domains. Eine Session überlebt das nicht: Sie reißt genau
+ * an der Stelle, an der die interessante Konversion passiert. Das Token schon,
+ * denn es wird ohnehin über die ganze Strecke mitgeführt.
+ *
+ * Bewusst eine eigene Spalte statt eines Eintrags in `payload`: Die Herkunft
+ * wird gruppiert und gefiltert, nicht nur gelesen. In einer JSON-Spalte wäre
+ * das jedes Mal ein Ausdruck statt eines Index.
+ *
+ * `null` heißt: vor dieser Migration erzeugt oder ohne zugeordnete Herkunft.
+ * Der Report liest das als `organic`.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        if (! Schema::hasColumn('magic_links', 'source')) {
+            Schema::table('magic_links', function (Blueprint $table) {
+                $table->string('source', 32)->nullable()->after('purpose');
+            });
+        }
+    }
+
+    public function down(): void
+    {
+        if (Schema::hasColumn('magic_links', 'source')) {
+            Schema::table('magic_links', function (Blueprint $table) {
+                $table->dropColumn('source');
+            });
+        }
+    }
+};