Links
Track Android App Links and iOS Universal Links in your app using the React Native SDK
Android App Links and iOS Universal Links allow the links you send through Engagement to open directly in your mobile application without any redirects that would hinder your users' experience.
For details on how App Links and Universal Links work and how they can improve your users' experience, refer to the Universal Links section in the Campaigns documentation.
This page describes the steps required to track incoming App Links and Universal Links in your app using the React Native SDK.
Track App Links and Universal Links
Before you can track incoming links using the SDK, you must set up your application to be able to process said links. Follow the instructions in Linking in the official React Native documentation.
Once your app is able to process incoming links, you can use the SDK to track them to Engagement following the instructions for Android and iOS below.
When the application is opened by an App Link or Universal link while there is no session active, the newly started session will contain tracking parameters from the link.
Android
To track Android App Links to Engagement, you must add two methods to android/app/src/main/java/com/exponea/example/MainActivity.java
that will respond to incoming intents:
package com.exponea.example;
import android.content.Intent;
import android.os.Bundle;
import android.os.PersistableBundle;
import androidx.annotation.Nullable;
import com.exponea.ExponeaModule;
import com.facebook.react.ReactActivity;
public class MainActivity extends ReactActivity {
/**
* Returns the name of the main component registered from JavaScript. This is used to schedule
* rendering of the component.
*/
@Override
protected String getMainComponentName() {
return "example";
}
// Add following 2 methods:
@Override
protected void onCreate(Bundle savedInstanceState) {
ExponeaModule.Companion.handleCampaignIntent(getIntent(), getApplicationContext());
super.onCreate(savedInstanceState);
}
@Override
public void onNewIntent(Intent intent) {
ExponeaModule.Companion.handleCampaignIntent(intent, getApplicationContext());
super.onNewIntent(intent);
}
}
NOTE: Calling
ExponeaModule.Companion.handleCampaignIntent
is allowed before SDK initialization in case the SDK was previously initialized. In such a case,ExponeaModule.Companion.handleCampaignIntent
will track events with the configuration of the last initialization. Please consider to do SDK initialization inReactActivity::onCreate
before SDK initialization to apply a fresh configuration in case of an update of your application .
iOS
To track iOS Universal Links to Engagement, you must add an application:continueUserActivity:restorationHandler
function to your AppDelegate.m
file.
With ExponeaRNAppDelegate
If you have push notifications set up and your AppDelegate
already extends ExponeaRNAppDelegate
, it is sufficient to call the super method and the SDK will take care of the rest.
- (BOOL)application:(UIApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity
restorationHandler:(nonnull void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
[super application:application continueUserActivity:userActivity restorationHandler:restorationHandler];
return [RCTLinkingManager
application:application
continueUserActivity:userActivity
restorationHandler:restorationHandler];
}
Without ExponeaRNAppDelegate
If you don't use the ExponeaRNAppDelegate
, you must call the processing method directly.
#import <ExponeaRNAppDelegate.h>
...
...
- (BOOL)application:(UIApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity
restorationHandler:(nonnull void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
[Exponea continueUserActivity:userActivity];
return [RCTLinkingManager
application:application
continueUserActivity:userActivity
restorationHandler:restorationHandler];
}
Updated 26 days ago