Guide for setting Deeplink (Talking Data)

Article in Chinese (original)

 

Overview

DeepLink，aka deep activation link，can direct users from one App to another. In mobile advertising, it's mostly used for promotions targetting existing users. When the end-users click the ad they will be directed to the promoted App and enter the deep page(product page or promotion page). This reduces churn during page redirects and user activities.

 

Integration flow

Integration flow for Deeplink aimed to increase user activities:

SS of the settings page:

1. Goal
2. User acquisition
3. Increase activities
4. Both
5. Direct page
6. Please make sure this link and the uploaded explicit and implicit content are lawful and you are responsible for any possible illegal activities.
7. Please ask your tech team to set the above link in the Deeplink. Click to check the guide for it
8. I want to know the cost of my campaign and the cost per activation
9. save
10. save and create a new one

Brief description of the flow：

1. Tech team generates the deeplink, using Uri Scheme or Universal link 
2. Create a campaign on TalkingData AdTracking and choose the affiliate. Choose the goal Increase activities and generate Uri Scheme or Universal link with parameters, campaignid=XXXXXX
3. Put the Uri Scheme or Universal links with parameters on the pub side
4. Implement the ad tracking SDK to the app and call the AdTracking SDK Deeplink interface. Parameters in the link pass the Uri Scheme or Universal link with parameters.

 

Integration flow for Deeplink aimed to increase user activities and user acquisition:

SS of the settings page:

1. Goal
2. User acquisition
3. Increase activities
4. Both
5. Direct page
6. Click to copy the link
7. Please make sure this link and the uploaded explicit and implicit content are lawful and you are responsible for any possible illegal activities.
8. Please ask your tech team to set the above link in the Deeplink. Click to check the guide for it
9. Event postback for affiliates
10. Click tracking link
11. I want to know the cost of my campaign and the cost per activation
12. save
13. save and create a new one

Brief description of the flow：

1. Tech team generates deeplink, only universal link supported
2. Create campaigns on TalkingData AdTracking, choose affiliates, and the goal both. Get 2 links. one Universal link, like https://……?campaignid=XXXXXX and the other click tracking link, like https://lnk0.com/XXXXXX
3. Put the Universal link with campaign id on the field of promotion link/landing page/target URL on the affiliate side. And put the tracking link generated by AdTracking in the field of 3rd party tracking link on the affiliate side.
4. When the end-user clicks the ad, a universal link with campaignid=XXXXXX will be called to determine if he’s installed the app using the Universal link technology. Meanwhile, this click info will be sent to ad tracking separately.
5. New users will be led to download the app by the Universal link. When the app is opened, TD’s SDK will report activation data and match the activation data with the click info from the affiliate
6. Old user will be led to the app the Universal link, also calling AdTracking SDK Deeplink interface. The link parameter will be passed to the Universal link with parameters.

Settings for Engaging Old Users:

1. Reengagement
2. More details
3. Activation window
4. In this window, multiple opens from one device are considered as one activation and only the first open is valid. If you choose "none" every open will be counted
5. Valid activation
6. Standard
7. Custom
8. For the past ___ days, 
9. users who didn't _______ are considered as valid for activations.

After enabling Reengagement, you can change the settings for activation window and valid activation:

1. activation window：Within this window, multiple opens from one device is considered as one activation and only the first open is valid. If you choose "none" every open will be counted
2. valid activation：You can choose standard or custom based on your demand：

① standard：Activations brought by ad campaigns within the window you set are considered as valid.

② custom： WIthin today/last 3 days/last 7 days, Users that didn't open/log in/purchase are considered valid when open the app.

E.g. If you set the valid users as those who didn't open the app over the last 3 days, then users who opened the app over the last 3 days won't be counted for valid activations.

Solutions for passing parameters with DeepLink

Android:

Link for your reference：https://www.cnblogs.com/lovelyYakir/p/10363007.html

Sample code：

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "MainActivity" ;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        String action = getIntent().getAction();
        if (Intent.ACTION_VIEW.equals(action)) {
            Uri uri = getIntent().getData();
            if (uri != null) {
                // 完整的url信息
                String url = uri.toString();
                Log.e(TAG, "url: " + uri);
                // scheme部分
                String scheme = uri.getScheme();
                Log.e(TAG, "scheme: " + scheme);
                // host部分
                String host = uri.getHost();
                Log.e(TAG, "host: " + host);
                //port部分
                int port = uri.getPort();
                Log.e(TAG, "host: " + port);
                // 访问路劲
                String path = uri.getPath();
                Log.e(TAG, "path: " + path);
                List<String> pathSegments = uri.getPathSegments();
                // Query部分
                String query = uri.getQuery();
                Log.e(TAG, "query: " + query);
                //获取指定参数值,例如：
                String goodsId = uri.getQueryParameter("goodsId");
                Log.e(TAG, "goodsId: " + goodsId);
            }
        }
    }

IOS

Link for you reference：https://www.jianshu.com/p/c937875ed20e

Sample code：

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    NSString *scheme = url.scheme;
    NSString *host = url.host;
    NSString *query = url.query;
    if ([url.scheme isEqualToString:@"appB"]) {

        //deeplink跳转协议 :com.deeplink://deeplink.htm?id=123456 com.deeplink 代表就是设置的 Url Schemes =>example:appB://superman.com?target=shoppingvc
        //取出target跳转
        if (query.length) {
            NSString *targetVC = [query componentsSeparatedByString:@"="].lastObject;
            //targetVC是shoppingvc，shopping page是跳转到该页面时设置的标题
            NSString *pushURL = [NSString stringWithFormat:@"/%@/%@",targetVC,@"shopping page"];
            //使用VXRouter直接push到目标页面
            [[VXRouter shared] pushURLString:pushURL animated:YES];
            return YES;
        }
        return false;

    } 

    return false;
}

Tips:

1. When the activation is reported successfully, AdTracking will record the activation and attribute it to a certain affiliate based on campaign id in the link.
2. Conversions(registration/purchase) brought by activations a will be seen under campaign/affiliate stats
3. Differences between the URL scheme and universal link and suggested scenarios for usage

	Uri Scheme	Universal link
Flow for opening the app	click ad redirect to H5 page popup “open the link in XXX APP？“ ① Yes，then open the APP ② No，Stays in H5 page	click ad open the app directly
Restrictions	only for campaigns to increase user activities	Only for asynchronously tracking publishers.

You may also find the following articles helpful:

• Affise <-> Talking Data Mobile Attribution
• Guide For Integration With Ad Networks (Talking Data)
• Affiliate Management (Talking Data)
• Parameters for Custom Data Postback (Talking Data) 

Published by Tatiana Mankevich