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
|
|
@ -423,3 +423,127 @@ Zusammen mit Schritt 6 erledigt, siehe dort.
|
|||
| Aufbewahrung des Ereignis-Logs: 395 Tage | **Meine Festlegung, deine Entscheidung.** Bestimmt die Tiefe von Roadmap 1c.1 und ist nur *vor* dem ersten Lauf frei wählbar. |
|
||||
| Die 166 Baseline-Einträge | Kein Fehler, aber auch keine Sichtprüfung wert — Zusammensetzung und Begründung siehe Schritt 5. Wer sie weiter senken will, fängt bei den Closure-Generics in `app/Services/Web/` an. |
|
||||
| Roadmap-Entscheidungen E1–E6 | Unberührt — das sind fachliche Fragen, keine Code-Befunde. |
|
||||
|
||||
---
|
||||
|
||||
# Teil 2 — Roadmap Block 0 (Messbarkeit)
|
||||
|
||||
## 0.1 und 0.2 — Basiswerte
|
||||
|
||||
Zwei Auswertungen als Artisan-Befehle, Ergebnisse und Ableitungen in
|
||||
**[`basiswerte-block0.md`](basiswerte-block0.md)**.
|
||||
|
||||
```
|
||||
php artisan press-releases:view-distribution [--months=3] [--from=] [--to=] [--json]
|
||||
php artisan press-releases:rejection-rate [--months=3] [--from=] [--to=] [--json]
|
||||
```
|
||||
|
||||
**Zwei Befunde, die den Plan verändert haben:**
|
||||
|
||||
1. **Der Gesamtmedian taugt nicht als Basiswert.** `hits` ist ein mitlaufender
|
||||
Zähler, und die Aufrufe wachsen nach der Veröffentlichung wochenlang weiter
|
||||
(⌀ 75 → 128 → 179 → 231 in den ersten vier Wochen, ohne Plateau). Über ein
|
||||
Drei-Monats-Fenster misst man damit die Altersmischung, nicht die Reichweite.
|
||||
Der Report weist deshalb zusätzlich **Alterskohorten** aus; der Basiswert ist
|
||||
die Kohorte „28–55 Tage", nicht die Gesamtzahl.
|
||||
2. **openPR ist keine zweite Quelle.** Es ist der Presse-API-Verteiler von
|
||||
connektar, also derselbe Zulauf. In den Daten hat genau ein API-Token je
|
||||
einen Zugriff gemacht. Roadmap-Text korrigiert.
|
||||
|
||||
**E2 ist damit entschieden: Rohzahlen.** Begründung in `basiswerte-block0.md`.
|
||||
Kurzfassung: kein Bodensatz (unter 25 Aufrufen liegen 2 % bzw. 0 %),
|
||||
Verteilungen nahezu symmetrisch, und eine Einordnung gegen den
|
||||
Portaldurchschnitt wäre wegen der Wachstumskurve sogar falsch.
|
||||
|
||||
---
|
||||
|
||||
## 0.3 bis 0.7 — Konversionsleiter
|
||||
|
||||
### Warum eine eigene Tabelle statt Umami
|
||||
|
||||
Die zu messende Strecke führt über zwei Domains und einen Magic Link. 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 der Datenbank, bei denen die
|
||||
Identität ohnehin bekannt ist.
|
||||
|
||||
**Rollenteilung bleibt:** Ereignistabelle für den Trichter (Block 1), Umami für
|
||||
Seitenaufrufe und Suchbegriffe (Block 2). Keine Vermischung.
|
||||
|
||||
### 0.3 — `conversion_events`
|
||||
|
||||
Spalten: `type`, `source`, `company_id`, `press_release_id`, `created_at`.
|
||||
Keine Personen, keine Klartextadressen, keine IP, kein User-Agent. Der rote
|
||||
Faden durch den Trichter ist die **Firma**, nicht der Mensch — für „an welcher
|
||||
Stufe bricht es ab" reicht das vollständig.
|
||||
|
||||
Die Leiter als Enum `ConversionEventType`, mit Stufe **und** Diagnose am Fall:
|
||||
|
||||
| # | Stufe | Ein Abbruch hier bedeutet |
|
||||
|---|---|---|
|
||||
| 1 | Mail-Link geklickt | Betreff oder Anlass trägt nicht |
|
||||
| 2 | Magic Link eingelöst | Der Verwaltungszugang wird nicht verstanden |
|
||||
| 3 | Newsroom bearbeitet | Kein Anreiz, das Profil zu pflegen |
|
||||
| 4 | Konto angelegt | Der Nutzen des Kontos ist nicht erkennbar |
|
||||
| 5 | Erste Buchung | Preis oder Angebot passt nicht |
|
||||
|
||||
### 0.4 — Herkunft auf dem Token
|
||||
|
||||
Neue Spalte `magic_links.source` (bewusst eine Spalte statt eines Eintrags in
|
||||
`payload`: Die Herkunft wird gruppiert und gefiltert, nicht nur gelesen).
|
||||
`MagicLinkGenerator::createLoginLink()` nimmt sie entgegen.
|
||||
|
||||
Die Mail-Links tragen `?src=<Herkunft>&pr=<Meldung>`. `ConversionSource::parse()`
|
||||
fällt bei unbekannten Werten auf `organic` zurück statt zu scheitern — der
|
||||
Parameter steht in fremder Hand.
|
||||
|
||||
**Zur Meldungs-ID im Klartext:** Sie ist fälschbar. Vertretbar, weil sie nichts
|
||||
freischaltet, sondern ein Ereignis in der internen Statistik einer Firma
|
||||
zuordnet; wer sie fälscht, verfälscht nur die eigene Auswertung. Sobald der
|
||||
Verwaltungszugang über Magic Link steht (1b.2), tragen die Mail-Links ein
|
||||
Token, das Herkunft und Meldung fälschungssicher mitführt — der `pr`-Parameter
|
||||
entfällt dann.
|
||||
|
||||
### 0.5 — Schreibstellen
|
||||
|
||||
| Stufe | Wo |
|
||||
|---|---|
|
||||
| 1 | `RecordMailLinkClick` — globale Middleware. Bewusst global statt je Route: Die Mail-Links zeigen auf Hub, Spokes und öffentliche Detailseiten, eine vergessene Route wäre eine unsichtbare Lücke. Nur `mail_*`-Herkünfte lösen aus, nur GET. |
|
||||
| 2 | `MagicLinkConsumeController`, Herkunft vom Token |
|
||||
| 3 | **Enum und Auswertung stehen, Schreibstelle folgt mit 1b.3** (abgesprochen) |
|
||||
| 4 | `RecordAuthActivity::recordRegistered()` |
|
||||
| 5 | `ProcessStripeWebhook` an beiden Zahlungspfaden (`mirrorPaidInvoice`, `fulfillSinglePurchase`), dedupliziert über `recordOnce()` je Firma |
|
||||
|
||||
Zwei Regeln für alle Schreibstellen: **Fehler werden geschluckt** (die Messung
|
||||
begleitet einen Vorgang, sie ist nicht der Vorgang) und **kein Personenbezug**.
|
||||
|
||||
### 0.6 — Auswertung
|
||||
|
||||
```
|
||||
php artisan conversion:funnel [--months=3] [--from=] [--to=] [--json]
|
||||
```
|
||||
|
||||
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 in einer eigenen Spalte daneben statt im Nenner.
|
||||
|
||||
### 0.7 — Aufbewahrung
|
||||
|
||||
**395 Tage**, derselbe Horizont wie beim Aufruf-Ereignis-Log (Entscheidung
|
||||
01.09.2026). `config/conversion.php`, Befehl `conversion:purge-events`, täglich
|
||||
03:25 im Scheduler.
|
||||
|
||||
> **Offen und bewusst nicht von mir geschrieben:** Der Absatz in der
|
||||
> Datenschutzerklärung. Rechtstext gehört nicht aus einer Codeänderung heraus
|
||||
> formuliert. Inhaltlich zu führen ist: Zweck (interne Reichweiten- und
|
||||
> Konversionsstatistik), Umfang (Ereignistyp, Herkunft, Firmen- und
|
||||
> Meldungsbezug — kein Personenbezug, keine IP), Aufbewahrung (395 Tage),
|
||||
> Rechtsgrundlage.
|
||||
|
||||
### Angepasster Bestandstest
|
||||
|
||||
`EmailBrandingTest` verglich die Mail-URL roh gegen das gerenderte HTML. Die
|
||||
Links tragen jetzt zwei Parameter, Blade escapt das trennende `&` korrekt zu
|
||||
`&` — der Vergleich läuft nun über `e()`. Verhalten unverändert richtig,
|
||||
nur die Erwartung war zu eng.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue