Project mode – leads, shop or both
Every project has a mode (Einstellungen › Projekt, or the preset wizard: „Was passiert auf Deiner Website?“). Changing it never changes data – only views, columns and the reporting rule follow it.
| Mode | Goal | Columns |
|---|---|---|
leads (default) | inquiries and appointments; revenue later through the status „Kunde“ | with qualification: Ausgaben · Leads · Qualifizierte Leads · Kosten pro qualifiziertem Lead (· Kunden · Umsatz once revenue was entered); without: Ausgaben · Leads · Kosten pro Lead |
shop | purchases with revenue at checkout | Ausgaben · Käufe · Umsatz · ROAS · Kosten pro Kauf · Ø Bestellwert · Conversion-Rate |
mixed | both, always shown in two groups (never one sum) | both groups |
Lead qualification (leadQualification, leads only) enables the status „Disqualifiziert“ and the
qualified-lead metrics (Lead qualification). Templates set
sensible defaults: e-commerce → shop without qualification; clinic, real estate, B2B and coaching →
leads with qualification. The former „A/B“ column is gone – the quiz grade is a hint, not a metric.
Reporting rule per mode
- Leads: one person = one lead conversion, for good (repeat inquiries do not count again). A closing
(„Angebot angenommen“, status „Kunde“) is reported to ad platforms at most once per lead – the
first trigger wins, further ones are skipped as
closing_already_reported(„übersprungen: Abschluss für diesen Lead bereits gemeldet“). - Shop: every purchase is its own conversion and is reported every time, repeat purchases of the same
person included. Deduplication only by order id (
duplicate_order).
Send purchases with the SDK event purchase (value, currency, order_id, optional items) or
server-side with POST /v1/projects/{project}/purchases (secret key, conversions:write, idempotent per
order id); refunds with POST /v1/projects/{project}/purchases/refunds – revenue is reported net of
refunds, the conversion stays.
Counting rule
attributionModel (default last_click) is the project's counting rule for leads per source. Every
insights, ads and MCP endpoint that takes model uses it when the parameter is absent; an explicit
model stays a temporary override (for comparing rules in place).
Changing the mode
GET /v1/projects/{project}/mode-preview?mode=shop&lead_qualification=false shows what changes: the
current and the new columns, added and removed metrics, the reporting rule and the last 30 days' numbers
under both. Save with PATCH /v1/projects/{project} (settings.mode, settings.leadQualification,
settings.attributionModel); every change is audited and annotated in the time series.
In the dashboard
- Einstellungen › Projekt („Was passiert auf Deiner Website?“,
project:admin) changes mode, lead qualification and counting rule in small steps. Every step shows the preview „So ändern sich Deine Spalten und Zahlen“ for the last 30 days and the reporting rule in words; the counting-rule step shows leads per source under the current and the new rule. Saving is conflict-safe: if someone saved in between, the page says „Inzwischen geändert – neu laden“. Lead qualification is disabled in shop mode (purchases have nothing to disqualify). - The header has no counting-rule switch any more. Pulse and the other views say „Gezählt nach
„Letzter Klick“ (Einstellung ändern)“ – the link only for roles that may change the setting. An old or
shared link with
?model=still works as a temporary override and shows as the chip „Zählweise: Erster Kontakt (vorübergehend) ד; × goes back to the project's rule. - Pulse, cockpit, recommendations, weekly and client reports follow the mode: „Woher Deine Leads kommen“ becomes „Woher Dein Umsatz kommt“ in a shop, mixed projects show both groups apart, and the cockpit never adds leads and purchases into one number. A shop without purchases yet shows how to send them; without ad costs there is no ROAS („Ohne Kosten kein ROAS“) and a link to connect the ad account.
- Budget recommendations judge cost per qualified lead (leads with qualification) or ROAS and cost per purchase (shop). Paused, rejected or deleted campaigns and ads never get „Leg nach“. With lead qualification, a campaign with at least 5 leads of which 30 % or more are disqualified gets „32 % der Leads aus Kampagne X passen nicht – häufigster Grund: …“, marked as a small sample below 15 leads.
- Templates set the defaults: E-Commerce → shop; B2B, clinic, real estate and coaching → leads with qualification. The project wizard and the preset wizard (step „Conversions/Qualifizierung“) ask the mode question; the reasons themselves live under Einstellungen › Qualifizierung.