Skip to main content

Get Install ID

SDK Version Selection

Choose your SDK version below:

  • Apptrove SDKAppTroveSDK.getAppTroveId() (Recommended)
  • Trackier SDKTrackierSDK.getTrackierId() (Deprecating August 2026)

Use the tabs below for your chosen SDK. Under Apptrove SDK, use Swift / Objective-C (Swift is default).

The install ID is a unique UUID the SDK creates on first launch and stores on the device. It identifies this app install (not your login user ID). Use it for S2S events (tr_id), uninstall tracking, support/QA matching, and joining first-party data.

SDKMethod
ApptroveAppTroveSDK.getAppTroveId()
TrackierTrackierSDK.getTrackierId()
note

Call this after SDK initialization. An empty value usually means the SDK has not created the ID yet.

Usage

import ApptroveSDK // or import apptrove_ios_sdk

// After AppTroveSDK.initialize(config:)
let installId = AppTroveSDK.getAppTroveId()
print("Install ID: \(installId)")
// Send to your backend for S2S tr_id

Use cases

1. Server-to-Server (S2S) events

Pass the install ID as tr_id on S2S Events:

{
"app_token": "abcf2270-XXXX-XXXX-XXXX-34903c6e1d53",
"tr_id": "5da45091-XXXX-XXXX-XXXX-b2a1587e0d8b",
"event_id": "sEMWSCTXeu"
}

tr_id must match getAppTroveId() / getTrackierId(). If omitted, send at least one of gaid, android_id, idfa, or idfv.

Flow: initialize SDK → read install ID → send to backend → backend uses it as tr_id.

2. Uninstall tracking

Use the install ID with APNs uninstall tracking or analytics pipelines as needed. See Uninstall Tracking (APNs).

3. Support and QA

Log the install ID, then search Logs → Install Logs in the panel by that ID.

4. Join with your user ID

Your systemSDK
Login / account IDsetUserID
Install ID (tr_id)getAppTroveId() / getTrackierId()

Do not use the install ID alone as a lifelong account key — it usually changes after reinstall.

Find it in the panel

  1. Open LogsInstall Logs
  2. Open an install
  3. Copy the ID — same value as the SDK method

Best practices

  • Initialize the SDK before reading the ID
  • Sync the ID to your backend when you need S2S
  • Expect a new ID after app reinstall

Troubleshooting

IssueCheck
Empty IDSDK not initialized, or called too early
S2S not matchingConfirm tr_id equals the SDK install ID
New ID after reinstallExpected behavior

Support