CleverTap - Linkrunner

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

Get Credentials from CleverTap and Configure in Linkrunner

First, you need to get your credentials from CleverTap.

Refer to CleverTap’s API Quickstart Guide to get the Project ID, Project Token, and Project Passcode
Note your CleverTap Region (EU, IN, US, SG, SK, ID, or UAE)
In Linkrunner, navigate to Integrations from the left-hand panel
Under Analytics, click Configure for CleverTap
Enter your Project ID, Project Token, Project Passcode, and select your Region

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)
iOS (Swift)
React Native
Flutter

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)

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)

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: {},
});

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.

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:

Navigate to a user profile in the CleverTap dashboard
Look for the install events section
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

​How it works

​Example

​Prerequisites

​Steps to setup

​Viewing Attribution Data

How it works

Example

Prerequisites

Steps to setup

Viewing Attribution Data