> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkrunner.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 automatically send an organic or inorganic install event to CleverTap for the corresponding user profile.

## 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](/introduction) installed in your app. |

## Steps to setup

<Steps>
  <Step title="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](https://developer.clevertap.com/docs/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**
  </Step>

  <Step title="Map User Identifiers in SDK">
    To properly link users between Linkrunner and CleverTap, you need to pass the CleverTap ID in the `signup` function.

    <Info>
      **Important:** Make sure to use CleverTap's functions correctly to retrieve the CleverTap ID and send it to the Linkrunner SDK.
    </Info>

    <Tabs>
      <Tab title="Android (Kotlin)">
        ```kotlin theme={null}
        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)
        ```
      </Tab>

      <Tab title="iOS (Swift)">
        ```swift theme={null}
        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)
        ```
      </Tab>

      <Tab title="React Native">
        ```javascript theme={null}
        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: {},
        });
        ```
      </Tab>

      <Tab title="Flutter">
        ```dart theme={null}
        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: {},
        );
        ```
      </Tab>
    </Tabs>

    <Tip>
      You can get the CleverTap ID from the CleverTap SDK in your app using the appropriate method for your platform.
    </Tip>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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 organic or inorganic install events with attribution data

This data can be used to:

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