Braze

Linkrunner integrates with Braze 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 Braze to update the corresponding user’s profile with custom attributes:

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 Braze, for user profile with ID 24, you’ll see lr_campaign set to AXb1c2

The data will be visible in the Custom Attributes section of the user profile in the Braze dashboard.

Prerequisites

Requirement	Description
Linkrunner account	A Linkrunner account is required to take advantage of this integration.
Braze account	A Braze 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

Create API Key in Braze and Configure in Linkrunner

First, you need to create an API key in your Braze dashboard with the required permissions.

In your Braze dashboard, navigate to Settings > Setup and Testing > APIs and Identifiers > API Keys
Click Create API Key
Under permissions, select the following under User Data:
- users.track
- users.export.ids
Save the API key
Copy the API Key and REST Endpoint from the Braze dashboard
In Linkrunner, navigate to Integrations from the left-hand panel
Under Analytics, click Configure for Braze
Enter your API Key and REST Endpoint (e.g., https://rest.iad-01.braze.com)

Map User Identifiers in SDK

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

Important: If you are using the changeUser function of the Braze SDK, pass the same user ID in the userData parameter of the Linkrunner signup function. If you are not using changeUser, pass the brazeDeviceId instead.

Android (Kotlin)
iOS (Swift)
React Native
Flutter

import io.linkrunner.sdk.LinkRunner
import io.linkrunner.sdk.models.request.UserDataRequest

val userData = UserDataRequest(
    id = "123", // Your user ID
    // ...other user fields
    brazeDeviceId = "BRAZE_DEVICE_ID", // Required if not using changeUser
)

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

import Linkrunner

let userData = UserData(
    id: "123", // Your user ID
    // ...other user fields
    brazeDeviceId: "BRAZE_DEVICE_ID" // Required if not using changeUser
)

try await LinkrunnerSDK.shared.signup(userData: userData)

import linkrunner from "rn-linkrunner";

await linkrunner.signup({
    user_data: {
        id: "123", // Your user ID
        // ...other user fields
        braze_device_id: "BRAZE_DEVICE_ID", // Required if not using changeUser
    },
    data: {},
});

import 'package:linkrunner/main.dart';

await LinkRunner().signup(
  userData: LRUserData(
    id: '123', // Your user ID
    // ...other user fields
    brazeDeviceId: 'BRAZE_DEVICE_ID', // Required if not using changeUser
  ),
  data: {},
);

You can get the brazeDeviceId from the Braze SDK in your app.

Sync with Braze (Optional)

Use the Sync feature in the following scenarios:

First time after adding your Braze credentials
If you see any discrepancy in attributing profiles on Braze

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

Navigate to a user profile in the Braze dashboard
Look for the Custom Attributes section
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

Getting Started

SDK Guides

Core Features

Ad Networks

Analytics Integrations

API Reference

How it works

Example

Prerequisites

Steps to setup

Viewing Attribution Data

Getting Started

SDK Guides

Core Features

Ad Networks

Analytics Integrations

API Reference

​How it works

​Example

​Prerequisites

​Steps to setup

​Viewing Attribution Data

How it works

Example

Prerequisites

Steps to setup

Viewing Attribution Data