Skip to content

feat: add more info on meta install referrer #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sakkshm26 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: add more info on meta install referrer #36

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6199da1
feat: add more info on meta install referrer
sakkshm26 Jan 5, 2026
b061b06
feat: remove extra meta install referrer info
sakkshm26 Jan 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions ad-networks/meta-ads.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -233,6 +233,21 @@ Users who install your app from this specific ad creative will be directed to th
example, if one ad features a specific product, you can deep link directly to that product page in your app.
</Tip>

## Getting Device-Level Data for Android Installs

### Google Play Install Referrer API

When Meta ad campaigns direct Android users to the Google Play Store, campaign attribution data becomes accessible through the Google Play Install Referrer API. Once you submit your [decryption key](/ad-networks/meta-ads#step-2-get-your-referrer-decryption-key) and Linkrunner successfully attributes an install to Meta campaigns, this data appears in the Linkrunner dashboard.

### Meta Install Referrer

Beyond the Google Play Install Referrer API, Linkrunner supports Meta's install referrer feature, which retrieves campaign metadata directly from the device's local storage for enhanced attribution accuracy. Here are the key advantages of Meta install referrer compared to the Google Play API:

- **Broader data capture**: Meta install referrer includes both impression and click data, while Google Play Install Referrer is restricted to click data only
- **Multi-session support**: Unlike Google Play Install Referrer which only captures the most recent session's data, Meta install referrer can access information from multiple user sessions. The decryption key used here is identical to the one required for Google Play Install Referrer integration.

For setup instructions for Meta install referrer, refer to the [Meta Install Referrer documentation](/features/meta-install-referrer).

## Troubleshooting

### Events Not Showing Up in Meta
Expand Down
6 changes: 6 additions & 0 deletions sdk/android.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -187,6 +187,12 @@ For enhanced security, the LinkRunner SDK requires the following signing paramet

You can find your project token, secret key, and key ID [here](https://dashboard.linkrunner.io/settings?s=sdk-signing).

## Adding Store Referrer Libraries

### Meta Install Referrer

For improved Android attribution tracking with Meta ads, integrate the Meta install referrer library. See the [Meta Install Referrer documentation](/features/meta-install-referrer) for setup instructions.

## User Registration

Call the `signup` method once after the user has completed your app's onboarding process:
Expand Down
6 changes: 6 additions & 0 deletions sdk/expo.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,12 @@ For Android apps, the SDK provides backup rules to exclude Shared Preferences da

For detailed backup configuration instructions, please refer to the [Android SDK Backup Configuration](/sdk/android/installation#backup-configuration).

## Adding Store Referrer Libraries

### Meta Install Referrer

For improved Android attribution tracking with Meta ads, integrate the Meta install referrer library. See the [Meta Install Referrer documentation](/features/meta-install-referrer) for setup instructions.

## SDK Usage

<Note>
Expand Down
6 changes: 6 additions & 0 deletions sdk/flutter.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,12 @@ platform :ios, '15.0'
<string>This identifier will be used to deliver personalized ads and improve your app experience.</string>
```

## Adding Store Referrer Libraries

### Meta Install Referrer

For improved Android attribution tracking with Meta ads, integrate the Meta install referrer library. See the [Meta Install Referrer documentation](/features/meta-install-referrer) for setup instructions.

## Initialization

You'll need your [project token](https://dashboard.linkrunner.io/dashboard?m=documentation) to get started!
Expand Down
6 changes: 6 additions & 0 deletions sdk/react-native.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,12 @@ For detailed backup configuration instructions, please refer to the [Android SDK

If you are using Expo, follow the above steps to install the required packages. After this, you will need to use development builds since the Linkrunner SDK relies on native libraries. Follow the [Expo Development Builds Documentation](https://docs.expo.dev/develop/development-builds/introduction/) to get started.

## Adding Store Referrer Libraries

### Meta Install Referrer

For improved Android attribution tracking with Meta ads, integrate the Meta install referrer library. See the [Meta Install Referrer documentation](/features/meta-install-referrer) for setup instructions.

## Initialization

To initialize the Linkrunner SDK, add this code to your `App.tsx` component:
Expand Down