Install attribution

Track exactly which ad, campaign, or channel drove each app install — with deterministic accuracy on both Android and iOS. On Android, Nohmo embeds a click UUID in the Play Store referrer param. On iOS, the click-link interstitial writes the UUID to the system pasteboard, which the SDK reads on first open.

How it works

1

Ad click

User clicks your tracking link (built in Settings → App). Nohmo records the click with full UTM data and assigns it a UUID.

2

Store redirect

Android: Nohmo redirects to your Play Store URL with the UTMs + click UUID embedded in the referrer param — Google Play preserves this on first open. iOS: Nohmo serves an interstitial page that writes the click UUID to the system pasteboard, then redirects to the App Store.

3

App install & open

On first open, the Nohmo SDK reads the attribution token automatically — the Play Store referrer on Android, or the system pasteboard on iOS — and sends it to the backend for matching.

4

Deterministic match

The backend finds the exact click record by UUID — 100% accurate, no GAID or fingerprinting needed. The install is attributed and the data appears in App Analytics.

Setup (1 step)

Step 1 — Add your Play Store / App Store URL

Go to Settings → App → Store URLs in your Nohmo dashboard and paste your Google Play and App Store URLs.

Note: That's the entire setup. Install attribution is built into the Nohmo SDK — no extra packages required. The SDK reads the Play Store referrer automatically on Android and the system pasteboard on iOS. All other tracking works normally on both platforms regardless of whether the install came from an attribution link.

Build a tracking link

Go to Settings → App setup → Attribution Link Builder, fill in your UTM fields, and copy the generated link. Use this link as the destination URL in your Meta Ads, Google Ads, or any other channel.

bash
# Example generated link
https://www.nohmo.in/api/click/<project-code>/?utm_source=facebook&utm_medium=cpc&utm_campaign=summer_sale

When a user clicks this link, Nohmo records the click and redirects them to your Play Store URL with the referrer embedded:

bash
https://play.google.com/store/apps/details?id=com.yourapp&referrer=utm_source%3Dfacebook%26utm_campaign%3Dsummer_sale%26nohmo_click%3D<uuid>

Click Save & shorten to store the link and get a tidy short URL (https://www.nohmo.in/api/l/<code>) you can reuse from the Saved links list.

Invite a friend (referral attribution)

To attribute installs from in-app sharing back to the user who shared, share a Nohmo link instead of the raw store URL. buildInviteLink()returns a short link that carries the current user's id — so you can see exactly who referred whom.

tsx
import { Share } from 'react-native'
import { useNohmo } from 'nohmo/react-native'
function InviteButton() {
const { buildInviteLink } = useNohmo()
const invite = async () => {
const link = await buildInviteLink({ channel: 'whatsapp' })
// → https://www.nohmo.in/api/l/aB3xK9q
await Share.share({ message: `Join me on the app! ${link}` })
}
return <Button title="Invite a friend" onPress={invite} />
}

Call linkUser() first — the sharer's id is captured as utm_content. The helper returns a short URL; the same user + options always resolves to the same code (and it's cached, so repeated shares never create duplicates). Options: channel → utm_medium, campaign → utm_campaign, source → utm_source (defaults to referral).

Note: When the invitee installs through the link, their device's attribution shows the sharer's id — deterministic on Android (Play Install Referrer), best-effort on iOS (pasteboard when they tap through the click interstitial, probabilistic otherwise). Requires your iOS App Store URL set in Settings → App setup. Results appear in App Analytics → Install Attribution and on each device's "Came from" card.

Attribution priority

PriorityMethodAccuracy
1 (Android)nohmo_click UUID in Play Store referrer100% deterministic
1 (iOS)nohmo_click UUID in system pasteboard100% deterministic
2GAID / IDFA match within 30 daysDeterministic
3UTM params in referrer (no click ID)High
4IP + platform match within 24hProbabilistic (~70%)
5No matchOrganic

View results

Attribution data appears in App Analytics → Install Attribution with breakdowns by source, campaign, and match type. Each install is labelled as attributed or organic.

Note: On iOS, the Nohmo click-link page writes a token to the system pasteboard when the user taps the link. The SDK reads and clears it on first open — this is deterministic, not fingerprinting. iOS 14+ shows a brief "Pasted from Safari" banner on the very first open for attributed installs; this is expected and cannot be suppressed (it is Apple's privacy disclosure, not an error).