NOTE: This guide does not apply to Facebook Ads, Twitter Ads, etc., as those do not accept 3rd party tracking URLs to be embedded in their ads. The steps outlined below are for the purpose of generating a SmartLink™ for optimal user experience when used within a social post.
Guide Overview:
Two separate guides have been created:
- One In-App Destination Per SmartLink™ Overview:
- The posted SmartLink™ would look like this:
- The if app is installed destination is set to:
- When this SmartLink™ is clicked, the user is taken to:
- Dynamic In-App Destination Overview:
- Posted SmartLink™ example 1:
- Posted SmartLink™ example 2:
- Posted SmartLink™ example 3:
- The if app is installed destination is set to:
- You can see that these three URLs are all the same SmartLink™ (all three have the same SmartLink™ ID) you are simply changing the city parameter value when posting it in different contexts.
- When example 1 is clicked, the user will be taken to myapp://sandpoint.
When example 2 is clicked, the user will be taken to myapp://losangeles.
When example 3 is clicked, the user will be taken to myapp://paris.
https://smart.link/abcdefghij
myapp://sandpoint
myapp://sandpoint
The advantage of using a dynamic in-app destination is that you do not need a separate SmartLink™ for each specific in-app destination you want to send the user to.
This is accomplished by including a macro in your if app is installed destination, e.g., myapp://{city} and appending a parameter to your posted SmartLink™ URL, such as https://smart.link/abcdefghij?city=sandpoint which will inform the in-app destination: myapp://{city} → myapp://sandpoint.
When creating a different post, you can use the same SmartLink™, and simply change the value of the parameter on the SmartLink™, e.g., https://smart.link/abcdefghij?city=losangeles. A shopping app would likely use the product’s item ID, while a media app would use the article ID.
https://smart.link/abcdefghij?city=sandpoint
https://smart.link/abcdefghij?city=losangeles
https://smart.link/abcdefghij?city=paris
myapp://{city}
- Create a SmartLink™ (SmartLink™ #1).
- Set the Universal Link/App Link destination if app is installed: e.g., myapp://sandpoint
- Set the if app is not installed destinations (typically the app store).
- The output of the SmartLink™ should look like:
- Create a Landing Page.
- Set the destination of the landing page to custom.
- Enter the SmartLink™ you just created as the destination:
- The output of the Landing Page should look like:
- Create another SmartLink™ (SmartLink™ #2).
- Ensure the domain selected is https://smart.link and not a custom domain (e.g., your-brand-name.smart.link).
- On iOS, leave the if app is installed destination blank.
- On Android, enter the in-app destination URI: e.g., myapp://sandpoint as the if app is installed destination.
- Enter the landing page URL you just created as the if app is not installed destinations on both iOS and Android.
- Do not append any key/value pairs to the landing page URL.The output of the SmartLink™ should look like: https://smart.link/abcdefghi
- Post SmartLink™ #2.
This should represent the in-app destination you want to take the user to and in this use-case, should not include a macro.
https://your-brand-name.smart.link/123456789
NOTE: This SmartLink™ will sit behind the action button on the Landing Page. It is not the SmartLink™ that will be posted for users to click on.
http://your-brand-name.smart.link/123456789.
Do not append any key/value pairs to the end of the SmartLink™ URL.
https://pages.smart.link/my-landing-page-name
- Create a SmartLink™ (SmartLink™ #1).
- Set the Universal Link/App Link destination if app is installed: e.g., myapp://{city}
- Set the if app is not installed destinations (typically the app store).
- The output of the SmartLink™ should look like:
- Create a Landing Page.
- Set the destination of the landing page to custom.
- Enter the SmartLink™ you just created:
- The output of the Landing Page should look like:
- Create another SmartLink™ (SmartLink™ #2).
- Ensure the domain selected is https://smart.link and NOT a custom domain (e.g., your-brand-name.smart.link).
- On iOS, leave the if app is installed destination blank.
- On Android, enter the in-app destination URI: e.g. myapp://{city} as the if app is installed destination.
- Enter the landing page URL you just created as the if app is not installed destinations on both iOS and Android.
- Add a key/value pair to the landing page URL in the destination box:
- This ensures that value from the SmartLink™ URL gets persisted to the final destination.
- Posted Link:
- Landing Page:
- Final In-App Destination:
- The output of the SmartLink™ should look like:
- Before posting the SmartLink™, be sure to replace the macro on the SmartLink™ URL with the context relevant to the post:
- Post the SmartLink™.
This should represent the in-app destination you want to take the user to and in this use-case, should include a macro.
https://your-brand-name.smart.link/123456789
NOTE: This SmartLink™ will sit behind the action button on the Landing Page. It is not the SmartLink™ that will be posted for users to click on.
http://your-brand-name.smart.link/123456789.
Do not append any key/value pairs to the end of the SmartLink™ URL.
https://pages.smart.link/my-landing-page-name.
https://pages.smart.link/my-landing-page-name?city={city}
https://smart.link/abcdefghij?city=sandpoint→
https://pages.smart.link/my-landing-page-name?city={city}→
myapp://{city}
https://smart.link/abcdefghi?city={city}
https://smart.link/abcdefghi?city=sandpoint
If App is Already Installed:
If App is Not Installed:
If App is Already Installed:
If App is Not Installed:
- Kochava has updated the user experience and flow for Universal Link/App Link-enabled SmartLinks™ associated with specific Social Media partners:
If App is Already Installed:
If App is Not Installed: