Get Install ID

SDK Version Selection

Choose your SDK version below:

• Apptrove SDK → apptroveCordovaPlugin.getAppTroveId() (Recommended)
• Trackier SDK → trackierCordovaPlugin.getTrackierId() (Deprecating August 2026)

Use the tabs below for your chosen SDK.

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.

SDK	Method
Apptrove	apptroveCordovaPlugin.getAppTroveId()
Trackier	trackierCordovaPlugin.getTrackierId()

note

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

Usage

✓ Apptrove SDK (Recommended)

const installId = await this.apptroveCordovaPlugin.getAppTroveId();
console.log('Install ID:', installId);

AppTroveCordovaPlugin.getAppTroveId(function (installId) {
  console.log('Install ID:', installId);
});

Trackier SDK (Deprecating August 2026)

const installId = await this.trackierCordovaPlugin.getTrackierId();
console.log('Install ID:', installId);

TrackierCordovaPlugin.getTrackierId(function (installId) {
  console.log('Install ID:', installId);
});

Uninstall tracking (Firebase)

✓ Apptrove SDK (Recommended)

const installId = await this.apptroveCordovaPlugin.getAppTroveId();
await FirebaseAnalytics.setUserProperty({ name: 'ct_objectId', value: installId });

Trackier SDK (Deprecating August 2026)

const installId = await this.trackierCordovaPlugin.getTrackierId();
await FirebaseAnalytics.setUserProperty({ name: 'ct_objectId', value: installId });

Also see Uninstall Tracking.

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"
}

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

2. Uninstall tracking

Set Firebase ct_objectId to the install ID (examples above).

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 system	SDK
Login / account ID	setUserId
Install ID (tr_id)	apptroveCordovaPlugin.getAppTroveId() / trackierCordovaPlugin.getTrackierId()

Do not use the install ID alone as a lifelong account key.

Find it in the panel

1. Open Logs → Install Logs
2. Open an install
3. Copy the ID

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

Issue	Check
Empty ID	SDK not initialized, or called too early
S2S not matching	Confirm tr_id equals the SDK install ID

Support

• Email: support@apptrove.com
• S2S API: Post S2S Events