Getting started

Distribute and embed your UserSound surveys.

Introduction

These documents outline how you can distribute and embed your own UserSound surveys.

Quickstart

The two quickest ways to start distributing your UserSound surveys are:

  • Sending via link (no-code)
  • Web snippet embed

The simplest no-code way to distribute your survey is to head to your dashboard:

  1. Log in to UserSound
  2. Go to your project dashboard for the UserSound you want to share
  3. Click the link icon to copy your UserSound survey link. It will look something like this:

https://usersound.com/survey/df60dd74-b301-4ae5-9cde-968c31f28cc2/

You can share this link with your participants however you usually communicate with your customers: email, social media, or customer service tools such as Intercom. Anyone who clicks the link will be redirected to usersound.com to complete the survey.

You can append query parameters to your survey link to identify respondents without adding extra fields for the user to fill.

Supported query parameters:

  • email — identify the respondent by email address
  • user_id — identify the respondent by your own user ID
  • user_name, first_name — pre-fills the name input step for respondents

Example — identify by email only:

https://usersound.com/survey/df60dd74-b301-4ae5-9cde-968c31f28cc2/[email protected]

Identified respondents appear on your project dashboard with their email, and you can view all of their responses via View profile.

Web snippet embed

The simplest way to embed UserSound directly within your web application is with our web snippet.

  1. Log in to UserSound
  2. Go to your project dashboard for the UserSound you want to embed
  3. Go to Setup > Widget Settings
    1. Check Restricted and Web
    2. Enter your website's domain
    3. Save and exit
  4. Click the embed icon and copy and paste the code before your page's closing </head> tag.

You should now see a floating widget in the bottom right-hand side of your website.

JavaScript 


<script src="https://cdn.jsdelivr.net/npm/@usersound/usersound-sdk/dist/usersound.browser.min.js"></script>

<script>
  UserSound.init({
    baseUrl: "https://usersound.com",
    projectId: "your-project-uuid", // IMPORTANT: replace with your actual project ID
  });

  UserSound.create({});
</script>

Next steps

Learn how to identify users, handle completion states, and customise embeds in Embedding UserSound.