Amplitude

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

Linkrunner integrates with Amplitude 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 a request to Amplitude to update the corresponding user’s profile with custom properties:

• lr_campaign - The campaign identifier
• lr_ad_network - The ad network source

Example

• User ID 24 came from campaign link: https://app.linkrunner.io/?c=AXb1c2
• In Amplitude, for user profile with ID 24, you’ll see lr_campaign set to AXb1c2 and lr_ad_network set to an ad network source

Prerequisites

Requirement	Description
Linkrunner account	A Linkrunner account is required to take advantage of this integration.
Amplitude account	An Amplitude 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. Create API Key in Amplitude and Configure in Linkrunner

   First, you need to get your API key from your Amplitude dashboard.

   1. In your Amplitude dashboard, navigate to Settings > Projects > API Keys

   2. Copy your API Key

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

   4. Under Analytics, click Configure for Amplitude

   5. Enter your API Key

2. Map User Identifiers in SDK

   To properly link users between Linkrunner and Amplitude, you need to pass the correct identifier in the signup function.

   Important: If you are using the identify function of the Amplitude SDK to set a user ID, pass the same user ID in the userData parameter of the Linkrunner signup function. If you are not using identify, pass the distinct_id or device_id instead.

   Android (Kotlin)

   import io.linkrunner.sdk.LinkRunner
   import io.linkrunner.sdk.models.request.UserDataRequest
   
   val userData = UserDataRequest(
       id = "123", // Your user ID (same as Amplitude identify)
       // ...other user fields
       amplitudeDeviceId = "AMPLITUDE_DEVICE_ID", // Required if not using identify
   )
   
   LinkRunner.getInstance().signup(userData = userData)
   

   iOS (Swift)

   import Linkrunner
   
   let userData = UserData(
       id: "123", // Your user ID (same as Amplitude identify)
       // ...other user fields
       amplitudeDeviceId: "AMPLITUDE_DEVICE_ID" // Required if not using identify
   )
   
   try await LinkrunnerSDK.shared.signup(userData: userData)
   

   React Native

   import linkrunner from "rn-linkrunner";
   
   await linkrunner.signup({
       user_data: {
           id: "123", // Your user ID (same as Amplitude identify)
           // ...other user fields
           amplitude_device_id: "AMPLITUDE_DEVICE_ID", // Required if not using identify
       },
       data: {},
   });
   

   Flutter

   import 'package:linkrunner/main.dart';
   
   await LinkRunner().signup(
     userData: LRUserData(
       id: '123', // Your user ID (same as Amplitude identify)
       // ...other user fields
       amplitudeDeviceId: 'AMPLITUDE_DEVICE_ID', // Required if not using identify
     ),
     data: {},
   );
   

   You can get the amplitudeDeviceId from the Amplitude SDK in your app.

3. Sync with Amplitude (Optional)

   Use the Sync feature in the following scenarios:

   • First time after adding your Amplitude API Key
   • If you see discrepancies in attribution data on Amplitude profiles

   To sync, click the Sync with Amplitude 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 Amplitude:

1. Navigate to a user profile in the Amplitude dashboard
2. Look for the user properties section
3. You’ll see lr_campaign and lr_ad_network attributes with the corresponding values

This data can be used to:

• Create cohorts based on acquisition source
• Personalize experiences based on campaign origin
• Analyze user behavior by acquisition channel