Attribution & deep links

Capture deep links, install referrers, deferred links, and SKAN context.

Last updated June 3, 2026

Capture mobile attribution from Grometrics managed deferred links, tagged deep links, Google Play Install Referrer, and privacy-preserving Apple SKAdNetwork postbacks. React Native resolves first-install campaign context without a third-party link provider.

Prerequisites

A mobile SDK installed
The app identifier saved in Grometrics Settings
The Grometrics Expo config plugin enabled
An Apple Team ID or Android signing fingerprint saved for verified app links

Steps

Tag the opening URL

React Native reads the initial URL and later Linking events automatically.

campaign-url

1myapp://offer?utm_source=meta&utm_medium=paid&utm_campaign=summer-sale-2026

Enable managed deferred links

Pass websiteId to the @grometrics/react-native Expo plugin, save the Apple Team ID or Android signing SHA-256 fingerprint in Grometrics Settings, then rebuild. Follow the managed deferred links guide to create and verify campaign links.

Handle the deferred destination

Pass onDeferredLink to createReactNativeTracker and route payload.url after your navigation container is ready. Grometrics still records attribution if navigation fails.

Rebuild Android for Play attribution

The React Native native package reads Google Play Install Referrer once and caches it for later app opens.

Enable Apple's postback endpoint

Add @grometrics/react-native to Expo plugins, then enter the numeric App Store ID in Grometrics Settings. Apple sends signed aggregate postbacks to Grometrics; SKAdNetwork does not expose a per-user campaign value to the app.

Configure native click IDs

Pass gclid, gbraid, or wbraid when creating the iOS, Android, or Flutter tracker. The native iOS SDK handles Apple Search Ads attribution separately.

Options / Configuration

Option	Type	Required	Description
url	string	no	Tagged opening or deferred URL
source	string	no	Ad network or source name
campaign	string	no	Campaign ID or UTM campaign

What happens next

Open Traffic Sources and confirm Install Sources or Deep Links show the attributed session.

Verify your setup

Open a Grometrics managed link with the app installedInstall before the first open and confirm the campaign in RealtimeConfirm Deep Links tab dataConfirm Direct still appears for unattributed opens

Troubleshooting

Everything is Direct

Confirm the app association value is saved in Settings, the Grometrics plugin includes the correct websiteId, and the managed link belongs to the same tracked app.

Was this page helpful?