Deeplinking voor affiliate-attributie in React Native
Deeplinking is de basis van mobiele affiliate tracking. Het verbindt de tik op de affiliate link met je app en draagt de attributiegegevens mee die aangeven welke affiliate de gebruiker heeft doorverwezen. In React Native met React Navigation vraagt het configureren van deeplinks zowel native platformconfiguratie als routingconfiguratie in JavaScript.
Platformconfiguratie
iOS (Universal Links)
- Voeg de Associated Domains-capability toe in Xcode (applinks:yourdomain.com)
- Host het apple-app-site-association-bestand op je domein
- Configureer je AppDelegate om binnenkomende URL's te verwerken
Android (App Links)
- Host assetlinks.json op je domein
- Voeg intent filters met autoVerify="true" toe in AndroidManifest.xml
- Configureer je MainActivity om binnenkomende intents te verwerken
Beide platforms hebben de native configuratiebestanden nodig om te verifiëren dat je app links van je domein rechtmatig afhandelt.
Deeplinkconfiguratie in React Navigation
React Navigation ondersteunt deeplinking via de linking-configuratie. Definieer URL-patronen die naar de schermen van je app verwijzen:
Configureer de linking-prop op je NavigationContainer met de prefixes (je affiliate-domein) en een config-object dat URL-paden aan schermnamen koppelt.
Voor affiliate tracking hoeft de deeplink echter niet per se naar een specifiek scherm te navigeren. Het belangrijkste doel is het vastleggen van de affiliate-identifier uit de URL-parameters.
Attributiegegevens vastleggen
De React Native SDK van Insert Affiliate regelt het vastleggen van attributie wanneer een deeplink binnenkomt:
- De app ontvangt de universal link / app link
- Voordat React Navigation de URL voor routing verwerkt, haalt de Insert Affiliate SDK de affiliate-identifier eruit
- De SDK slaat de attributie lokaal op en bevestigt die bij de server
- Daarna handelt React Navigation de navigatie gewoon af zoals normaal
Initialiseer de Insert Affiliate SDK voordat je React Navigation instelt, zodat de attributie is vastgelegd voordat de router de URL verwerkt.
De linking-levenscyclus afhandelen
Deeplinks komen binnen in twee scenario's:
App draait al (warm start): De link komt binnen via de Linking API van React Native. Luister naar URL-events en geef binnenkomende URL's door aan zowel de affiliate SDK als je navigatiehandler.
App draait niet (cold start): De initiële URL waarmee de app is gestart, is beschikbaar via Linking.getInitialURL(). Controleer dit bij het opstarten van de app en verwerk eventuele affiliate-parameters.
Deferred deeplinks (nieuwe installaties)
Wanneer een gebruiker op een affiliate link tikt maar de app niet geïnstalleerd heeft:
- Wordt hij doorgestuurd naar de app store
- Installeert en opent hij de app
- Komt er geen deeplink-URL binnen (de installatie kwam via de store)
- Controleert de Insert Affiliate SDK bij de eerste start op openstaande server-side attributies
- Wordt de attributie bepaald via device matching
Roep de deferred attributiecontrole van de SDK aan tijdens de initiële laadvolgorde van je app.
Deeplinks testen
Test op echte apparaten (geen simulators voor universal links):
- Gebruik de Notities-app van iOS of Safari om op test-affiliate links te klikken
- Test op Android vanuit Chrome en berichtenapps
- Test zowel cold start- als warm start-scenario's
- Controleer of de attributie in het dashboard van Insert Affiliate verschijnt
Veelvoorkomende problemen
- Universal links werken niet: Zorg dat het AASA-bestand bereikbaar en geldig is. Test vanuit Safari, niet in in-app browsers.
- Navigatieconflicten: Als meerdere libraries URL's afhandelen, zorg dan dat de affiliate SDK de URL als eerste verwerkt.
- Beperkingen van de Expo managed workflow: Gebruik development builds om deeplinks volledig te testen.
De React Native SDK van Insert Affiliate integreert met de levenscyclus van React Navigation, zodat attributie betrouwbaar wordt vastgelegd, ongeacht hoe de gebruiker in je app terechtkomt.