From 6199da1cc6957b99b6482ba6e278b86fe46587ee Mon Sep 17 00:00:00 2001 From: Saksham Sharma Date: Mon, 5 Jan 2026 16:10:14 +0530 Subject: [PATCH 1/2] feat: add more info on meta install referrer --- ad-networks/meta-ads.mdx | 15 +++++++++++++++ sdk/android.mdx | 8 ++++++++ sdk/expo.mdx | 8 ++++++++ sdk/flutter.mdx | 8 ++++++++ sdk/react-native.mdx | 8 ++++++++ 5 files changed, 47 insertions(+) diff --git a/ad-networks/meta-ads.mdx b/ad-networks/meta-ads.mdx index 55fb995..1b13ca9 100644 --- a/ad-networks/meta-ads.mdx +++ b/ad-networks/meta-ads.mdx @@ -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. +## 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 diff --git a/sdk/android.mdx b/sdk/android.mdx index cbc7ce7..dbea361 100644 --- a/sdk/android.mdx +++ b/sdk/android.mdx @@ -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: @@ -235,6 +241,8 @@ private fun onSignup() { To get attribution data and deeplink information for the current installation, use the `getAttributionData` function: +For improved Android attribution tracking, especially with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). + ```kotlin val attributionDataResult = LinkRunner.getInstance().getAttributionData() attributionDataResult.onSuccess { attributionData -> diff --git a/sdk/expo.mdx b/sdk/expo.mdx index cf87a6e..ffc1eb4 100644 --- a/sdk/expo.mdx +++ b/sdk/expo.mdx @@ -75,6 +75,14 @@ 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). +For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). + +## 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 diff --git a/sdk/flutter.mdx b/sdk/flutter.mdx index 76cb767..29109b0 100644 --- a/sdk/flutter.mdx +++ b/sdk/flutter.mdx @@ -105,6 +105,8 @@ 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). +For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). + #### iOS Configuration 1. Update your iOS deployment target to iOS 15.0 or higher in your `ios/Podfile`: @@ -120,6 +122,12 @@ platform :ios, '15.0' This identifier will be used to deliver personalized ads and improve your app experience. ``` +## 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! diff --git a/sdk/react-native.mdx b/sdk/react-native.mdx index ebe32b1..7bd38f1 100644 --- a/sdk/react-native.mdx +++ b/sdk/react-native.mdx @@ -52,10 +52,18 @@ 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#backup-configuration). +For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). + ### Expo Support 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: From b061b06cdf4500d7cd2c8ddb0730a3cae710153d Mon Sep 17 00:00:00 2001 From: Saksham Sharma Date: Mon, 5 Jan 2026 16:19:16 +0530 Subject: [PATCH 2/2] feat: remove extra meta install referrer info --- sdk/android.mdx | 2 -- sdk/expo.mdx | 2 -- sdk/flutter.mdx | 2 -- sdk/react-native.mdx | 2 -- 4 files changed, 8 deletions(-) diff --git a/sdk/android.mdx b/sdk/android.mdx index dbea361..409abba 100644 --- a/sdk/android.mdx +++ b/sdk/android.mdx @@ -241,8 +241,6 @@ private fun onSignup() { To get attribution data and deeplink information for the current installation, use the `getAttributionData` function: -For improved Android attribution tracking, especially with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). - ```kotlin val attributionDataResult = LinkRunner.getInstance().getAttributionData() attributionDataResult.onSuccess { attributionData -> diff --git a/sdk/expo.mdx b/sdk/expo.mdx index ffc1eb4..ed3962d 100644 --- a/sdk/expo.mdx +++ b/sdk/expo.mdx @@ -75,8 +75,6 @@ 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). -For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). - ## Adding Store Referrer Libraries ### Meta Install Referrer diff --git a/sdk/flutter.mdx b/sdk/flutter.mdx index 29109b0..3052e6b 100644 --- a/sdk/flutter.mdx +++ b/sdk/flutter.mdx @@ -105,8 +105,6 @@ 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). -For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). - #### iOS Configuration 1. Update your iOS deployment target to iOS 15.0 or higher in your `ios/Podfile`: diff --git a/sdk/react-native.mdx b/sdk/react-native.mdx index 7bd38f1..ab2d0b7 100644 --- a/sdk/react-native.mdx +++ b/sdk/react-native.mdx @@ -52,8 +52,6 @@ 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#backup-configuration). -For improved Android attribution tracking with Meta ads, see the [Meta Install Referrer documentation](/features/meta-install-referrer). - ### Expo Support 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.