User Management

Overview

Encore requires user identification to track entitlements and prevent abuse across devices. You can also set user attributes to enable targeted offers and personalization.

Anonymous Users

Encore automatically generates a random user ID that persists until the user deletes/reinstalls your app or calls reset(). This anonymous ID allows entitlement tracking to work immediately without requiring explicit user identification.

Identified Users

If you use your own user management system, call identify() when you have a user’s identity:

await Encore.identify(user.id);

This enables the SDK to:

Associate promotional access with your user account
Sync entitlements across devices when the user logs in
Track conversion attribution accurately

Resetting User Identity

When a user logs out, call reset():

await Encore.reset();

This will:

Reset the user ID to a new auto-generated anonymous ID
Clear cached entitlement data
Clear all user attributes

Your registered purchase controller survives reset(). It is build-time wiring, not user state, so logging a user out does not require re-registering it.

Setting User Attributes

Strongly recommended. Country and language already shape which offers a user is shown. Once you know who the user is, send what your app already knows, such as country and anything of your own in custom. Gender is accepted only from an app rated 18+ in its store listing, so leave it out otherwise.

import Encore, { type UserAttributes } from '@encorekit/react-native';

const attributes: UserAttributes = {
  countryCode: 'US',
  age: 25,
  custom: { signupSource: 'referral' },
};
await Encore.setUserAttributes(attributes);

Encore follows the device language. If your app has its own language picker, also call setLanguage with the user’s choice.

Only pass what you have a lawful basis to share, such as the user’s consent. Pass the user’s age in whole years as age, or their date of birth as dateOfBirth (YYYY-MM-DD), whichever your app has. The SDK works the age out on the device and never sends the date; given both, it uses the lower age. If you hold only a range, send its lowest end as age. A user under 18 is still served offers, from age-appropriate inventory only and with no per-user personalization. See Sending an age.

User attributes enable personalized offers, audience targeting, and conversion context tracking.

Usage

await Encore.setUserAttributes({
  email: 'user@example.com',
  subscriptionTier: 'premium',
  monthsSubscribed: '6',
  custom: {
    cancelReason: 'too_expensive',
  },
});

You can also set attributes when identifying:

await Encore.identify(user.id, {
  email: user.email,
  subscriptionTier: user.plan,
  monthsSubscribed: String(user.monthsActive),
});

Important: setUserAttributes() merges with existing attributes. It does not replace them.

See the SDK Reference for details: identify(), setUserAttributes(), and the full UserAttributes field list.

Implementation Examples

With useEncoreContext Hook

import { useEncoreContext } from '@encorekit/react-native';

function ProfileScreen() {
  const encore = useEncoreContext();

  const handleLogin = async (user) => {
    await encore.identify(user.id, {
      email: user.email,
      subscriptionTier: user.plan,
    });
  };

  const handleLogout = async () => {
    await encore.reset();
  };

  return (
    // ...
  );
}

If your app doesn’t require users to log in, no additional setup is needed:

// Anonymous users work automatically — just set attributes if needed
await Encore.setUserAttributes({
  custom: { cancelReason: 'too_expensive' },
});

Next Steps

Present Offers: present a reward sheet at a moment your user just earned, and read the result

iOS

Android

Web

Bridges

User Management

Overview

Anonymous Users

Identified Users

Resetting User Identity

Setting User Attributes

Usage

Implementation Examples

With useEncoreContext Hook

Next Steps

​Overview

​Anonymous Users

​Identified Users

​Resetting User Identity

​Setting User Attributes

​Usage

​Implementation Examples

​With useEncoreContext Hook

​Apps Without Login

​Next Steps

Overview

Anonymous Users

Identified Users

Resetting User Identity

Setting User Attributes

Usage

Implementation Examples

With useEncoreContext Hook

Apps Without Login

Next Steps