CleverTap

Connect Linkrunner with CleverTap to import attribution data and understand your user acquisition campaigns

Linkrunner integrates with CleverTap to automatically send attribution data, helping you understand which campaigns are driving user acquisition and engagement.

How it works

Every time a user is attributed by Linkrunner, we send an install event to CleverTap’s attribution API for the corresponding user profile. The profile is matched using the CleverTap ID you pass to the Linkrunner SDK (see Map User Identifiers).

The event carries these attribution fields:

Field	Description
event_type	organic_install or inorganic_install, depending on whether the install was attributed to a campaign.
utm_source	The acquisition source. For inorganic installs this is the ad network (for example meta, google, or tiktok). For organic installs this is organic.
utm_campaign	The campaign name. Sent only for inorganic installs.
platform	android or ios.
timestamp	When the install occurred.

Example

• User came from a Meta campaign named Summer_Sale
• In CleverTap, that user’s profile receives an inorganic_install event with utm_source set to meta and utm_campaign set to Summer_Sale
• An unattributed user instead receives an organic_install event with utm_source set to organic

Prerequisites

Requirement	Description
Linkrunner account	A Linkrunner account is required to take advantage of this integration.
CleverTap account	A CleverTap account with API access.
iOS or Android app	This integration supports iOS and Android apps.
Linkrunner SDK	You must have the Linkrunner SDK installed in your app.

Steps to setup

1. Get Credentials from CleverTap and Configure in Linkrunner

   First, you need to get your credentials from CleverTap.

   1. Refer to CleverTap’s API Quickstart Guide to get the Project ID, Project Token, and Project Passcode

   2. Note your CleverTap Region (EU, IN, US, SG, SK, ID, or UAE)

   3. In Linkrunner, navigate to Integrations from the left-hand panel

   4. Under Analytics, click Configure for CleverTap

   5. Enter your Project ID, Project Token, Project Passcode, and select your Region

2. Map User Identifiers in SDK

   To properly link users between Linkrunner and CleverTap, you need to pass the CleverTap ID in the signup function.

   Important: Make sure to use CleverTap’s functions correctly to retrieve the CleverTap ID and send it to the Linkrunner SDK.

   Android (Kotlin)

   import io.linkrunner.sdk.LinkRunner
   import io.linkrunner.sdk.models.request.UserDataRequest
   
   val userData = UserDataRequest(
       id = "123", // Your user ID
       // ...other user fields
       clevertapId = "CLEVERTAP_ID", // Get from CleverTap SDK
   )
   
   LinkRunner.getInstance().signup(userData = userData)
   

   iOS (Swift)

   import Linkrunner
   
   let userData = UserData(
       id: "123", // Your user ID
       // ...other user fields
       clevertapId: "CLEVERTAP_ID" // Get from CleverTap SDK
   )
   
   try await LinkrunnerSDK.shared.signup(userData: userData)
   

   React Native

   import linkrunner from "rn-linkrunner";
   
   await linkrunner.signup({
       user_data: {
           id: "123", // Your user ID
           // ...other user fields
           clevertap_id: "CLEVERTAP_ID", // Get from CleverTap SDK
       },
       data: {},
   });
   

   Flutter

   import 'package:linkrunner/main.dart';
   
   await LinkRunner().signup(
     userData: LRUserData(
       id: '123', // Your user ID
       // ...other user fields
       clevertapId: 'CLEVERTAP_ID', // Get from CleverTap SDK
     ),
     data: {},
   );
   

   You can get the CleverTap ID from the CleverTap SDK in your app using the appropriate method for your platform.

3. Sync with CleverTap (Optional)

   Use the Sync feature in the following scenario:

   • If you see discrepancies in attribution data on Clevertap profiles

   To sync, click the Sync with CleverTap button in the Linkrunner integration settings. This process may take a while depending on the number of users.

Viewing Attribution Data

After the integration is complete, you can view the attribution data in CleverTap:

1. Navigate to a user profile in the CleverTap dashboard
2. Look for the install events section
3. You’ll see an organic_install or inorganic_install event with the utm_source, utm_campaign, and platform values described above

This data can be used to:

• Create segments based on acquisition source
• Personalize messaging based on campaign origin
• Analyze user behavior by acquisition channel