Implementing Self Deep Linking
Follow
Getting Started
We will guide you through what is necessary to process deep linking app opening and market landing directly without using the tracking link provided by DFINERY .
Since the role played by DFINERY must be implemented directly, the contents below must be implemented.
Create tracking link
To perform self-deep link tracking, you need to create a tracking link with a different setup than usual.
Set link format
Set the format of the link to Download.
Landing URL setup
Instead of DFINERY , enter the URL of the page that will handle deep linking.
Edit deep linking page
DFINERY attribution operates based on a token called abx_tid, which is issued upon click.
After installing the app through the market, the SDK must be able to check the abx_tid when opening or deep linking.
Modify the page to handle deep linking so that the abx_tid value is passed when opening the market landing or deep linking app, referring to the following content.
Obtain abx_tid
The abx_tid generated when clicking the DFINERY tracking link is attached to the landing URL address and delivered.
<!-- Landing URL : https://my.webpage.com/landing_url.html --> https://my.webpage.com/landing_url.html?abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
You can use the following script to retrieve abx_tid from the URL of the landing page.
var getAbxTidParameter = function getAbxTidParameter() { var landingPageUrl = window.location.search.substring(1); referrerDatas = landingPageUrl.split('&'), referrerParamName, i; for (i = 0; i < referrerDatas.length; i++) { referrerParamName = referrerDatas[i].split('='); if (referrerParamName[0] === "abx_tid") { return referrerParamName[1] === undefined ? true : 'abx_tid%3D' + referrerParamName[1]; } } }; var abx_tid = getAbxTidParameter();
Pass abx_tid
The abx_tid value obtained from the landing URL address must be added to the market landing URL or deep linking URL to ensure proper landing.
For market landing, simply add &referrer=abx_tid to the existing market address.
<!-- 마켓URL : market://details?id=com.my.package_name --> market://details?id=com.my.package_name&referrer=abx_tid%3D1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
In the case of deep linking app open, you can add abx_tid to the existing deep linking URL.
<!-- Deep linking URL: scheme://host?myparam=data --> scheme://host?myparam=data&abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
Deferred deep link implementation
You can implement deferred deep linking while self-deep linking is integrated.At this time, the deferred deep link value delivered is the deep link handling page address set by the user when creating the tracking link .Therefore, the app should be set up to navigate to a specific screen in the app through the deep link handling page address delivered via the deferred deep link listener.
Implement deferred deep link in the app
For the implementation of deferred deep links, deferred deep links within the app must be implemented.
[Android Deferred Deep Link Implementation Guide]
[iOS Deferred Deep Link Implementation Guide]
Tracking link setup
To use deferred deep links, you need to change the tracking link settings as follows.
1) When creating a tracking link, set the landing format to "Download + Deeplink".
2) Select the deep link path method as "Dynamic Path".
3) Set the Ad-Touch Landing to direct setting as before, then enter the page to handle the deep link.
4) Enter the deeplink processing page address where the deeplink_custom_path URL is encoded when creating a deep link.
Deep link processing address example: https://my.webpage.com/landing_url.html
Enter the URL-encoded deep link processing address in the deeplink_custom_path parameter within the tracking link as shown below.
https://qoxg6rs5r02dgcl26wts1q.adtouch.adbrix.io/api/v1/click/aFT2LV9hMECmtqefExI9Mg?deeplink_custom_path=https%3A%2F%2Fmy.webpage.com%2Flanding_url.html
5) After clicking the tracking link, check if the address for processing the deep link is delivered to the deferred deep link listener when the app is installed and launched.
Values delivered through the deferred deep link listener: https://my.webpage.com/landing_url.html
Integration Support Inquiry
If you have any additional questions or need support regarding self deep link and deferred deep link integration, please contact us at the email below, and we will actively support you.
support-tracker@adbrixsupport.zendesk.com