Deep links naar mobiele apps

Deep links openen native apps rechtstreeks vanuit een korte URL. Als de bezoeker je app heeft geïnstalleerd, opent de link het juiste scherm binnen de app. Als dat niet zo is, valt de link terug op de App Store (iOS) of Play Store (Android) — of elke andere URL die je configureert.

Wat je nodig hebt

Om deep links te gebruiken heb je nodig:

• Een iOS-app met Universal Links geconfigureerd, OF
• Een Android-app met App Links geconfigureerd, OF
• Custom URI-schemes (myapp://) als je nog geen Universal/App Links hebt.

Voor Universal Links en App Links moet je ook associatiebestanden publiceren (apple-app-site-association voor iOS, assetlinks.json voor Android) op je custom domain. Elido serveert deze automatisch voor je zodra je het bestand uploadt via Settings → Domains → Deep linking.

Deep links configureren op een link

1. Open de detailpagina van de link → Targeting → Deep linking.
2. Schakel deep linking in.
3. Voeg een iOS-configuratie toe:
   • App ID — bijv. K72L8M4N9P.com.acme.myapp (het Team ID + bundle identifier uit je Apple Developer-account).
   • In-app-pad — waar de app naartoe moet routeren. Het pad wordt toegevoegd aan je universal-link-host; de SDK in de app leest het uit de launch-URL.
   • Fallback-URL — waar bezoekers zonder de app naartoe worden gestuurd. Meestal je App Store-vermelding.
4. Voeg een Android-configuratie toe:
   • Packagenaam — bijv. com.acme.myapp.
   • In-app-pad — hetzelfde idee als bij iOS.
   • Fallback-URL — meestal een Play Store-URL met je packagenaam.
5. Save. De link voert vanaf nu bij elke klik apparaatgebaseerde routering uit.

Wat er gebeurt op het moment van klikken

De redirect-handler retourneert een HTML-tussenpagina die ongeveer 50 ms JavaScript uitvoert. De tussenpagina:

1. Detecteert iOS versus Android versus desktop.
2. Op iOS: probeert te openen via Universal Link. Als het besturingssysteem de app opent, ben je klaar.
3. Op Android: hetzelfde met App Links.
4. Na 1,2 seconden zonder app stuurt de pagina door naar de fallback-URL.

Desktopbezoekers komen altijd rechtstreeks op de fallback-URL terecht — er is geen app om te openen.

Als een bezoeker zich op een platform bevindt dat we niet herkennen (webview in WeChat, enz.), valt de link terug op de desktopbestemming. Je kunt dit overschrijven met smart-link-regels.

Fallback op URI-scheme

Als je nog geen Universal Links/App Links hebt ingesteld, kun je alsnog een custom URI-scheme gebruiken:

• iOS-scheme: myapp://
• Android-scheme: myapp://

De tussenpagina probeert het scheme te openen en valt na 1,2 seconden terug op de App Store/Play Store. Het nadeel is dat het besturingssysteem bij de eerste keer een bevestiging "Openen in Mijn App?" toont, wat Universal Links vermijden.

Analytics

Elke klik registreert of de app is geopend of dat de fallback is gebruikt. Het tabblad Analytics → Deep linking van de link toont het openpercentage per platform — handig om te meten hoe goed je associatiebestanden werken.

Limieten

• Eén iOS-configuratie en één Android-configuratie per link.
• Deep linking is beschikbaar op Pro en Business; het gratis plan ondersteunt alleen platte redirects.

Veelvoorkomende valkuilen

Universal Links werken op een echt apparaat maar niet in de simulator. Dit is verwacht gedrag — Apple's simulator kan het AASA-bestand niet ophalen. Test op een echte telefoon.

De fallback-URL opent al voordat de app het zelfs maar probeert. Sommige Android-browsers (met name Samsung Internet) onderscheppen het scheme voordat het besturingssysteem het ziet. Zorg dat je App Links-instelling compleet is: domein geverifieerd, packagenaam correct, SHA-256-vingerafdruk komt overeen.

iOS toont soms een tap-target-banner in plaats van de app te openen. Dat is iOS's "Openen in Safari → Smart Banner", die de pagina als een generieke site behandelt. Het opnieuw uploaden van het AASA-bestand met het juiste app-ID lost dit meestal op.

De link opent de app, maar dan het verkeerde scherm. Je in-app-routering komt niet overeen met het pad dat Elido doorgeeft. Log de launch-URL in je app om te bevestigen wat je daadwerkelijk ontvangt, en werk daarna de padconfiguratie bij zodat deze overeenkomt.