Skip to main content

​
What are cohorts?

Cohorts are identifiers for a session, represented as key-value pairs (e.g., account_type: paid), that enable you to filter sessions in Adora. Each session can have an unlimited number of cohorts. Examples of useful cohort data include:
  • Experiment flags (e.g., new_onboarding_experience = true)
  • User account data (e.g., type = free, type = paid)
  • User settings (e.g., light-mode = dark)

​
What is captured?

By default, the Adora snippet automatically captures the following:
  • Country: Inferred from the user’s IP address.
  • Language: Determined by the browser’s language setting (navigator.language).
  • Browser and device type: Extracted from the user agent.
Additional data can be supplied to enhance session details:
  • User ID: A unique identifier for a user.
  • User Cohort: Custom key-value pairs that you define.
If the User ID or User Cohort changes during the session, you can call adoraStart again with the new user ID or user cohort.

​
Overriding the language

If your application’s displayed language is determined by user account settings rather than the browser, you can manually override the language by specifying the language parameter in adoraStart using an ISO 639-1 code (optionally with a country code): 
adoraStart({
  orgId: "ORGANIZATION_ID",
  language: "en-AU"
});

​
Adding User IDs

To uniquely identify a user, include a uid argument in adoraStart: 
adoraStart({
  orgId: "ORGANIZATION_ID",
  uid: "uid"
});
The uid can be either a string or a number.

​
Adding Custom Cohort Data

Custom cohort data can be added using the userCohorts field in adoraStart. This field accepts a set of arbitrary string key-value pairs for flexible segmentation. 
adoraStart({
  orgId: "ORGANIZATION_ID",
  userCohorts: {
    "plan": "free",
    "theme": "dark",
    "has_new_onboarding_flow": "true"
  }
});
This overrides the window object to include adoraStart.

​
Bypassing sampling

In some cases you may want to bypass sampling and ensure that a session is captured (e.g. if there are a cohort of users that are important to your business). This can be done by passing in bypassSampling: true when adoraStart is called. Although bypassSampling skips sampling, it is still subject to daily and monthly session caps. 
adoraStart({
  orgId: "ORGANIZATION_ID",
  bypassSampling: true, // or user.isVIP
});