Skip to main content

Deferred Deep Linking

SDK Version Selection

Choose your SDK version below:

  • Apptrove SDK → Recommended for all projects (Latest: v2.0.0)
  • Trackier SDK → Will be deprecated in May 2026 (v1.x.xx)

Use the tabs below to view deferred deep linking code for your chosen SDK.

Deferred deep linking happens when a user clicks a Apptrove URL but doesn't have your app installed. The URL redirects to the app store, and when the user installs and opens the app, the SDK retrieves the deep link data.

note

For iOS Only: To enable deferred deep link functionality on iOS, you need to call the subscribeAttributionlink() method after initialization. This allows our server to send the attributed data parameters to the app. For Android, deferred deep linking works automatically without this call.

Implementation​

App.js
import React, { useEffect } from 'react';
import { Platform } from 'react-native';
import { ApptroveSDK, ApptroveConfig } from 'react-native-apptrove';

const App = () => {
  useEffect(() => {
    initializeSDK();
  }, []);

  const initializeSDK = () => {
    const sdkConfig = new ApptroveConfig('YOUR_SDK_KEY', 'production');
    sdkConfig.setDeferredDeeplinkCallbackListener(function(deepLinkData) {
      console.log("Deferred Deeplink Callback received");
      console.log("DeepLink Data: " + JSON.stringify(deepLinkData));
      console.log("URL: " + deepLinkData.url);
      console.log("Is Deferred: " + deepLinkData.isDeferred);
      console.log("Deep Link Value: " + deepLinkData.deepLinkValue);
      console.log("Partner ID: " + deepLinkData.partnerId);
      console.log("Campaign: " + deepLinkData.campaign);
      console.log("P1-P5: " + deepLinkData.p1, deepLinkData.p2, deepLinkData.p3, deepLinkData.p4, deepLinkData.p5);
      if (deepLinkData.sdkParams) console.log("SDK Parameters: " + JSON.stringify(deepLinkData.sdkParams));
      handleDeepLink(deepLinkData);
    });
    ApptroveSDK.initialize(sdkConfig);
    if (Platform.OS === 'ios') {
      ApptroveSDK.subscribeAttributionlink();
    }
  };

  const handleDeepLink = (deepLinkData) => {
    console.log('Handling deep link with data:', deepLinkData);
    if (deepLinkData.deepLinkValue) {
      switch (deepLinkData.deepLinkValue) {
        case 'product': navigateToProduct(deepLinkData.campaign, deepLinkData.p1); break;
        case 'profile': navigateToProfile(deepLinkData.p1); break;
        default: navigateToHome();
      }
    }
  };

  const navigateToProduct = (campaign, productId) => { console.log(`Navigating to product: ${productId} from campaign: ${campaign}`); };
  const navigateToProfile = (userId) => { console.log(`Navigating to profile: ${userId}`); };
  const navigateToHome = () => { console.log('Navigating to home screen'); };

  return (/* Your app components */);
};

The enhanced callback provides a comprehensive data object with the following structure:

{
  url: "https://trackier58.u9ilnk.me/d/NKmWH9E7b1",
  isDeferred: true,
  deepLinkValue: "product",
  partnerId: "12345", 
  campaign: "summer_sale",
  p1: "param1_value",
  p2: "param2_value",
  p3: "param3_value", 
  p4: "param4_value",
  p5: "param5_value",
  sdkParams: {
    "custom_key": "custom_value",
    "user_id": "user123"
  }
}

Properties:

  • url: Original deep link URL
  • isDeferred: Boolean indicating deferred deep link
  • deepLinkValue: Custom value for navigation logic
  • partnerId: Attribution partner ID
  • campaign: Campaign name
  • p1-p5: Custom parameters
  • sdkParams: Additional SDK parameters (object)

Testing​

Android Testing​

  1. Prepare APK: Build APK with SDK integration
  2. Click Link: Open test URL in browser - redirects to Play Store
  3. Install APK: Install APK manually (not from Play Store)
  4. Launch App: Open app - deferred deep link should be processed

iOS Testing​

  1. Prepare IPA: Build IPA with SDK integration
  2. Click Link: Open test URL in Safari - redirects to App Store
  3. Install App: Install via TestFlight or direct installation
  4. Launch App: Open app - deferred deep link should be processed

Example Test URL:

https://yourdomain.u9ilnk.me/d/Af2xeLPI77?pid=Ron+Media+Source&cost_value=0&cost_currency=GBP&lbw=1d&camp=Ron+Referral+Test&dlv=RonTestClass&p2=param_2_value&sdk_param=sdk_param_value

Common Issues​

IssueSolution
No app store redirectCheck Store Redirect in Apptrove Panel
Deep link callback not triggeredEnsure setDeferredDeeplinkCallbackListener() is called before SDK initialization
Missing deep link data propertiesVerify URL includes required parameters and SDK version is 1.6.78+
SDK parameters not receivedCheck if sdkParams object exists before accessing properties
Navigation not workingImplement proper null checks for deep link data properties

Enhanced Debugging:

// Add comprehensive logging for debugging
sdkConfig.setDeferredDeeplinkCallbackListener(function(deepLinkData) {
  if (!deepLinkData) {
    console.log("No deep link data received");
    return;
  }
  
  console.log("=== Deep Link Debug Info ===");
  console.log("Full Data:", JSON.stringify(deepLinkData, null, 2));
  console.log("Has URL:", !!deepLinkData.url);
  console.log("Has Deep Link Value:", !!deepLinkData.deepLinkValue);
  console.log("Has SDK Params:", !!deepLinkData.sdkParams);
  console.log("========================");
});

For further assistance, contact support at support@apptrove.com.