Cordova User Information

Set User Attributes (identified user)

Use setUserAttributes with required externalUserId:

RetenoPlugin.setUserAttributes({
  externalUserId: 'USER_ID',
  user: {
    userAttributes: {
      email: '[email protected]',
      phone: '+1234567890',
      firstName: 'John',
      lastName: 'Doe',
      languageCode: 'en',
      timeZone: 'Europe/Kyiv',
      marketId: 'market_1',
      address: {
        region: 'Kyivska',
        town: 'Kyiv',
        address: 'Khreshchatyk St, 1',
        postcode: '01001',
      },
      fields: [{ key: 'plan', value: 'premium' }],
    },
    subscriptionKeys: ['news', 'promotions'],
    groupNamesInclude: ['beta-testers'],
    groupNamesExclude: ['unsubscribed'],
  },
})
  .then(() => console.log('setUserAttributes: OK'))
  .catch((err) => console.error('setUserAttributes: ERROR', err));

📘
Note
When a user logs in to the app under a different External User Id, the device and its push token are re-linked to the contact with that identifier, and the previous contact loses this device and token. One contact can have multiple devices and receives push notifications on all of them.

Set Anonymous User Attributes

Use setAnonymousUserAttributes before user identification:

RetenoPlugin.setAnonymousUserAttributes({
  firstName: 'John',
  lastName: 'Doe',
  languageCode: 'en',
  timeZone: 'Europe/Kyiv',
  marketId: 'market_1',
  address: {
    region: 'Kyivska',
    town: 'Kyiv',
    address: 'Khreshchatyk St, 1',
    postcode: '01001',
  },
  fields: [{ key: 'utm_source', value: 'google' }],
})
  .then(() => console.log('setAnonymousUserAttributes: OK'))
  .catch((err) => console.error('setAnonymousUserAttributes: ERROR', err));

Note: anonymous attributes cannot include phone or email.

Multi-account Mode

Use setMultiAccountUserAttributes when one device should receive push for multiple accounts:

RetenoPlugin.setMultiAccountUserAttributes({
  externalUserId: 'user-123',
  user: {
    userAttributes: {
      email: '[email protected]',
      phone: '+1234567890',
      firstName: 'John',
      lastName: 'Doe',
      languageCode: 'en',
      timeZone: 'Europe/Kyiv',
      marketId: 'market_1',
    },
  },
})
  .then(() => console.log('setMultiAccountUserAttributes: OK'))
  .catch((err) => console.error('setMultiAccountUserAttributes: ERROR', err));

If you want default one-token-per-device behavior, switch back to setUserAttributes.

Market ID

marketId is supported by setUserAttributes, setAnonymousUserAttributes, and setMultiAccountUserAttributes starting with [email protected].

The value can contain up to 64 Latin letters, digits, hyphens (-), and underscores (_).
Pass an empty string to clear the existing value:

RetenoPlugin.setUserAttributes({
  externalUserId: 'USER_ID',
  user: {
    userAttributes: {
      marketId: '',
    },
  },
});

Omit marketId to keep the existing value unchanged.
The feature requires Reteno Android SDK 2.9.5+ or Reteno iOS SDK 2.7.1+. These versions are included in [email protected].

Notes

languageCode should follow RFC 5646 (de-AT, en, etc).
timeZone should be from TZ database (Europe/Kyiv, etc).
API payload types are available in plugin types.