How to use Self-Deeplink

Overview

This is an integration guide for Self-Deeplinking. You can directly create your own deep-links for ‘App Open’ and ‘Market Landing’ if you choose not to use adbrix tracking link. Since you have to fulfill what adbrix SDK can do, following should be fulfilled for the smooth operation of the links.

1. Create Tracking link
   
   1. Tracking link format
   2. Landing URL Setup
2. Modify Deeplinking page
   1. Get abx_tid
   2. Send abx_tid to App

Create Tracking link

To create ‘Self-Deeplink’, you must create tracking links utilizing special settings.

Set tracking link format

Set tracking link format as "Download"

Set Landing URL

Type in the URL of the page which you would like to substitute the deeplinking of adbrix.

Modify Deeplinking page

The attribution of adbrix activates based on the ‘abx_tid’ token generated for each click. That means SDK should be able to check the ‘abx_tid’ value when there is ‘App Open’ after the market install or deep-link open. Refer to the following information to modify the deep-link processing page to transmit the ‘abx_tid’ value for the cases of market landing and deep-link open.

Get abx_tid

When user clicks the tracking link ‘abx_tid’ will be attached to landing URL which you set on tracking link.

<!--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 get ‘abx_tid’ with the following script at the address of landing URL.

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();

Send abx_tid to app

After you get ‘abx_tid’ from the landing URL please add ‘abx_tid’ to Google play URL or deeplink URL.

For Google Play URL please add "&referrer=abx_tid" with url.

<!--  Google Play URL : market://details?id=com.my.package_name -->
market://details?id=com.my.package_name&referrer=abx_tid%3D1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db

If you open the app with deeplink add abx_tid.

<!-- Deeplink URL : scheme://host?myparam=data -->
scheme://host?myparam=data&abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db