What is the importance of the data provided in the API’s registration endpoint?

PARTNERS INTEGRATIONS

When you register accounts in the CoginFit platform (https://cognifitapiv2.docs.apiary.io/#reference/0/user-registration/create-new-user-account ) you must provide several values:

  1. first_name [required]: this is used only to greet the user before the perform an assessment. The system can be configured to not show this screen, so if you don’t have or don’t want to store the user’s real name, you can simply input a non-empty string;
  2. email [required]: this is the main identifier in the CogniFit platform. If you don’t have or don’t want to provide the user’s email address you can simply provide an UID that looks like an email. For example: ABDCEF_123456@cognifit.yourdomain.com

You must guarantee that the emails are unique.
If you send the user’s email address you must be prepared for the case where the user is already registered with CogniFit. In this scenario the user will be asked if they want to associate their CogniFit account with yours and the services you provide (see https://cognifitapiv2.docs.apiary.io/#reference/0/user-registration/associate-existing-user-account ).

  1. password [required]: must be provided, even if it’ll never be used.
  2. birthday [required]: this is a very important value because it has a major impact on the cognitive scores. Each task in the CogniFit platform measures from dozens to hundreds of data points and the user’s age is used to compute their cognitive score. As a very simplified example: a reaction time of 350ms does not have the same meaning if the user is 20 or 80 years old.
  3. sex [optional]: CogniFit does adjust scores slightly based on this information. If you set this to female scores will be adjusted/compared to scores of people that declared their sex as female. Same with male. If no value is given the entire population is considered.
  4. last name [optional].
  5. user_locale [optional]: set to one of the supported locales. Defaults to English.