Android App Links

When you use Android App Links in your messages, users can tap a link to your website and get seamlessly redirected to your installed app without going through a browser, all while having the links tracked within Iterable.

# Table of contents

# Setup

# 1. Enable App Links

• Set up your application to enable App Links via the instructions here.
• Create Intent Handlers for URIs
• Generate the assetlinks.json file

# 2. Upload assetlinks.json

• After you generate the assetlinks.json file with your app's fingerprint, the .well-known/assetlinks.json file will need to be hosted by Iterable, so you can send it to us by email.
• Once the assetlinks.json file has been uploaded, you can test it out via the Statement List Generator and Tester.

# 3. Determine which links to rewrite

• Iterable re-writes links defined by your uploaded apple-app-site-association file. See iOS Universal Links Setup to learn how to set up that file.

# 4. Set up the track and get redirect call

For App Links to work with link rewriting in emails, you need to set up an assetlinks.json file in the Iterable project.

If you already have a urlHandler, you can use the same handler can be used for email deep links by calling handleAppLink in the activity that handles all app links in your app:

// MainActivity.java
@Override
public void onCreate() {
    super.onCreate();
    ...
    handleIntent(getIntent());
}

@Override
public void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    if (intent != null) {
        handleIntent(intent);
    }
}

private void handleIntent(Intent intent) {
    if (Intent.ACTION_VIEW.equals(intent.getAction()) && intent.getData() != null) {
        IterableApi.handleAppLink(intent.getDataString());
        // Overwrite the intent to make sure we don't open the deep link
        // again when the user opens our app later from the task manager
        setIntent(new Intent(Intent.ACTION_MAIN));
    }
}

Alternatively, call getAndTrackDeeplink along with a callback to handle the original deep link URL. You can use this method for any incoming URLs, as it will execute the callback without changing the URL for non-Iterable URLs.

IterableApi.getAndTrackDeeplink(uri, new IterableHelper.IterableActionHandler() {
    @Override
    public void execute(String result) {
        Log.d("HandleDeeplink", "Redirected to: "+ result);
        // Handle the original deep link URL here
    }
});

# FAQ

For answers to common questions about deep links, read the Deep Link FAQs.