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
Steps to setup
1
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
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: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.- Android (Kotlin)
- iOS (Swift)
- React Native
- Flutter
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
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