Wootric by InMoment Destination

Wootric by InMoment quick info

Wootric by InMoment accepts Page, Identify, and Track calls. If you reference it in the Integrations object, call it “Wootric", or "Wootric by InMoment”.

Wootric by InMoment accepts device-mode data from both Analytics.js and mobile sources. It does not accept data in cloud-mode.

Wootric by InMoment is the modern customer feedback management platform that brands around the globe use to make experience their competitive advantage.

The Wootric by InMoment Destination is open-source. You can browse the code on GitHub.

This document was last updated on January 23, 2020. If you notice any gaps, out-dated information or simply want to leave some feedback to help us improve our documentation, contact Wootric by InMoment Support!

Getting Started

Before you start, make sure Wootric by InMoment supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.

Web Mobile Server
📱 Device-mode ⬜️
☁️ Cloud-mode ⬜️ ⬜️ ⬜️
  1. From the Segment web app, click Catalog.
  2. Search for “Wootric by InMoment” in the Catalog, select it, and choose which of your sources to connect the destination to.
  3. In the destination settings, enter your Wootric by InMoment “Account Token”. You can retrieve this from your Wootric by InMoment Settings > Your unique Account Token. It should look like NPS-XXXXXXXX.
  4. If you’re using Segment’s client-side analytics.js library, your changes appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading Wootric by InMoment’s Javascript library onto the page and begins sending data.

Mobile

  1. For mobile implementations additional settings are required. Navigate to your Wootric by InMoment Settings > API to add in your “Client ID” and “Client Secret” to the respective parts of the Segment Settings UI.

IMPORTANT: The incoming responses and surveys will not be tied to a user until you identify your user.

Identify

If you’re not familiar with the Segment Specs, take a look to understand what the Identify method does. An example call would look like:

analytics.identify('userId123', {
  email: 'hello@example.com',
  createdAt: '2018-08-03T15:28:46.493Z',
  language: 'EN'
});

When you call Identify, the user’s information is passed to Wootric by InMoment to check eligibility during survey responses. Segment’s special traits recognized as Wootric by InMoment’s standard user profile fields (in parentheses) are:

Segment Parameter Wootric by InMoment Parameter Description
email wootricSettings.email The email of this user.
createdAt wootricSettings.created_at ISO 8610 timestamp. Wootric requires the timestamp to be rounded to the nearest second so we will make this conversion for you.
language wootricSettings.language Language for Wootric’s Net Promoter Score (NPS).

Track

When you call Track, the user’s information is passed along with the event name to Wootric by InMoment to check eligibility during survey responses.

Note: this only works if you enable Targeted Sampling in your Wootric by InMoment account. The event name must be exactly the same as the one used in the Track call.

Page

If you aren’t familiar with the Segment Spec, you should first read about what the Page method does. An example call would look like:

analytics.page()

Segment sends Page calls to Wootric by InMoment as a pageview.

When you call Page, Wootric by InMoment tracks the URL, page name, and page path that you are currently on. You can use this information in the Wootric by InMoment Settings to trigger surveys by using Wootric by InMoment’s Targeted Sampling feature. Wootric by InMoment recognizes the following Segment Page properties as the following page fields:

Segment Parameter Wootric by InMoment Parameter Description
name wootricSettings.email The name assigned to this page.
path wootricSettings.page_info.path The path portion of the URL of the page. Equivalent to the canonical path which defaults to location.pathname from the DOM API.

Settings

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

Setting Description
Account Token
(required)
string. You can find your account token in your Wootric Settings under ‘Install JS Beacon’. It should look something like this: NPS-4aeb53c1.
Client ID
(required)
string. Only required for the Wootric mobile integration. You can find your Client ID in your Wootric Settings.
Client Secret
(required)
string. Only required for the Wootric mobile integration. You can find your Client Secret in your Wootric Settings.

Adding Wootric by InMoment to the integrations object

To add Wootric by InMoment to the integrations JSON object (for example, to filter data from a specific source), use one of the following valid names for this integration:

  • Wootric

  • Wootric by InMoment

This page was last modified: 23 Jun 2021



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account