Install Attribution API

Asks Nohmo which campaign an app install came from. Send whatever identifiers the platform gave you; the response tells you how confident the match is.

POST /api/tracker/attribute/

bash

curl -X POST https://www.nohmo.in/api/tracker/attribute/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pk_xxxx" \
  -d '{
    "deviceId": "a1b2c3d4...",
    "platform": "android",
    "installReferrer": "utm_source=google&utm_campaign=spring",
    "gaid": "38400000-8cf0-11bd-b23e-10b96e40000d"
  }'

Field	Required	Description
deviceId	✓	The installing device
platform	—	ios or android
installReferrer	—	Android Play Install Referrer string — the strongest signal available
gaid	—	Google Advertising ID (Android)
idfa	—	Identifier for Advertisers (iOS), only if the user granted tracking permission

Response

json

{
  "success": true,
  "data": {
    "attributed": true,
    "matchType": "referrer",
    "source": "google",
    "medium": "cpc",
    "campaign": "spring",
    "term": null,
    "content": null
  }
}

Note: attributed is false for an organic install. matchType tells you how it was matched — a deterministic referrer match is trustworthy, a probabilistic one is a best guess, so do not treat them as the same number in a report.

Status	Meaning
400	Invalid JSON, or deviceId missing
401	API key missing or invalid
404	No device with that deviceId in this project