Specify the User for Skin Consultant App by providing an external user ID
This page explains how you can pass your external user IDs to the Skin Consultant App and link them with Haut.AI's user names in the Skin Consultant App
Option 1: Automatic User Detection by Haut.AI
By default, the Skin Consultant App identifies the user automatically by device + browser fingerprint.
New User: When a new fingerprint is identified, a new subject will be created. The subject will be assigned an automatically generated internal ID -
subject_ID
;Existing User: When the same device + browser fingerprint is used to access the Skin Consultant App again (read: same user returned to the app), the Skin Consultant App will automatically identify the already existing subject.
When is this option applicable?
If your product (website or mobile application) has no authentication feature.
If your product has an authentication feature, but your users can access the Skin Consultant App without it (for example, the Skin Consultant App is a part of the lead generation funnel, leading to the registration page)
Option 2: Define User via External User ID passing
You can optionally pass your external user IDs to the Skin Consultant App's name
parameter.
New User: When you pass an external user ID as a
name
that does not yet exist in SaaS, a new subject will be created. The subject will be assigned an automatically generated internal ID -subject_ID
, — and aname
equal to your external user ID;Existing User: When you pass an external user ID as a
name
that already exists in the SaaS, the Skin Consultant App will use the existing subject.
When it is applicable
If your product has an authentication feature, and users are assigned user IDs, and the Skin Consultant App experience starts after your user logins to your system.
Benefits
By linking your external user IDs with Haut.AI's name
parameter, you will:
Enable better tracking of users, especially in multi-tenant applications.
Enhance the ability to better segment and analyze user behavior (for example, compare the behavior of users who did and did not use Skin Consultant App).
Create personalized links by adding an External User ID
Each your Skin Consultant App has a unique URL that allows to open it as a separate webpage or integrate it (see Integrate Skin Consultant App to your e-Commerce Website). You can find link here: Previewing your Skin Consultant app.
The URL has the following format:
https://saas.haut.ai/b2c/first-entrance?app_id=<app_id>&company_id=<company_id>&utm_campaign=<campaign_name>&company_cid=<company_code>
&name=<external_user_id>
external_user_id must be a string (simple text) with a max length of 512 symbols
Example
Let's say your user has a user ID in your system as
User123
. When correctly implemented, your URL for your Skin Consultant App should look like this:
https://saas.haut.ai/b2c/first-entrance?app_id=<app_id>&company_id=<company_id>&utm_campaign=<campaign_name>&company_cid=<company_code>&name=User123
Recommendations for Implementation (for Developers)
Your frontend application should be configured to inject parameter
name
to the URL in the iframe when the user accesses the application. Typically, this is done in the app's initialization code.Validate the incoming query parameters to prevent potential security vulnerabilities, such as injection attacks.
Find External User ID in Haut.AI SaaS
When the user that is identified via an external user ID (&name=<external_user_id>
) finishes the Skin Consultan App session, you will see in SaaS a new Subjects. This subject will have:
Subject ID: Haut.AI internal user ID, generated automatically.
Name: your <external_user_id> user will be here.
You will be able to see External User ID in the SaaS User Interface on a page of Datasets > Subjects

You will also be able to export this information via CSV export from Dataset (see Export Results as CSV file):

FAQ
Last updated
Was this helpful?