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
Source	Cloud mode	Device mode	Hybrid mode
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Device mode
Web

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.

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.

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:

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.

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:

RudderStack supports recording the following Qualaroo callback events:

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:

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.

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:

3. Click Paste code in website source code or GTM.
4. In the Copy the Code section, look for s.src and note the mentioned 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