Enabling Customer Centricity

Push Metadata


Getting Started

For each questionnaire that is displayed to the end user, a set of custom values (metadata) can be pushed.

Metadata can be added before displaying the questionnaire or after its display, as long as a questionnaire is displayed. If no questionnaire is displayed, metadata will not be saved.


Pushing metadata might be restricted based on the Application Plan:

  • Free Plans are NOT allowed to push custom metadata
  • Paid Plans can push any metadata they configure

Information Needed

One final step before we start installing the e-satisfaction JavaScript Library, we are going to need get the Questionnaire Id from the dashboard settings, as the screenshot displays:

Push Metadata

Place the following script anywhere in your website. Make sure that e-satisfaction script is loaded.

Esat.updateMetadata("QUESTIONNAIRE_ID", {
   responder: {
       "email": "john@doe.com",
       "visitor": true, // true for visitor, false for logged in user
       "gender": "male",
       "region": "The region of your visitor/customer"

   questionnaire: {
       "page": "The page where the questionnaire is displayed",
       "mobile": true // true for mobile, false for desktop,


The above script refers to example metadata. You should change the values to the ones that correspond to your case.

You will have first to create your application metadata through your dashboard, in the section Application Metadata, and then use them during the installation process.

Metadata We Collect Automatically

Based on our article regarding the data we collect, there is a set of metadata that we collect automatically to make sure we are providing the best experience to the end-user. These metadata are the following:

Name Type Description
User Agent string

The user_agent variable as any browser is broadcasting it.

We store it as a plain string so that we can extract information like Browser, Operating System etc.

Country string Based on the usage and the location, we might collect the country of the end-user, on estimation.
Referrer string

The referrer variable as any browser is providing it (it's not a necessary field, and not all browsers can provide it).

We are storing this value to allow you to explore the pages where end-users respond to your questionnaires.

Was this article helpful?
0 out of 0 found this helpful

Have more questions? Submit a request