Qualtrics

Send your event data from RudderStack to Qualtrics.

Qualtrics is a popular survey software that lets you create intelligent, real-time user surveys. It lets you get cutting-edge insights into your customers and use them to boost your brand value.

RudderStack lets you configure Qualtrics as a destination to which you can send your event data directly.

Getting started

RudderStack supports sending event data to Qualtrics via the following connection modes:

Connection ModeWebMobileServer
Device modeSupportedSupported-
Cloud mode---
info
In a web device mode integration, that is, using JavaScript SDK as a source, the Qualtrics native SDK is loaded from http://qualtrics.com domain. Based on your website’s content security policy, you might need to allowlist this domain to load the Qualtrics SDK successfully.

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

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

Configuration Settings

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

  • Project ID: Enter your Qualtrics Project ID here.
  • Brand ID: Enter your Qualtrics Brand ID here.
info
Refer to the FAQ section below for steps on obtaining your Qualtrics Project ID and Brand ID.
  • Enable Generic Page Title: If this field is enabled, RudderStack sends every page call with the name Viewed a Page.
info
This field is useful only when using the page call.
info
If this option is disabled, RudderStack will search for the category and name of the page call and send the event as Viewed <category_field> <name_field> Page. If any of the two fields is absent, RudderStack sends the page call as Viewed <category_field> / <name_field> Page.

Adding device mode integration

info
In the iOS device mode implementation, even if the user qualifies for multiple intercepts, only one will be shown. Whereas in Android, all intercepts for the user will be shown.

Page

The page call lets you record your website’s page views with any additional relevant information about the viewed page.

RudderStack passes any tracked events as embedded data to the Qualtrics intercept target. After the page call, the Qualtrics survey is loaded.

success
You can set the intercepts when a user creates the project or after they have created the project.

A sample page call is as shown:

rudderanalytics.page("category", "name", {
  path: "path",
  url: "url",
  title: "title",
  search: "search",
  referrer: "referrer",
  testDimension: "true"
});

For the above example, The event will be sent as Viewed category name Page, if the Generic Page Title option is disabled in the RudderStack dashboard. If this option is enabled, the event will be sent as Viewed a Page.

If the category field is not mentioned in the page call but specified inside the properties, RudderStack still includes the field while sending the event. For example, refer to the following snippet:

rudderanalytics.page("name", {
  category: "category",
  path: "path",
  url: "url",
  title: "title",
  search: "search",
  referrer: "referrer",
  testDimension: "true"
});

For the above example, the event will be sent as Viewed category name Page, if the Generic Page Title option is disabled in the RudderStack dashboard. If it is enabled, the event will be sent as Viewed a Page.

If category is not specified in the event at all, RudderStack sends the event with only the page name, as shown below:

rudderanalytics.page("name", {
  path: "path",
  url: "url",
  title: "title",
  search: "search",
  referrer: "referrer",
  testDimension: "true"
});

For the above example, The event will be sent as Viewed name Page, if the Generic Page Title option is disabled in the RudderStack dashboard. If enabled, the event will be sent as Viewed a Page.

warning
If both the name and category fields are absent in the page call and the Generic Page Title option is disabled, RudderStack will not send the event to Qualtrics.

Track

The track call lets you track how many times a user performs certain actions. RudderStack passes any tracked events as embedded data to the Qualtrics intercept target. After the track call, the Qualtrics survey is loaded.

info
In Qualtrics, both page and track calls have the same functionality.
success
You can set the intercepts either during or after creating the project.

In this case, the value of event field of the track call will be used as the event name while sending it to Qualtrics.

A sample track call is as shown:

rudderanalytics.track("Test Event");

In the above example, the event will be sent to Qualtrics as Test Event.

Identify

info
The identify call is supported only in the mobile (Android and iOS) Device Mode integration.

When you make an identify call, RudderStack sets the user traits using:

  • The Qualtrics Properties class, setString, and setNumber API in case of Android, and
  • The setStringWithString and setNumberWithNumber API in case of iOS

These user traits can be used as custom properties while setting the Target Logic or Embedded Data for any intercept in your Qualtrics dashboard.

FAQ

How do I get my Qualtrics project ID and brand ID?

  1. Log into your Qualtrics account.
  2. Click the project you will be using.
  3. Click Settings tab, followed by Manage Project option (the right-most dropdown menu in the dashboard).
Qualtrics IDs
  1. Click Project IDs. Here you will find both your Project ID and Brand ID:
Qualtrics IDs

How do I know if the RudderStack SDK has loaded successfully?

Once RudderStack loads the web SDK successfully, you will be able to see the survey options chosen in the Qualtrics dashboard, for example, a survey button, survey form, etc.

Qualtrics success

Is it possible to manually set the logic in the mobile device mode integration?

Yes, you can manually set the logic using Qualtrics Properties class setString and setNumber API on Android and setStringWithString and setNumberWithNumber API on iOS. For more information, refer to the iOS documentation or the Android documentation, depending on your implementation.


Questions? Contact us by email or on Slack