When you create a tracking link for your app, you can configure it to be a deep link.
With a deep link, if a user clicks the ad and they already have your app installed, not only will the app open - but it will show the specific app content of your choice, not just the app's default screen.
Important: You must plan your deep links before you integrate the Singular SDK into your app. Your engineers will implement the deep links as part of the SDK integration process.
Before You Begin: Plan Your Deep Links
To begin, make a list of all the deep links you want to implement in your ad campaigns for the app.
For each deep link, decide on the following:
- Target app content: what screen in your app should the user see?
- Fallback redirect: if the user doesn't have your app installed, where should they be redirected? (Typically, your app's store page)
- Is this a deferred deep link? i.e. should the link show specific app content even to new users installing your app?
Example: If your app is a clothing store, you may want to set up the following deep links.
|Deep Link||Content to Display||Enable Deferred?||Fallback Redirect|
|New-season sale: autumn fashion||Display clothes tagged with "new autumn collection"||✅||<app URL in app store>|
|Special offer: Register for newsletter and get a $5 coupon||"Register for newsletter" screen||✅||<app URL in app store>|
How to Build a Deep Link
Create a Link Domain
Singular Links have the following structure, where [SUBDOMAIN] is chosen by you:
If you don't have any domains set up yet, you have to create at least one in order to start creating Singular Links. To do so:
You can create a single domain (e.g., the name of your company or app) and use it for all your links, or you can create several to use for different purposes.
Communicate Deep Link Plan to Engineering Team
Your developers need to know the deep link destinations before they integrate the Singular SDK/S2S in your app (or before they release an update for your app).
As the developers implement the SDK, they add code that identifies if the app has been opened through a deep link and directs the user to the appropriate app screen or content (step-by-step guides for developers are available for Android, iOS, Unity, React).
Once your engineering team is done, they can give you:
Enter Link Scheme Info in the Apps Page
Depending on your app's platform(s) and the technology that your engineering team used to implement deep linking, there may be some information you need to enter in the Apps page (Settings > Apps).
This information should be given to you by your engineering team.
If your app has more than one app site (meaning that it is available for more than one platform), enter the necessary information in each of them.
(Optional) Add Deep Link Destinations in the Apps Page
You can add the deep link destinations to your app settings in the Apps page for easy access. This way, whenever you create new tracking links, these destinations will appear in the drop-downs for you to choose from.
This step is optional, as you can always just type in any destination when you create a Singular Link.
To add deep link destinations to the Apps page:
Create the Link
To create the actual tracking link (with deep linking included):
Test the Link
Now that you've created the deep link, you can easily test it to see how it works.
To test the deferred deep link functionality:
To test the deep link functionality:
To test how the Singular Link functions for determining attribution, see How to Test a Tracking Link.
Advanced: Add Dynamic Content to the Link
You can make a Singular Link do even more work by adding data to it dynamically as you display your ads. This data can then be read and used by your app if a user engages with one of the ads and then arrives into your app.
This is useful, for example, if you have a shopping app and you show dynamic banner ads for different products. When users click an ad, you want the app to open and display the page for the specific product they clicked on. To do so, you want to add the product ID dynamically to the Singular Link.
To implement deep links with dynamic content, follow the same steps described above, starting with planning the link and giving all the information to your engineering team.
Note for Developers: Using the _p Parameter
To add dynamic data to a Singular Link as you serve the ad, append the _p parameter and any value to the end of the Singular Link URL. _p stands for "passthrough" and the value can be a URL-encoded JSON value or an unstructured string value.
For example, if the Singular Link is: https://myshoppingapp.sng.link/A59c0/nha7
When you display the ad, you can append the product ID to the Singular Link as follows: https://myshoppingapp.sng.link/A59c0/nha7?_p=Shoes123