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.

Connection compatibility

Destination Information
Status: Generally Available Supported sources: Web, Android (Java) , iOS (Obj-C) Refer to it as Qualtrics in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
Android (Java)
iOS (Obj-C)
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Device mode
Android (Java)
iOS (Obj-C)
Web

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Qualtrics native SDK from thehttp://qualtrics.com domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Qualtrics SDK successfully.

Get started

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.

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.

This field is useful only when using the page call.

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

pod 'Rudder-Qualtrics'

#import <rudder>
#import <rudderqualtricsfactory.h>
@import Qualtrics;

RSConfigBuilder *configBuilder = [[RSConfigBuilder alloc] init];
    [configBuilder withDataPlaneUrl:DATA_PLANE_URL];
    [configBuilder withFactory:[RudderQualtricsFactory instance]];
    [RSClient getInstance:<source_write_key> config:[configBuilder build]];

[Qualtrics.shared evaluateProjectWithCompletion:^(NSDictionary<nsstring>* targetingResults){
    for (NSString* interceptID in targetingResults) {
      TargetingResult *result = targetingResults[interceptID];
          if ([result passed]) {
            [[Qualtrics shared] displayWithViewController:self];
          }
    }
}];

implementation 'com.rudderstack.android.sdk:core:1.+'
implementation 'com.rudderstack.android.integration:qualtrics:1.0.0'
implementation 'com.google.code.gson:gson:2.8.6'

// Qualtrics
implementation 'com.qualtrics:digital:2.0.0'

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            url "https://s3-us-west-2.amazonaws.com/si-mobile-sdks/android/"
        }
    }
}

<activity android:name="com.qualtrics.digital.QualtricsSurveyActivity"></activity>
<activity android:name="com.qualtrics.digital.QualtricsPopOverActivity" android:theme="@style/Qualtrics.Theme.Transparent"></activity>

// initialize Rudder SDK
val rudderClient =
    RudderClient.getInstance(
        this,
        WRITE_KEY,
        RudderConfig.Builder()
            .withDataPlaneUrl(DATA_PLANE_URL)
            .withFactory(QualtricsIntegrationFactory.FACTORY)
            .build()
    )

private class MyCallback implements IQualtricsProjectEvaluationCallback {
   @Override
   public void run(Map<string targetingresult=""> targetingResults) {
       for (Map.Entry<string> result: targetingResults.entrySet())
           if (result.getValue().passed()) {
               Qualtrics.instance().displayIntercept(MainActivity.this, result.getKey());
           }
   }
}

Qualtrics.instance().evaluateProject(new MyCallback());

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.

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.

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.

In Qualtrics, both page and track calls have the same functionality.

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

The identify call is supported only in the mobile (Android (Java) and iOS (Obj-C)) 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.

[[RSClient sharedInstance] identify:@"test_user_id"
        traits: @{ @"property_key": @"property_value" }];

MainApplication.rudderClient.identify(
    RudderTraits().put("property_key", "property_value")
)

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).

4. Click Project IDs. Here you will find both your Project ID and Brand ID:

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.

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.