MSPercury docs
EN ES Back to app →

Public-CheckUp & Widget einrichten

Schritt-für-Schritt: vom leeren Workspace zur eigenen /check/dein-shop-Landingpage und einem auf der Marketing-Site eingebetteten Lead-Magnet-Widget. Insgesamt 5–10 Minuten.

1. Slug setzen

Geh auf /settings#publiccheckup. Das ist der einzige Pflicht-Konfigurationsschritt — danach ist der CheckUp live.

Trag einen Slug ein. Klein, mit Bindestrichen, 3–40 Zeichen. Beispiel: it-flores ergibt https://mspercury.com/check/it-flores. Slugs sind workspace-eindeutig — wenn ein anderer Tenant deinen Wunsch-Slug schon hat, lehnt das System ab.

Speichern. Der Link erscheint sofort im grünen Block oberhalb des Formulars und ist live.

2. Branding aufnehmen (optional, aber empfohlen)

Geh auf /settings#branding:

  • Logo hochladen (PNG / JPEG / WebP / SVG, max. 2 MB) — erscheint auf der CheckUp-Landingpage und im finalen PDF-Bericht
  • Markenfarbe setzen (Hex-Farbe wie #059669) — färbt CTA-Buttons, Score-Card und Akzent-Elemente

Ohne diese Schritte sieht der CheckUp aus „MSPercury-Standard” statt „dein Brand”.

3. Intro-Text anpassen (optional)

Im Settings-Block unter dem Slug findest du das Aufklapp-Element „Intro-Text (optional, pro Sprache)”. Drei Textareas — DE / EN / ES.

Wenn du sie leer lässt, rendert MSPercury einen sinnvollen Default-Text mit deinem Workspace-Namen. Wenn du eine spezifische Vertriebsformulierung hast (z. B. „Sichere dir in 3 Min. eine ehrliche Einschätzung von ACME IT — kostenfrei und unverbindlich”), trag sie hier ein.

Du kannst auch nur eine Sprache überschreiben und die anderen leer lassen — der Default greift dann nur für die nicht-überschriebenen Locales.

4. Fragen-Katalog anpassen (optional)

Geh auf /catalog/findings?tab=public-questions.

Standardmäßig ist der von MSPercury gepflegte Katalog (~26 Fragen über 5 Kategorien) eingespielt. Beim ersten Öffnen wird er in deine Workspace-Tabelle geclont — ab dann gehört er dir.

Per-Frage editierbar:

  • Stable Key (intern, nicht änderbar)
  • Frage + Hilfetext in DE / EN / ES
  • Kategorie-Dropdown
  • Gewichtungs-Slider (Sekundär / Standard / Kritisch)
  • ↺ Risikofrage-Toggle (für „Hattet ihr einen Vorfall?”-Fragen, wo „Ja” den Score senkt)
  • ↳ Folgefrage-Picker (Frage erscheint nur wenn die Eltern-Frage einen bestimmten Wert hat)
  • ↑↓ Reorder + Löschen + „+ Frage” pro Kategorie

Wenn du dich verfahren hast: oben rechts „Auf Standard zurücksetzen” mit RESET-Confirm-Wort macht den Original-Katalog frisch wieder rein.

Im grünen Block bei /settings#publiccheckup siehst du zwei Dinge:

A — Direkt-Link (z. B. https://mspercury.com/check/it-flores) Kopier-Button daneben. Verlink ihn aus E-Mail-Signatur, LinkedIn-Bio, Newsletter-Footer, Visitenkarten-QR-Code, etc.

B — Iframe-Embed-Snippet für die eigene Marketing-Site:

<iframe src="https://mspercury.com/check/it-flores/embed"
        style="width:100%;min-height:780px;border:0"
        title="IT CheckUp" loading="lazy"></iframe>

Kopier-Button rechts daneben. Pasten an die Stelle deiner Website, wo der CheckUp leben soll. Der Embed-Endpoint ist Iframe-optimiert (Content-Security-Policy: frame-ancestors *, X-Frame-Options: ALLOWALL) und trägt den Multi-Step-Flow inkl. PIN-Eingabe komplett INNERHALB des Iframes — der Besucher verlässt deine Site nie.

Höhen-Anpassung: 780px reicht für die meisten Schritte. Wenn du den Bericht oder die Antwort-Zusammenfassung zeigen willst, kann das auf manchen Locales 900–1100px brauchen.

6. UTM-Tracking einbauen

Hänge einfach ?utm_source=…&utm_medium=…&utm_campaign=… an die Iframe-URL oder den Direkt-Link.

Beispiele:

  • E-Mail-Newsletter: …/check/it-flores?utm_source=newsletter&utm_medium=email&utm_campaign=q3-launch
  • Google-Ad: …/check/it-flores?utm_source=google&utm_medium=cpc&utm_campaign=brand
  • LinkedIn-Bio: …/check/it-flores?utm_source=linkedin&utm_medium=bio

MSPercury speichert beim ersten Aufruf (Erst-Berührung) automatisch via signiertem Cookie:

  • utm_source, utm_medium, utm_campaign, utm_content, utm_term
  • referrerHost (Domain wo der Klick herkam, falls Browser den Header schickt)
  • sourceUrl (volle Landing-URL inkl. Query)

Erst-Berührung gewinnt: ein wiederkehrender Besucher mit anderer UTM überschreibt nicht den Original-Kanal. Du siehst die Werte später unter /leads/[id] in der „Quelle”-Karte und im Aggregat als „Top-Quellen”-Strip auf /leads.

7. Was ein Lead durchläuft

Aus Prospekt-Sicht:

  1. Landing → E-Mail eingeben → 6-stelliger Code per Mail
  2. Code eingeben → 23 Fragen mit Live-Score-Anzeige + Progress-Bar
  3. „Über euch” — 4 Pflicht-/Optionalfelder (Firma, Branche, Größe, Telefon)
  4. Datenschutz-Checkbox → Submit
  5. Score-Reveal mit Reifegrad-Badge (🥇 Gold / 🥈 Silber / 🥉 Bronze / 🚨 Akut), Position-Bar 0–100, Score-Erklärung, optional Cross-Tenant-Benchmark, Kategorie-Aufschlüsselung
  6. PDF-Bericht wird per E-Mail verschickt (Background)

Aus Operator-Sicht: der Lead landet in /leads als neuer Eintrag in der „Neu”-Spalte des Kanbans, mit allen Antworten, dem Score-Breakdown, der Branche/Größe und der UTM/Source-Attribution.

8. Lead-zu-Kunde-Flow

Auf /leads/[id]:

  • Pipeline-Status setzen: Neu → Kontaktiert → Angebot → Kunde / Abgelehnt
  • „✨ Outreach-E-Mail entwerfen” — KI baut dir eine personalisierte Erstkontakt-E-Mail (siehe Features → AI Outreach Drafter)
  • „→ Als Kunde übernehmen” — konvertiert den Lead in einen customers-Datensatz, behält den Link via convertedCustomerId

Drag-and-Drop: Lead-Karten lassen sich auf /leads zwischen den Kanban-Spalten ziehen. Status updated automatisch.

DSGVO / Datenschutz-Hinweise

  • Beim Submit erfasst MSPercury die Datenschutz-Einwilligung mit Zeitstempel + IP + User-Agent (Art. 7 DSGVO Beweispflicht)
  • Lead-Daten landen ausschließlich in deiner Workspace-DB (strikte Tenant-Isolation)
  • Cross-Tenant-Benchmark auf der Score-Seite ist die EINE dokumentierte Ausnahme — aggregiert, anonym, mit harter Mindeststichprobe bevor irgendeine Zahl gezeigt wird
  • DSGVO-Pflicht-Information für deine Website: erwähn die MSPercury-Verarbeitung in deiner Datenschutzerklärung als Auftragsverarbeiter (AVV-Vorlage unter /legal/dpa)

Häufige Stolpersteine

„iframe lädt nicht / zeigt sich leer”: prüf die Content-Security-Policy-Header deiner Marketing-Site. Wenn sie frame-src 'self' enthält, musst du https://mspercury.com whitelisten.

„Code-E-Mail kommt nicht an”: Spam-Ordner. MSPercury sendet von noreply@mspercury.com mit deinem Operator-Namen als Display-Name — manche Filter werten das als „phishing-ähnlich”.

„Lead-Score schwankt zwischen Tests”: Erinnerung — Folgefragen können den Score deutlich nach oben/unten verschieben. Wenn ein Test-Lead bei „MFA = nein” antwortet, erscheint die Phishing-Folgefrage; deren Antwort fließt zusätzlich in den Score.

„Mein Lead ist nicht in der Liste”: prüf den pipelineStatus-Filter oder ?source=…-Filter auf /leads. Beide können zusammen filtern — versehentlich aktive Filter sind die häufigste Ursache.