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 identifierlr_ad_network- The ad network source
Example
- User ID
24came from campaign link:https://app.linkrunner.io/?c=AXb1c2 - In MoEngage, for user profile with ID
24, you’ll seelr_campaignset toAXb1c2andlr_ad_networkset to an ad network source
Prerequisites
| Requirement | Description |
|---|---|
| Linkrunner account | A Linkrunner account is required to take advantage of this integration. |
| MoEngage account | A MoEngage 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 MoEngage and Configure in Linkrunner
First, you need to get your credentials from your MoEngage dashboard.
- Log in to your MoEngage Dashboard
- Navigate to Settings > Account > APIs using the left navigation menu
- 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.
-
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
- In Linkrunner, navigate to Integrations from the left-hand panel
- Under Analytics, click Configure for MoEngage
- Enter your Workspace ID and Data API Key
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 Center | Region |
|---|---|
| DC-01 | US |
| DC-02 | EU |
| DC-03 | India |
| DC-04 | US |
| DC-05 | Singapore |
| DC-06 | Indonesia |
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.- Android (Kotlin)
- iOS (Swift)
- React Native
- Flutter
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
Viewing Attribution Data
After the integration is complete, you can view the attribution data in MoEngage:- Navigate to a user profile in the MoEngage dashboard
- Look for the user attributes section
- You’ll see
lr_campaignandlr_ad_networkattributes with the corresponding values
- Create segments based on acquisition source
- Personalize messaging based on campaign origin
- Analyze user behavior by acquisition channel







