Skip to main content

User Identity

By default, Digia Engage attributes everything it records — impressions, clicks, dismissals, and survey submissions — to an anonymous device id. Digia.setUserId ties those events to a known user id from your app, so Digia's data lines up with the user you already identify elsewhere. Digia.clearUserId returns to anonymous, for logout.

info

User identity is a Digia Engage core SDK capability and behaves the same across React Native, Android, iOS, and Flutter — and across every integration, whether a CEP drives delivery or Digia runs its own campaigns.

What it affects​

Setting a user id changes how Digia attributes what it records — it does not change which campaigns fire:

  • Analytics — impressions, clicks and dismissals are recorded against the user id.
  • Survey submissions — responses are stamped with the user id, so results tie back to a known user instead of an anonymous device.
  • Session — setting or clearing the id starts a fresh analytics session.

Delivery is decided by a campaign's trigger (and, when present, by your CEP) — never by the id you set here. Treat this as attribution, not targeting or segmentation.

Identify a user after login​

Call setUserId once you know who the user is — typically right after login, and after Digia.initialize has run. Use the same id your backend and analytics already know the user by, so Digia's data joins cleanly with the rest of your stack.

Digia.setUserId('user-123');

Clear on logout​

Call clearUserId when the user logs out. Subsequent events return to the anonymous device id under a new session.

Digia.clearUserId();
info

On logout, also clear any retained inline content so a previous user's cards don't linger — see Managing Inline Content.

Alongside a CEP​

When a CEP (CleverTap, MoEngage, WebEngage) drives delivery, you already identify the user to that platform with its own login call — and that call governs the CEP's targeting. It does not reach Digia's analytics. Call Digia.setUserId alongside it so Digia's own impression, click, dismissal and survey data carry the same id, and the two line up.