> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# App-Deep-Link-QR-Code

> Erstellen Sie einen QR-Code, der per Deep-Link in eine mobile App führt.

## Wofür er gedacht ist

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."

<Note>
  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.
</Note>

## Auflösungsreihenfolge

Das Formular ist in drei Abschnitte gegliedert, die beim Scannen in dieser Reihenfolge geprüft werden:

1. **App installiert** – das Gerät öffnet Ihre App direkt über die passende **Android-App-URI** oder **iOS-App-URI**.
2. **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.
3. **Keines von beidem trifft zu** – der Scannende wird zur **Fallback web URL** weitergeleitet, weshalb dieses Feld erforderlich ist.

## Einen App-Deep-Link-QR-Code erstellen

<Steps>
  <Step title="Create QR Code öffnen und Quick Code auswählen">
    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**.
  </Step>

  <Step title="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`.
  </Step>

  <Step title="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`).
  </Step>

  <Step title="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.

    <Frame caption="Das App-Deep-Link-Quick-Code-Formular mit eingegebenen App-URIs, Store-Links und einer Fallback-URL">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=fa5c24381e8f34cf1794154ecce881bc" alt="App-Deep-Link-Quick-Code-Formular mit Android- und iOS-App-URIs, optionalen Store-Links, einer erforderlichen Fallback-URL und der automatisch generierten Short-URL des dynamischen QR-Codes" width="1280" height="1277" data-path="images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Erstellung über die API

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](/v1/api-reference/endpoint/qr_manager/create) 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:

```json theme={null}
[
  {
    "type": "intentUri",
    "data": [
      { "type": "android", "uri": "acmeapp://profile/42" },
      { "type": "ios", "uri": "acmeapp://profile/42" }
    ]
  },
  {
    "type": "appStore",
    "data": [
      { "type": "playStore", "url": "https://play.google.com/store/apps/details?id=com.acme.app" },
      { "type": "appleStore", "url": "https://apps.apple.com/app/id123456789" }
    ]
  },
  {
    "type": "fallback",
    "data": { "url": "https://acme.com/profile/42" }
  }
]
```

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](/v1/api-reference/endpoint/qr_manager/create).

## Weiterführende Informationen

* [App-Store-QR-Code](/de/qr-codes/create/app-store) – eine einfachere Alternative "zum Store weiterleiten", wenn Sie kein In-App-Deep-Linking benötigen.
* [Ihren ersten QR-Code erstellen](/de/getting-started/first-qr-code) – eine vollständige Anleitung zum Quick-Code-Ablauf, zu dem dieser Typ gehört.
* [Ordner, Tags & Bulk-Operationen](/de/qr-codes/manage/folders-tags-bulk-operations) – den QR-Code nach der Veröffentlichung organisieren.