Skip to content

Uninstall tracking ​

When enabled, the SDK sets chrome.runtime.setUninstallURL() to a Moderok URL so an uninstall can be attributed to the same anonymous user.

js
Moderok.init({
  appKey: "mk_your_app_key",
  trackUninstalls: true,
  uninstallUrl: "https://yoursite.com/goodbye",
});
  • trackUninstalls: turn the feature on.
  • uninstallUrl (optional): where to send the user after the ping, if your server supports it.

The uninstall URL length limit in Chrome is 1023 characters. If the built URL is too long, the SDK logs a warning when debug: true.

If you do not need uninstall attribution, leave trackUninstalls off (default).

Why some uninstalls are missing ​

Chrome reports an uninstall by opening the uninstall URL in a new tab. It only does that when someone removes the extension in the browser, and the report only gets through if the browser is online at that moment.

These removals are never reported:

  • The browser is offline when the extension is removed.
  • Chrome itself is uninstalled, or the Chrome profile is deleted.
  • A managed Chromebook wipes its profile at sign-out.
  • An admin policy removes the extension.

So the Uninstalls chart is a floor: the real number is higher. Net installs and the Still installed share read a little high for the same reason.