Skip to main content
Linkrunner integrates with MoEngage 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 MoEngage 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 MoEngage, 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

RequirementDescription
Linkrunner accountA Linkrunner account is required to take advantage of this integration.
MoEngage accountA MoEngage account with API access.
iOS or Android appThis integration supports iOS and Android apps.
Linkrunner SDKYou must have the Linkrunner SDK installed in your app.

Steps to setup

1

Get Credentials from MoEngage and Configure in Linkrunner

First, you need to get your credentials from your MoEngage dashboard.
  1. Log in to your MoEngage Dashboard
  2. Navigate to Settings > Account > APIs using the left navigation menu
  3. Locate the Workspace ID: It is displayed under the Workspace ID (formerly known as App ID) section. You can use the copy icon to grab this unique identifier.
  4. Locate the Data API Key:
    • Scroll down to the API keys section on the same page
    • Find the Data tile
    • If you have not generated one yet, click Generate Key
    • Click the copy icon in the Data tile to copy your Data API Key
  5. In Linkrunner, navigate to Integrations from the left-hand panel
  6. Under Analytics, click Configure for MoEngage
  7. Enter your Workspace ID and Data API Key
2

Select Your Data Center

To find your data center, look at the URL in your browser tab when you’re on the MoEngage dashboard.For example, if your URL is https://dashboard-01.moengage.com/v4/#/settings-v2/accounts/api, then “01” is your data center.Select the appropriate data center based on your URL:
Data CenterRegion
DC-01US
DC-02EU
DC-03India
DC-04US
DC-05Singapore
DC-06Indonesia
3

Map User Identifiers in SDK

To properly link users between Linkrunner and MoEngage, you need to pass the user ID in the signup function.
Important: Make sure to pass the id in the userData parameter of the signup function of the SDK to match with your MoEngage user profiles.
import io.linkrunner.sdk.LinkRunner
import io.linkrunner.sdk.models.request.UserDataRequest

val userData = UserDataRequest(
    id = "123", // Your user ID (same as MoEngage user ID)
    // ...other user fields
)

LinkRunner.getInstance().signup(userData = userData)
4

Sync with MoEngage (Optional)

Use the Sync feature in the following scenarios:
  • First time after adding your MoEngage credentials
  • If you see discrepancies in attribution data on MoEngage profiles
To sync, click the Sync with MoEngage 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 MoEngage:
  1. Navigate to a user profile in the MoEngage dashboard
  2. Look for the user attributes section
  3. You’ll see lr_campaign and lr_ad_network attributes with the corresponding values
This data can be used to:
  • Create segments based on acquisition source
  • Personalize messaging based on campaign origin
  • Analyze user behavior by acquisition channel