# Qualaroo Destination

## Destination Info

* Accepts [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **Qualaroo** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)

### Components

* [Browser](https://github.com/segment-integrations/analytics.js-integration-qualaroo)

## Connection Modes

[Learn more about connection modes.](/docs/segment/connections/destinations/#connection-modes)

### Device-Mode

* web: yes
* mobile: no
* server: no

### Cloud-Mode

* web: no
* mobile: no
* server: no

[Qualaroo](https://qualaroo.com/) is a user testing tool that lets you add a survey to any page on your site, so you can get targeted user feedback as the user is performing a task. The `analytics.js` Qualaroo Destination is open-source. You can browse the code [on GitHub](https://github.com/segment-integrations/analytics.js-integration-qualaroo).

## Getting Started

1. From the Segment web app, click **Catalog**.
2. Search for "Qualaroo" in the Catalog, select it, and choose which of your sources to connect the destination to.
3. Enter your `Customer ID` from your Qualaroo JavaScript library URL. So if your URL is: `s3.amazonaws.com/ki.js/70009/gAJ.js`, your `Customer ID` would be: `70009`.
4. Enter your `Site Token` from your Qualaroo JavaScript library URL. So if your URL is: `s3.amazonaws.com/ki.js/70009/gAJ.js`, your `Site Token` would be: `gAJ`.
5. We'll initialize Qualaroo with your `Customer ID` and your `Site Token` upon loading `analytics.js`. Qualaroo will automatically start displaying your targeted surveys, according to the configurations you established on Qualaroo.

## Identify

If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](/docs/segment/connections/spec/identify/) does. An example call would look like:

```javascript
analytics.identify('8888', {
  name: 'Phil Connors',
  gender: 'Male',
  email: 'weatherman_phil@aol.com',
  phone: '(814) 618-5466',
  address: {
    city: 'Punxsutawney',
    state: 'PA',
    postalCode: '15767'
  }
});
```

When you call `identify` we call `_kiq.push(['identify', userId]);` with the `userId` you provide. We also call `_kiq.push(['set', traits]);` with the `traits` you provide.

## Track

**Note:** The use of [a custom property to trigger a survey](https://help.qualaroo.com/hc/en-us/articles/201441516) made available by utilizing a Segment Track call is currently not supported due to some code changes. The below section will *not* trigger a survey at this time.

If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/segment/connections/spec/track/) does. An example call would look like:

```javascript
analytics.track("Shadow Seen", {
  remainingWeeksOfWinter: 6,
  earlySpring: false,
});
```

Qualaroo doesn't technically have a `track` method yet, but if you enabled the `Record Events to Qualaroo` option in your settings then when you call `track` we will call `_kiq.push(['set', ...]);` with a single trait `'Triggered: ' + event` set to `true` based on the `event` parameter you provide.

***NOTE:** Qualaroo will only receive traits from Tracks calls and Identify calls that were triggered before the user has answered the Qualaroo survey.*

## Sending Data from Qualaroo

Qualaroo makes it easy for you to get the data you collect from surveys back into Segment and off to all your other Segment destinations. Check out their awesome article about [Sending Qualaroo data into Segment](http://help.qualaroo.com/hc/en-us/articles/205436425) to get setup.

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field                     | Description                                                                                                                                                                                      | Required | Type    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ------- |
| Customer ID               | Your Customer ID is the \*\*first\*\* part of the end of your Qualaroo Javascript library URL. So if your URL is: \`s3.amazonaws.com/ki.js/37282/9F2.js\`, your Customer ID would be: \`37282\`. | Yes      | string  |
| Site Token                | Your Site Token is the \*\*second\*\* part of the end of your Qualaroo Javascript library URL. So if your URL is: \`s3.amazonaws.com/ki.js/37282/9F2.js\`, your Site Token would be: \`9F2\`.    | Yes      | string  |
| Record Events to Qualaroo | By default Qualaroo only records a user's traits, not the events they trigger. If you'd like target a survey at users who've triggered a certain event, you'll want to enable this setting.      | No       | boolean |