Implementing self deep linking
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
In order to perform self-deep link tracking, you must create a tracking link with settings that are different from those in normal situations.
Link format settings
Set the link format to Download.
Landing URL settings
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.
The SDK must be able to check abx_tid when opening the app after installing it through the market or opening it through deep linking.
Refer to the following and modify the page that handles deep linking to pass the abx_tid value when landing a market or opening a deep linking app.
Get abx_tid
The abx_tid generated when clicking the DFINERY tracking link is attached to the landing URL address and delivered.
https://my.webpage.com/landing_url.html?abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
You can obtain abx_tid by searching the address of the landing page using the following script.
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 landing.
For market landing, just add &referrer=abx_tid to the existing market address.
market://details?id=com.my.package_name&referrer=abx_tid%3D1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
To open a deep linking app, simply add abx_tid to the existing deep linking URL.
scheme://host?myparam=data&abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
Deferred deep linking implementation
You can implement deferred deep linking while self-deep linking is enabled. The deferred deep link value delivered at this time is the deep link processing page address set by the user when creating the tracking link . Therefore, the app must be set up so that you can move to a specific screen in the app through the deep link processing page address delivered through the deferred deep link listener.
Implementing deferred deep linking within the app
To implement deferred deep linking, deferred deep linking must be implemented within the app.
[Android Deferred Deep Link Implementation Guide]
[iOS Deferred Deep Link Implementation Guide]
Tracking link settings
To use deferred deep linking, you must change the tracking link settings as follows.
1) When creating a tracking link, set the landing format to “Download + Deeplink”.
2) Select “Dynamic Pass” as the deep link pass method.
3) Set Ad-Touch Landing settings to manual settings as before, then enter the page to process the deep link.
4) Afterwards, enter the deeplink_custom_path url encoded deep link processing page address created when creating a deep link.
Example of deep link processing address: https://my.webpage.com/landing_url.html
Enter the URL-encoded deep link processing address in the deeplink_custom_path parameter in the tracking link as follows.
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, install the app and check whether the deep link processing address is sent to the deferred deep link listener when running.
Value passed through deferred deep link listener: https://my.webpage.com/landing_url.html
Inquiry for integration support
If you have any additional questions or require integration support regarding self deep link and deferred deep link integration, please contact us by email below and we will provide you with active support.
support-tracker@adbrixsupport.zendesk.com