Links openen in je app (deep linking)

Vereist wijzigingen in je app

1. Stap 1

   Voordat je begint

   Hiervoor upload je twee bestanden, wat je zelf kunt doen als je de waarden hebt die ervoor nodig zijn, maar de wijzigingen in de app en nieuwe releases vragen om een ontwikkelaar. Je hebt een actief aangepast domein nodig — zie Een aangepast domein instellen.
2. Stap 2

   Voeg het iOS-bestand toe

   Open onder Settings > Custom Domains het domein en het paneel Open in app, en kies Build it for me naast iOS. Voer twee waarden uit je app in:
   • App ID Prefix — tien tekens, onder Membership op developer.apple.com (meestal je Team ID)
   • Bundle ID — uit Xcode, zoals com.example.app
   Controleer het bestand en sla het op. Heb je al een apple-app-site-association-bestand, upload dat dan.

   

3. Stap 3

   Voeg het Android-bestand toe

   Google Play Console toont het bestand voor je app: kopieer op de pagina App integrity van de app, onder App signing, de Digital Asset Links JSON. Sla het op als assetlinks.json en upload het naast Android in hetzelfde paneel.

   

4. Stap 4

   Noem het domein in de iOS-app

   Open in Xcode Signing & Capabilities van je target, voeg Associated Domains toe en voeg een regel voor je domein toe:

   applinks:get.example.com

   Verwerk daarna de binnenkomende link in de app — de URL komt binnen als een user activity — en toon de bijbehorende content. Apple beschrijft beide in Supporting associated domains.
5. Stap 5

   Noem het domein in de Android-app

   Voeg in AndroidManifest.xml een intent filter toe aan de activity die de links moet openen:

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

   Verwerk daarna de binnenkomende link in die activity en toon de bijbehorende content. Google beschrijft beide in Verify Android App Links.
6. Stap 6

   Kies welke links welke app openen

   Zoals hierboven ingesteld opent elke link op het domein je app. Wil je maar een deel van de links laten openen, of het domein delen tussen meerdere apps, koppel dan specifieke paden aan elke app:
   • iOS: je app noemt alleen het domein. Het geüploade bestand bepaalt welke paden welke app openen.
   • Android: je app noemt het domein en de paden. Het geüploade bestand somt alleen op welke apps het domein mogen gebruiken.
   Schrijf op iOS je eigen apple-app-site-association met de paden van elke app, of met een uitsluitingsregel die één link eruit haalt, en upload het. Een app-update is niet nodig. Nieuwe installaties krijgen de wijziging binnen ongeveer een dag, en apps die al geïnstalleerd zijn volgen in de dagen daarna.
   Op Android staan de paden in de intent filter van elke app, zoals android:pathPrefix="/webshop", dus een wijziging vraagt om een app-update.
7. Stap 7

   Eerst uploaden, dan uitbrengen

   Zet beide bestanden op hun plek voordat de nieuwe app-versies in de stores staan. Android controleert het domein één keer, wanneer de app wordt geïnstalleerd of bijgewerkt, en Apple onthoudt een ontbrekend bestand ongeveer een dag — een app die is uitgebracht voordat het bestand live staat, opent geen links voor zijn eerste gebruikers.
8. Stap 8

   Test op een apparaat

   Een link in de adresbalk van de browser typen opent geen apps, op geen van beide platforms. Installeer in plaats daarvan de nieuwe build en tik op een link naar je domein in Notities, Berichten of een e-mail.
   Een tik die de app opent gaat rechtstreeks naar de app, dus die verschijnt niet in je Onelink-statistieken.