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.
Ein App-Deep-Link-QR-Code öffnet Ihre App direkt bei einem bestimmten Bildschirm – über ihr eigenes URI-Schema –, sofern die App auf dem scannenden Gerät installiert ist. Ist sie nicht installiert, greift der Code auf den Store-Eintrag Ihrer App zurück oder, als letzte Möglichkeit, auf eine einfache Webseite. Es handelt sich um einen Quick Code – einen QR-Code für eine direkte Aktion ohne Landingpage. In der App lautet die Kachel dafür: “Open your app directly if it’s installed, otherwise fall back to the store.”
App Deep Link ist immer ein dynamischer QR-Code – dies ist erforderlich, damit die Auflösungslogik (App → Store → Fallback) beim Scannen ausgeführt werden kann. Sie erhalten eine Scanova-Short-URL (scnv.io/...) und können eine eigene Domain verknüpfen, aber es gibt keine eigene Landingpage.
Das Formular ist in drei Abschnitte gegliedert, die beim Scannen in dieser Reihenfolge geprüft werden:
App installiert – das Gerät öffnet Ihre App direkt über die passende Android-App-URI oder iOS-App-URI.
App nicht installiert, Betriebssystem erkannt – das Gerät wird zum passenden Store-Link (Google Play oder Apple App Store) weitergeleitet, sofern Sie einen angegeben haben.
Keines von beidem trifft zu – der Scannende wird zur Fallback web URL weitergeleitet, weshalb dieses Feld erforderlich ist.
Gehen Sie in der Seitenleiste zu QR Codes und klicken Sie dann auf Create QR Code (oder navigieren Sie zu /qr/create). Klicken Sie auf die Karte Quick Code.
2
App Deep Link auswählen
Klicken Sie im Raster der Quick-Code-Typen unter App Deep Link im Bereich Dynamic oben auf Configure (dieser Typ hat keine statische Option). Dadurch öffnet sich das Formular unter /qr/quick/appDeepLink.
3
Ihre App-URIs hinzufügen
Geben Sie unter App URIs mindestens eine der Optionen Android app URI oder iOS app URI ein – das eigene Schema, das Ihre App registriert, um sich direkt zu öffnen (z. B. myapp://profile).
4
Store-Links (optional) und eine Fallback-URL hinzufügen
Fügen Sie unter Store links optional Ihre Google-Play- und/oder Apple-App-Store-URLs hinzu, die angezeigt werden, wenn die App nicht installiert, das Betriebssystem des Geräts aber erkannt ist. Geben Sie unter Fallback URL eine Fallback web URL ein – dieses Feld ist erforderlich, da es das letzte Ziel für alle anderen Fälle ist.
Das App-Deep-Link-Quick-Code-Formular mit eingegebenen App-URIs, Store-Links und einer Fallback-URL
5
Veröffentlichen
Klicken Sie auf Publish. Ein Panel öffnet sich, um den QR-Code zu bestätigen oder umzubenennen, einen Ordner oder Tags zuzuweisen und das QR-Design anzupassen, bevor Sie bestätigen.
Um einen App-Deep-Link-QR-Code über die API statt über die Benutzeroberfläche zu erstellen, verwenden Sie die Kategorie-ID 23 (in der Referenztabelle Category dropdown reference von Create QR Code als App Deep Link bezeichnet, allowed_qr_types: "dy" – nur "dy" ist für qr_type gültig). Anders als bei jeder anderen Kategorie auf dieser Seite ist der info-Payload hier ein reines Array typisierter Blöcke, kein {type, data}-Objekt:
Jeder Block ist im Prinzip optional, aber die url des fallback-Blocks ist faktisch erforderlich – eine Veröffentlichung ohne Fallback scheitert an der Validierung, genauso wie es das Dashboard-Formular verhindert. Fügen Sie einen intentUri-Block nur hinzu, wenn Sie mindestens eine App-URI haben.Das vollständige Anfrageschema finden Sie unter Create QR Code.
