We've updated our API endpoints to match what we use in our application. Some endpoints have been deprecated. See our Deprecated Endpoints page for migration details.
Richten Sie eine eigene Domain für Ihre QR-Codes ein und verifizieren Sie diese.
Mit eigenen Domains lösen sich Ihre QR-Codes und Kurzlinks über Ihre eigene Subdomain auf (zum Beispiel offer.yourbrand.com) statt über die Standard-Kurz-URL scnv.io.
Für diese Funktion existieren in der App zwei Routen: /settings/domains und /account/domains. Live-Tests haben bestätigt, dass /account/domains lediglich eine Weiterleitung direkt zu /settings/domains ist (sie rendert nichts Eigenes), und auch der Link in der App-eigenen Seitenleiste – beschriftet mit Eigene Domain unter Einstellungen – verweist auf /settings/domains. Das ist die kanonische, unten dokumentierte Route.
Öffnen Sie Einstellungen > Eigene Domain in der Seitenleiste, oder gehen Sie direkt zu /settings/domains.
Seite „Eigene Domains“ ohne bisher hinzugefügte Domains
Eigene Domains sind eine Funktion ab dem Pro-Plan. Bei einem Plan ohne Domain-Zugriff zeigt diese Seite anstelle des unten beschriebenen Einrichtungsvorgangs einen Upgrade-Hinweis.
Klicken Sie auf Domain hinzufügen. Eine Detailansicht öffnet sich und fragt nach dem Subdomain-Namen, den Sie verwenden möchten – der vollständige Name inklusive Subdomain, zum Beispiel offer.myweb.com.
Schritt 1: Eingabe des Subdomain-Namens
Ein Abschnitt Erweiterte Einstellungen ermöglicht es Ihnen, die Groß-/Kleinschreibungsempfindlichkeit für die URL-Slugs dieser Domain zu deaktivieren, bevor Sie fortfahren – dies kann später nicht mehr geändert werden, entscheiden Sie sich also vorab, ob Sie es benötigen.
2
Die DNS-Einträge hinzufügen
Sobald Sie fortfahren, wird die Domain erstellt, und die Detailansicht zeigt die genauen DNS-Einträge, die Sie bei Ihrem Registrar hinzufügen müssen: einen CNAME-Eintrag, der Ihre Subdomain auf das Ziel von Scanova verweist, und einen TXT-Eintrag (auf @, der Root-Ebene), der den Besitz nachweist.
Die für diese Domain benötigten DNS-Einträge, aus der schreibgeschützten Detailansicht
Jeder Wert hat eine Schaltfläche zum Kopieren in die Zwischenablage daneben. Wenn Sie dies lieber nicht selbst tun möchten, siehe DNS-Anweisungen an Ihr IT-Team senden weiter unten.
3
Verifizieren
Klicken Sie auf Verifizieren. Wenn beide Einträge auflösbar sind, wird die Domain sofort als verifiziert markiert. Falls nicht – was direkt nach dem Hinzufügen neuer DNS-Einträge zu erwarten ist – sehen Sie eine Meldung „konnte noch nicht verifiziert werden“:
Ihre eigene Domain kann derzeit nicht verifiziert werden. Bitte beachten Sie, dass es manchmal bis zu 24 Stunden dauern kann, bevor unser System die Änderungen an Ihrer Subdomain erkennen kann. Sie können die Domain nach einiger Zeit erneut verifizieren.
Die DNS-Propagierung kann im schlimmsten Fall bis zu 48 Stunden dauern, auch wenn der In-App-Text für diese spezifische Meldung von bis zu 24 Stunden spricht – beide Angaben erscheinen im Produkt, je nachdem, wo man nachsieht. Betrachten Sie „bis zu 48 Stunden“ daher als sichere Obergrenze, bevor Sie annehmen, dass tatsächlich etwas nicht stimmt.
Live getestet mit einer Domain ohne echte, darauf verweisende DNS-Einträge: Die Domain wurde erfolgreich erstellt und zeigte sofort den Status Nicht verifiziert an, genau wie erwartet, da es nichts zu finden gab.
Sobald eine Domain in Ihrer Liste existiert, zeigt ihre Zeile den Verifizierungsstatus, ob es sich um Ihre Standard-Domain handelt, sowie ein ···-Menü:
Eine Domain-Zeile mit Status „Nicht verifiziert“, „Erneut verifizieren“, „Erneut einrichten“ und geöffnetem Zeilenmenü
Erneut verifizieren – prüft DNS erneut, ohne die Einrichtung neu zu starten. Verwenden Sie dies, nachdem Sie die Einträge tatsächlich hinzugefügt und der DNS-Propagierung Zeit gegeben haben.
Erneut einrichten – startet die Einrichtungsansicht bei Schritt 1 neu, mit dem aktuellen Host vorausgefüllt, falls Sie einen Tippfehler korrigieren müssen. Da ein Domainname nach der Erstellung nicht bearbeitet werden kann, löscht eine Änderung hier den alten Eintrag und erstellt einen neuen – aber erst, nachdem der Ersatz bestätigt und erfolgreich erstellt wurde, sodass Sie nie ganz ohne Domain dastehen.
Einrichtungsanweisungen senden – sendet die genauen DNS-Einträge per E-Mail an die Person, die Ihr DNS verwaltet.
Root-Domain-Einstellungen – legen Sie fest, was passiert, wenn jemand die reine Domain direkt besucht, ohne einen QR-Code-Pfad: eine generische Seite anzeigen, zu einer URL weiterleiten oder eine eigene Landingpage anzeigen.
Löschen – entfernt die Domain; alle QR-Codes, die sie verwenden, fallen auf die Standard-Kurz-URL von Scanova zurück.
Wenn Sie die DNS-Einträge lieber an die Person weitergeben möchten, die Ihre Domain verwaltet, verwenden Sie Einrichtungsanweisungen senden aus dem Zeilenmenü, statt jeden Wert selbst zu kopieren:
DNS-Einrichtungsanweisungen per E-Mail an ein anderes Team senden
Geben Sie eine Empfänger-E-Mail-Adresse ein (zum Beispiel die Ihres IT-Teams) sowie eine optionale Notiz, und senden Sie dann ab. Die E-Mail enthält die genauen CNAME- und TXT-Einträge für diese Domain – dieselben Werte, die im Schritt „DNS-Einträge“ oben angezeigt werden.
Eine Option Eigenes SSL-Zertifikat wird im ···-Menü der Zeile erst verfügbar, nachdem eine Domain vollständig verifiziert ist (sowohl CNAME als auch TXT) – sie war während dieser Testphase nicht erreichbar, da in der Testumgebung keine verifizierte Domain verfügbar war. Laut Quellcode läuft der Ablauf so: Erzeugen Sie eine CSR (Certificate Signing Request) für die Domain, reichen Sie diese bei Ihrer eigenen Zertifizierungsstelle ein, und fügen Sie dann das signierte Zertifikat zurück ein, um es zu aktivieren. Bei Plänen ohne dieses Zusatzmodul zeigt der Dialog stattdessen ein Formular „Zugriff anfragen“ an, das sich direkt an das Team von Scanova wendet, da eigenes SSL keinen Self-Service-Upgrade-Pfad hat.
Dies ist aus dem Quellcode dokumentiert, nicht live bestätigt – überprüfen Sie den genauen CSR-/Upload-Ablauf in der laufenden App, bevor Sie die obigen Details als endgültig betrachten.
