Qualaroo

Send your event data from RudderStack to Qualaroo.

Qualaroo is a customer survey and user feedback platform. It lets you survey your users to understand how they are using your product and what they think of it.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Web
  • Refer to it as QUALAROO in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
Webnot supportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Device mode
Websupportedsupportedsupportednot supportednot supportednot supported

Get started

Once you have confirmed that the source platform supports sending events to Qualaroo, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Qualaroo.
  2. Assign a name to your destination and click Continue.

Connection settings

To successfully configure Qualaroo as a destination, you will need to configure the following settings:

  • Customer ID: Enter your Qualaroo customer ID.
  • Site Token: Enter your Qualaroo site token.
info
For more information on obtaining your Qualaroo customer ID and site token, refer to the FAQ section below.
  • Record Qualaroo Events: Enable this setting to allow RudderStack to automatically record your Qualaroo callback events as track events. You can then view and analyze these events using other tools (connected to the same source in RudderStack). For more information, refer to the Recording Qualaroo callback events section below.
    • List of Events: Select the list of events from dropdown which RudderStack automatically records as track events.
    • Update Event Name in track call: Enable this setting to update the event name in the track call.
      • Mapping to update the Event Name in track call: Use this setting to map your events with the standard Qualaroo callback events.
  • Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to Qualaroo. For more information on this setting, refer to the Client-side Events Filtering guide.
  • Use device mode to send events: As this is a web device mode-only destination, this setting is enabled by default and cannot be disabled.
  • Consent management provider: Configure the consent management settings for the specified source by choosing the consent management provider from the dropdown. If you choose Custom, make sure to pass the custom consent data to SDK.

Identify

You can use the identify call to send user-related information to Qualaroo.

A sample identify call is shown below:

rudderanalytics.identify("alex@example.com", {
  name: "Alex Keener",
  age: 25
})

RudderStack uses Qualaroo’s Identity API method to send the user information.

info
If an empty string is passed as an identifier, Qualaroo considers the user to be an unknown visitor or a user with no account.

Supported mapping

The following table lists the mappings between the RudderStack and Qualaroo properties:

RudderStack propertyQualaroo property
userId
context.traits.email
context.traits.userId
context.traits.id
identify
context.traitstraits

Track

You can use the track call to track user activities and send this information to Qualaroo.

A sample track call is shown below:

rudderanalytics.track("Product Viewed")

RudderStack maps the event name to Qualaroo’s Triggered event property. It then calls the _kiq.push(['set', ...]) method and passes the trait as Triggered event: event.

warning
Qualaroo does not accept any track event properties.

Recording Qualaroo callback events

You can use the Record Qualaroo Events dashboard setting to allow RudderStack to automatically record your specified Qualaroo callback events as track events. You can then view and analyze these events using other tools (connected to the same source in RudderStack).

Use the List of Events dashboard setting to specify the callback events to be automatically recorded:

List of Qualaroo events to be recorded automatically

RudderStack supports recording the following Qualaroo callback events:

Event nameDescription
showWhen a survey is displayed.
closeWhen a visitor submits the survey.
submitWhen a visitor replies to a question.
noTargetMatchWhen no surveys are set to fire.

You can also map your track events to the standard Qualaroo callback events using the Mapping to update the Event Name in track call dashboard setting:

Map events to standard Qualaroo events

Page

You can use the page call to send any page-related information to Qualaroo.

A sample page call is shown below:

rudderanalytics.page("Home")

RudderStack concatenates the page’s name and category and maps it to Qualaroo’s Viewed Page property. It then calls the _kiq.push(['set', ...]) method and passes the trait as Viewed Page: name+category.

warning
Qualaroo does not accept any page event properties.

FAQ

Where can I find the Qualaroo customer ID and site token?

To get your Qualaroo customer ID and site token, follow these steps:

  1. Log into your Qualaroo dashboard.
  2. Click the Install Code option:
Install code option in Qualaroo dashboard
  1. Click Paste code in website source code or GTM.
  2. In the Copy the Code section, look for s.src and note the mentioned URL:
Qualaroo JavaScript URL

Suppose your URL is https://cl.qualaroo.com/ki.js/12345/j8N.js, then 12345 is the customer ID and j8N is the site token.


Questions? Contact us by email or on Slack