Links in Ihrer App öffnen (Deep Linking)

Erfordert Änderungen an Ihrer App

1. Schritt 1

   Bevor Sie beginnen

   Dazu laden Sie zwei Dateien hoch. Das können Sie selbst tun, wenn Sie die nötigen Werte haben, aber die Änderungen an der App und neue Versionen erfordern einen Entwickler. Sie benötigen eine aktive eigene Domain – siehe Eine eigene Domain einrichten.
2. Schritt 2

   Die iOS-Datei hinzufügen

   Öffnen Sie unter Settings > Custom Domains die Domain und ihren Bereich Open in app, und wählen Sie neben iOS Build it for me. Geben Sie zwei Werte aus Ihrer App ein:
   • App ID Prefix – zehn Zeichen, unter Membership auf developer.apple.com (meist Ihre Team ID)
   • Bundle ID – aus Xcode, etwa com.example.app
   Prüfen Sie die Datei und speichern Sie sie. Wenn Sie bereits eine apple-app-site-association-Datei haben, laden Sie stattdessen diese hoch.

   

3. Schritt 3

   Die Android-Datei hinzufügen

   Die Google Play Console zeigt die Datei für Ihre App: Kopieren Sie auf der Seite App integrity der App unter App signing das Digital Asset Links JSON. Speichern Sie es als assetlinks.json und laden Sie es im selben Bereich neben Android hoch.

   

4. Schritt 4

   Die Domain in der iOS-App angeben

   Öffnen Sie in Xcode Signing & Capabilities Ihres Targets, fügen Sie Associated Domains hinzu und tragen Sie Ihre Domain ein:

   applinks:get.example.com

   Verarbeiten Sie dann den eingehenden Link in der App – die URL kommt als User Activity an – und zeigen Sie den passenden Inhalt. Apple beschreibt beides unter Supporting associated domains.
5. Schritt 5

   Die Domain in der Android-App angeben

   Fügen Sie in AndroidManifest.xml der Activity, die die Links öffnen soll, einen Intent-Filter hinzu:

   <intent-filter android:autoVerify="true">
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <category android:name="android.intent.category.BROWSABLE" />
     <data android:scheme="https" android:host="get.example.com" />
   </intent-filter>

   Verarbeiten Sie dann den eingehenden Link in dieser Activity und zeigen Sie den passenden Inhalt. Google beschreibt beides unter Verify Android App Links.
6. Schritt 6

   Festlegen, welche Links welche App öffnen

   So wie oben eingerichtet, öffnet jeder Link auf der Domain Ihre App. Wenn nur einige Links die App öffnen sollen oder sich mehrere Apps die Domain teilen, ordnen Sie jeder App bestimmte Pfade zu:
   • iOS: Ihre App gibt nur die Domain an. Die hochgeladene Datei legt fest, welche Pfade welche App öffnen.
   • Android: Ihre App gibt die Domain und ihre Pfade an. Die hochgeladene Datei listet nur auf, welche Apps die Domain verwenden dürfen.
   Unter iOS schreiben Sie eine eigene apple-app-site-association mit den Pfaden jeder App oder mit einer Ausschlussregel, die einen einzelnen Link herausnimmt, und laden sie hoch. Ein App-Update ist nicht nötig. Neue Installationen erhalten die Änderung innerhalb von etwa einem Tag, bereits installierte Apps folgen in den nächsten Tagen.
   Unter Android stehen die Pfade im Intent-Filter jeder App, etwa android:pathPrefix="/webshop". Eine Änderung erfordert daher ein App-Update.
7. Schritt 7

   Erst hochladen, dann veröffentlichen

   Legen Sie beide Dateien bereit, bevor die neuen App-Versionen in die Stores kommen. Android prüft die Domain einmal, wenn die App installiert oder aktualisiert wird, und Apple merkt sich eine fehlende Datei etwa einen Tag lang – eine App, die vor ihrer Datei veröffentlicht wird, öffnet für ihre ersten Nutzer keine Links.
8. Schritt 8

   Auf einem Gerät testen

   Wenn Sie den Link in die Adressleiste des Browsers tippen, öffnet sich auf keiner der beiden Plattformen eine App. Installieren Sie stattdessen den neuen Build und tippen Sie in Notizen, Nachrichten oder einer E-Mail auf einen Link zu Ihrer Domain.
   Ein Tippen, das die App öffnet, geht direkt an die App und erscheint daher nicht in Ihren Onelink-Statistiken.