QR-Link erstellen und auswerten

QR-Codes sind in SpeamCore mehr als nur „URL als Bild": Jeder QR-Link bekommt einen eigenen Slug (/q/sommer-2026), ist branding-fähig (Farben, Punkt-Stil, Logo), und jeder Scan wird anonym getrackt. So sehen Sie hinterher, wie oft der Aufkleber am Messestand gescannt wurde, wie oft Empfänger tatsächlich auf das Ziel geklickt haben und aus welchem Land sie kamen — alles ohne dass jemand bei SpeamCore einen Account braucht.

Diese Anleitung zeigt Ihnen den ganzen Weg: anlegen, gestalten, drucken, auswerten.

Wann mache ich das?

• Marketing-Kampagne — Sommer-Aktion, Messe-Stand, Aufkleber an Servicewagen.
• Druck auf Briefkopf / Rechnung — schneller Sprung des Kunden auf eine Selbstbedienungs-Seite.
• Standort- oder Anlagen-Aufkleber — QR-Code mit Link zur Wartungs-Dokumentation oder zum Mängelmelde-Formular.
• Event-Codes — Anmelde-Link auf der Konferenzen-Roadmap, Lead-Capture mit messbarer Conversion.

i

Voraussetzung

• Sie sind mit Innendienst-Account in SpeamCore eingeloggt.
• Berechtigung view:QrLink und create:QrLink.
• Für die Stats-Auswertung: view:QrLinkScan.
• Wenn Sie ein Custom-Logo einbetten möchten: ein vorhandenes Dokument mit dem Logo-Bild.
• Wenn Sie einen Style aus einem Template übernehmen möchten: vorhandenes QR-Link-Template (vom Admin oder mit view:QrLinkTemplate-Recht selbst angelegt).

So legen Sie einen QR-Link an

1

QR-Link-Modul öffnen

In der Sidebar auf QR-Links (oder direkt /qr-links). Sie sehen die Liste aller QR-Codes Ihres Mandanten — typischerweise mit Slug, Name, Ziel-URL, Aktiv-Status und Erstell-Datum.

Klick auf + Hinzufügen öffnet sofort eine Detail-Seite mit auto-generiertem Slug (z. B. kvj8m21h). Der Slug ist die spätere URL hinter https://app.speamcore.com/q/... — Sie können ihn überschreiben, bevor Sie speichern, danach ist er fix.

2

Slug und Name pflegen

Feld	Was reinkommt
Slug	URL-Teil — kleine Buchstaben, Zahlen, Bindestriche. 3 bis 64 Zeichen. Beispiele: sommer-2026, wartung-anlage-42, messe-firechecker.
Name	Interner Label für die Liste — z. B. „Sommer-Kampagne Brandschutz 2026". Wird im öffentlichen QR-Code nicht angezeigt.
Weiterleitung	Die Ziel-URL, auf die nach Klick auf „Fortfahren" weitergeleitet wird. Komplett mit https://.
Aktiv	Erst auf Ja setzen, wenn der Link bereit ist — Nein bedeutet 404 für jeden Scanner.

KI

Slug ist nach Anlage unveränderbar

Der Slug landet auf gedruckten Aufklebern, Visitenkarten, Plakaten — er muss stabil sein. Daher lehnt SpeamCore jede Änderung des Slugs nach dem ersten Speichern ab. Falls Sie sich vertippt haben oder einen besseren Namen wollen: neuen QR-Link mit dem gewünschten Slug anlegen und den alten deaktivieren.

3

Style wählen — Mandanten-Standard oder Custom

Zwei Wege zum Design:

Variante A — Mandanten-Standard verwenden (Default-Toggle aktiv):

Der QR-Code übernimmt automatisch Farben, Punkt-/Eck-Stil und Logo aus der zentralen Customization-Konfiguration Ihres Mandanten. Praktisch, wenn alle Codes einheitlich aussehen sollen. Die Style-Felder bleiben dabei ausgeblendet.

Variante B — Custom-Style:

Toggle Mandanten-Standard verwenden auf Aus. Es erscheinen die Style-Felder:

Feld	Wahl
Punkt-Stil	Quadratisch, abgerundet, klassisch, extra-rounded, dots — entscheidet die Optik der QR-Module
Punkt-Farbe	Hex-Wert (z. B. #1a202c)
Eck-Quadrat-Stil und -Farbe	Die drei großen Ecken — square, dot, extra-rounded
Hintergrundfarbe	Hex-Wert, plus Toggle Transparent für PNG/SVG-Export
Textfarbe + Textgröße	Für den optionalen Fußtext

Sobald Sie einen Wert ändern, aktualisiert sich die Live-Vorschau rechts neben dem Formular sofort — kein Speichern nötig zum Testen.

Variante C — Template anwenden:

Wenn der Admin schon Corporate-Templates angelegt hat (siehe QR-Link-Templates), wählen Sie eines im Dropdown Template und klicken Anwenden. Alle Style-Felder werden aus dem Template gefüllt. Sie können danach noch einzelne Werte überschreiben — das ändert das Template nicht, nur diesen einen QR-Link.

4

Logo einbetten (optional)

Den Logo-Toggle aktivieren, wenn ein Logo in der Mitte des QR-Codes sichtbar sein soll:

1. Mandanten-Logo: Wenn Sie kein Custom-Logo wählen, nutzt SpeamCore das in Customization hinterlegte Standard-Logo Ihres Mandanten.
2. Custom-Logo: Beim Klick auf den Logo-Selector wählen Sie ein vorhandenes Dokument aus oder laden ein neues Bild hoch (PNG oder SVG, am besten quadratisch, transparenter Hintergrund).
3. Logo-Anteil (über logoSize in der Style-Config — kommt aus dem Template oder Default 0.3): wie groß das Logo im Verhältnis zum QR-Code wird. 30 % ist ein guter Mittelweg zwischen Sichtbarkeit und Scannbarkeit.

KI

Scannbarkeit prüfen

QR-Codes haben eine Fehler-Toleranz, aber wenn Sie ein zu großes Logo einbetten oder zu helle Farben wählen, scheitert das Scannen. Immer vor Druck mit dem eigenen Handy testen — Vorschau anschauen, dann Live-Vorschau mit einem zweiten Gerät scannen.

5

Fußtext für den Druck (optional)

Wenn der QR-Code auf einem Aufkleber oder Plakat gedruckt wird, hilft ein Fußtext unter dem Code. Beispiele:

• Bei einem Anlagen-Aufkleber: © KFT Brandschutz GmbH · Anlage 42 · Wartung
• Bei einer Marketing-Kampagne: Sommer-Aktion bis 31.08.2026
• Bei einer Visitenkarte: firechecker.de/sommer-2026

Feld	Bedeutung
Fußtext	Text unter dem QR-Code, maximal 255 Zeichen
QR-Code Textgröße (pt)	Schriftgröße im Export — Standard 12 pt, erlaubt 6–72 pt

Der Fußtext wird beim Export in allen drei Formaten (PNG/JPEG/SVG) mit eingefügt.

6

Exportieren — PNG, JPEG oder SVG

Unter der Live-Vorschau stehen drei Export-Buttons:

Format	Wann?
PNG	Web-Use, Mail-Anhang. Optional transparenter Hintergrund (Toggle Transparent in den Style-Feldern).
JPEG	Druck, vor allem wenn die Druckerei kein PNG akzeptiert. Immer weißer Hintergrund (kein Alpha-Channel im JPEG-Format).
SVG	Druck (Plakate, Großformat) — beliebig skalierbar ohne Pixel-Verlust. Fußtext ist im SVG eingebettet.

Klick auf den gewünschten Button lädt die Datei sofort herunter — vor dem Druck nochmal mit dem eigenen Handy abscannen.

7

Statistiken auswerten (Stats-Tab)

Sobald der QR-Code im Umlauf ist, wechseln Sie auf den Tab Statistiken (/qr-links/<id>/stats).

Der Datums-Range ist standardmäßig auf die letzten 30 Tage gesetzt. Über die Date-Picker oben können Sie auf die Tour-Woche, den Kampagnen-Zeitraum oder das ganze Quartal einschränken.

Kennzahl	Was bedeutet das?
Impressions	Wie oft die Landing-Page (/q/<slug>) geöffnet wurde — anonym, ohne dass der Scanner zustimmen musste. Reine Reichweite.
Scans (Confirmed)	Wie oft jemand auf der Landing-Page „Fortfahren" geklickt hat. Erst dieser Klick führt zur eigentlichen Ziel-URL. Echte Conversion.
Unique Devices	Wie viele verschiedene Browser mindestens einmal bestätigt haben — über einen anonymen Cookie. Sagt etwas über die echte Zielgruppen-Größe aus.

Zusätzlich zwei Grafiken:

• Tagesverlauf — Impressions (blau) und Confirmed (orange) als Linien-Chart pro Tag. Zeigt Peak-Tage (Versand des Newsletters, Tag der Messe).
• Geografie + Geräte — Verteilung nach Land, Browser, Mobil/Tablet/Desktop. Zeigt z. B., dass 70 % aus DE und 80 % von Mobilgeräten gescannt haben.

KI

Conversion-Rate als Diagnose-Tool

Eine niedrige Conversion (Confirmed/Impressions, z. B. unter 30 %) deutet darauf hin, dass die Landing-Page Vertrauen verliert — die Empfänger scannen den Code, kommen auf die Bestätigungs-Seite und brechen ab. Mögliche Ursachen: Ziel-URL wirkt verdächtig, Logo fehlt, Wording zu generisch. Anpassen und mit einem neuen Slug testen.

Weg 2 — QR-Link per KI-Chat anlegen

KI

KI ist Hilfestellung — Kontrolle bleibt beim Innendienst

Die KI kann Fehler machen — falschen Slug wählen, das falsche Logo einbetten, einen URL-Typo übernehmen. Sie ist eine Hilfestellung, die Endkontrolle (vor allem vor dem Druck) liegt bei Ihnen. Vor Massen-Druck immer den fertigen QR-Code mit dem eigenen Handy gegen die echte Ziel-URL testen.

Beispiel-Prompt:

Lege einen QR-Link an: Slug "wartung-anlage-42", Name "Wartungs-Hinweis
Anlage 42 Müller GmbH", Ziel-URL https://kunden.kft-brandschutz.de/wartung/42,
Style aus Template "Corporate 2026", Fußtext "Anlage 42 · Müller GmbH".
Aktiv setzen. Anschließend SVG-Export zum Druck.

Die KI bereitet POST /api/qr-links mit dem passenden Body vor, wartet auf Ihre Bestätigung, legt an und triggert anschließend den SVG-Export.

Was tue ich, wenn etwas schiefgeht?

!

Slug ist schon vergeben

Slugs sind pro Mandant einzigartig. SpeamCore lehnt einen doppelten Slug beim Speichern ab. Lösung: anderen Slug wählen — z. B. mit Jahreszahl oder Standort-Kürzel (wartung-2026-stuttgart).

!

QR-Code lässt sich nicht scannen

Häufige Ursachen: (1) Logo zu groß — logoSize reduzieren. (2) Zu helle Farben — Punkt-Farbe dunkler wählen, der Kontrast zur Hintergrundfarbe muss klar sein. (3) Schlechter Druck — bei Aufklebern auf strukturierter Oberfläche immer das größere Format wählen. (4) Slug wartung-anlage-42 wurde getippt aber Aktiv = Nein → Public-Resolve liefert 404.

!

Stats zeigen 0 obwohl der Code gescannt wurde

Range-Filter prüfen — Default sind die letzten 30 Tage. Sehr alte Scans tauchen hier nicht auf. Außerdem: Impressions zählen erst beim Aufruf der Landing-Page. Wer den QR-Code mit einer App scannt, die direkt zur Ziel-URL umleitet (ohne Landing-Page), erzeugt keine Impression — solche Apps gibt es selten, aber sie sind nicht ausgeschlossen.

!

Kollegen sehen den QR-Link nicht in ihrer Liste

Kein Mandanten-Wechsel — alle Codes sind pro Mandant getrennt. Falls der Kollege im richtigen Mandanten ist: Berechtigung view:QrLink prüfen (manche Rollen haben nur Read).

Tipps aus der Praxis

• Vor Druck immer abscannen — eigenes Handy, echter Scan, prüfen ob die Ziel-URL wirklich öffnet. Spart Druck-Wiederholungen.
• Slug aussagekräftig wählen — wartung-anlage-42 ist besser als kvj8m21h. Falls die Ziel-URL im Browser kurz angezeigt wird, baut das Vertrauen auf.
• Templates für Branding — Admin legt Corporate-Templates an (siehe QR-Link-Templates), Innendienst übernimmt sie per Klick. Verhindert, dass jeder Mitarbeiter eigene Farben mischt.
• Logo-PNG mit transparentem Hintergrund — vermeidet hässliche Kanten beim Einbetten.
• Kampagnen-Auswertung wöchentlich — Stats-Tab am Montag öffnen, die Vorwoche reviewen, Ergebnis kurz in der Teamrunde teilen.
• Inaktiv statt löschen — wenn eine Kampagne durch ist: Aktiv = Nein setzen statt löschen. Die Stats bleiben erhalten, die Kampagne ist später noch nachvollziehbar.

Verwandte Tutorials

• Anlagen und Standorte pflegen — typische Quelle für Anlagen-Aufkleber-Texte
• Mail versenden — Versand des QR-Codes per Mail an Kunden
• QR-Link-Templates — Modul-Doku für die Vorlagen
• QR-Link-Tracking — Konzept-Hintergrund zum Privacy-Modell

Für Admins: technische Details

• Modul-Doku: QR-Links, QR-Link-Templates, QR-Link-Tracking.
• Public-Routes (keine Auth): GET /api/qr-public/:slug, POST /api/qr-public/:slug/impression, POST /api/qr-public/:slug/confirm.
• Style-Cascade: QrLink.styleJson → UiConfig.color.qrCode* + UiConfig.option.qrCode* → DEFAULT_STYLE.
• Privacy: anonyme Impressions ohne IP-Hash, Confirmed-Scans mit täglich rotierendem HMAC-SHA256(ip, daily_salt) und HttpOnly-Cookie (1 Jahr).
• Migrationen 20260519110001 ff. — siehe Welle 130.