Deep linking
What is a contextual deep link?
Short answer
A contextual deep link is a deep link that carries extra data along with the destination, such as who shared it, which campaign it belongs to or a promo code. The app reads that data when it opens and adapts the screen, and with deferred deep linking the data also survives a fresh install.
What the context is
A plain deep link answers one question: which screen. A contextual deep link answers a second one: under what circumstances. The context is a set of values attached to the link, usually as query parameters. Typical ones are a referrer ID, a campaign name, a discount code, a preferred language or the ID of the item someone shared.
The app treats those values as input. It can greet the new user with the name of the friend who invited them, apply a code at checkout without asking for it, or skip an onboarding step that doesn’t fit the campaign.
How the data reaches the app
When the app is already installed, this is simple. The link arrives whole, through a Universal Link, an Android App Link or a URI scheme, and the app parses the query string.
When the app isn’t installed, the store sits in between and drops everything. The data then has to travel the same way a deferred deep link does: a link service stores the tap with its parameters, and an SDK in the app collects them on first launch. On Android, Google Play’s install referrer can carry the values. This is why contextual deep linking is usually described as a feature of a deferred deep linking tool. On Appy, the Enterprise SDK delivers the link behind a fresh install together with its parameters.
What to watch for
Treat the context as untrusted input. Anyone can edit a query string, so a link should never grant a reward or a discount by itself. Send the code to your server and let the server decide.
Keep personal data out of the link. A referrer ID is fine, an email address is not, because links end up in browser histories, analytics tools and screenshots. And agree on parameter names early. Parameter forwarding only helps if the web page, the link and the app all expect the same keys.
https://example.com/invite?ref=K42&promo=WELCOME10Try it here
Build a deep link for your app
Enter your app’s scheme, the screen to open and your store and website addresses. You see the links for iOS and Android, and can turn them into one Appy link that sends each phone to the right store.
Build your deep link
The URL scheme your app registers, without ://
Leave it empty to open the home screen.
Where iPhones go when the app is not installed.
Where Android phones go. It also gives us your package name.
Where the link goes on a laptop.
Free sign-up. No credit card.
Sign-up is free and your link starts sending people to the stores right away. Opening the app itself is part of Pro, $9.99 a month.
What happens next
- 01Sign up free with Google or email
- 02We create your smart link with these settings
- 03Share it, or switch on app opening with Pro
Frequently asked questions
What is the difference between a contextual and a deferred deep link?
They describe different things. Deferred means the destination survives an install. Contextual means the link carries data besides the destination. A link can be both, and referral links usually are: the invite code has to reach an app that wasn’t on the phone when the link was tapped.
What data can a contextual deep link carry?
Anything that fits in a query string and isn’t sensitive: a referrer or invite ID, UTM parameters, a promo code, a product or content ID, a language. Avoid names, email addresses and tokens that grant access, since links are stored and shared in places you don’t control.
Do contextual deep links need an SDK?
Only for new installs. An installed app receives the full link from the system and reads the parameters itself. To get the same parameters after someone installs from a store, the app needs code that fetches them on first launch, which is what a deferred deep linking SDK does.
Related terms
- Deferred deep link
A deferred deep link is a deep link whose destination survives the app install. Someone without the app taps it, goes to the store, installs, and on first launch the app opens the screen the link promised, such as a product, an invite or a promo code, instead of the home screen.
- Deep link
A deep link is a link that opens a specific screen inside a mobile app, such as a product page, an article or a saved cart, instead of a web page or the app’s home screen. It can be a custom URI scheme, an iOS Universal Link, an Android App Link or a deferred deep link.
- Parameter forwarding
Parameter forwarding means carrying the query parameters on a smart link, such as UTM tags, coupon codes or referral IDs, through to wherever the link sends people: the app store, the website and the deep link. One link can then serve every campaign variant without a new link for each one.
One link for every phone
Create a free smart link and QR code that sends iPhones to the App Store, Android phones to Google Play and desktops to your website.