Woopra

Send your event data from RudderStack to Woopra.

Woopra is a customer journey and product analytics tool. It lets you track your customers’ activities across various product, marketing, and sales touchpoints. You can also leverage built-in triggers to take real-time actions based on user behavior.

RudderStack supports Woopra as a destination where you can send your event data seamlessly.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Warehouse, Shopify
  • Refer to it as WOOPRA in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcessupportedsupportedsupportednot supportednot supportednot supported
Device mode
Websupportedsupportedsupportednot supportednot supportednot supported
info

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Woopra native SDK from the https://static.woopra.com/ domain.

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

Get started

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

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

Connection settings

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

Woopra connection settings
  • Project Name: Enter your Woopra project name. This is the domain name you entered while setting up your project.
info
For more information on getting your Woopra project name, refer to the FAQ section below.
info
RudderStack uses this project name as a fallback value if it is not specified in the event’s integrations object. For more information, refer to the Identify section below.

To send the events to Woopra via web device mode, you also need to configure the following settings:

Woopra connection settings
Woopra connection settings

  • Cookie Name: Enter the name of the cookie used to identify the visitor.
  • Cookie Domain: Enter the domain scope of the Woopra cookie.
  • Click Tracking: Enable this setting to track user click interactions via links and buttons.
  • Cookie Path: Specify the cookie path that stores all information related to tracking user click interactions via links and buttons.
  • Download Tracking: If enabled, this setting lets you track the downloads on your web page.
  • Hide Campaign: Enable this setting to remove the captured campaign properties from the URL.
  • Idle Timeout: Enter the inactivity time (in ms) after which RudderStack considers the user to be offline.
  • Ignore Query URL: If enabled, RudderStack ignores the URL’s query component when the standard page view is called.
  • Outgoing Ignore Subdomain: If enabled, RudderStack does not track the links to the subdomains as outgoing links.
  • Outgoing Tracking: Enable this setting to track the external link clicks on the web page.
  • Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to Woopra.
info
For more information on this setting, refer to the Client-side Events Filtering guide.
  • Use device mode to send events: This setting must be enabled to send the events to Woopra via web device mode.
  • 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 update the visitor properties in Woopra.

RudderStack uses the identify endpoint to send the user information to Woopra.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4GRlm", {
  state: "Louisiana",
  firstName: "Alex",
  lastName: "Keener",
  country: "USA",
  email: "alex@example.com",
  integrations: {
    "woopra": {
      "projectName": "abc.com"
    }
  }
});

You can specify your Woopra project name within the integrations object of the identify event, as seen in the above snippet. Alternatively, you can specify the project name via the Project Name dashboard setting while configuring the destination.

info
If you provide the Woopra project name in both the dashboard settings as well as the integrations object, RudderStack gives precedence to the name specified in the integrations object.

RudderStack uses the below fields to identify a user in the same order of precedence:

Precedence orderRudderStack propertyWoopra property
1userId / traits.userId / traits.id / context.traits.userId / context.traits.idcv_id
2traits.email / context.traits.email / properties.emailcv_email
3context.externalId.woodpraId / anonymousIdcookie
info
For a detailed list of the supported property mappings, refer to the Standard property mappings section below.

Any user-provided cookie must be mapped to either email or userId when creating a new user or using the cookie for the first time. Otherwise, Woopra accepts the data but reflects it only when that cookie is mapped to any of these identifiers. For example, Woopra accepts the following event but does not reflect the data in the dashboard:

rudderanalytics.identify({
  name: "Alex Keener",
  country: "USA",
} {
  externalId: [{
    id: "some_external_id_1",
    type: "woopraId",
  }, ],
});

When you include a user identifier (email) in the subsequent events as shown below, Woopra reflects all user information present in the current and previous events.

rudderanalytics.identify({
  name: "Alex Keener",
  email: "alex@example.com",
  country: "USA",
} {
  externalId: [{
    id: "some_external_id_1",
    type: "woopraId",
  }, ],
});

Track

You can use the track call to track events in Woopra via the ce endpoint.

A sample track event is as shown below:

rudderanalytics.track("Order Completed", {
  orderId: "1234567",
  price: "567",
  currency: "USD",
});

Supported mappings

The following table lists the supported optional property mappings between RudderStack and Woopra for the track events:

RudderStack propertyWoopra propertyData type
eventeventString (in lower case)
originalTimestamptimestampUnix timestamp (in ms)
properties.{x}ce_{x}-
info
If the event name is empty, RudderStack sends an empty string to Woopra as well, as a default fallback.

Page

When you send a page event, RudderStack converts it to a Woopra track event and sends all page-related information and the associated properties.

Supported mappings

The following table lists the supported optional property mappings between RudderStack and Woopra for the page events:

RudderStack propertyWoopra propertyData type
properties.{x}ce_{x}-
Viewed <category> <name> PageeventString (in lower case)

Standard property mappings

The following table lists the supported property mappings between RudderStack and Woopra, common to all above events:

RudderStack propertyWoopra propertyData typePresence
integration.woopra.propertyNamepropertyDomainOptional
userId / traits.userId / traits.id / context.traits.userId / context.traits.idcv_idStringRequired, if cv_email or cookie is absent.
traits.email / context.traits.email / properties.emailcv_emailStringRequired, if cv_id or cookie is absent.
context.externalId.woodpraId / anonymousIdcookieStringRequired, if cv_email or cv_id is absent.
context.ipcv_ipIP addressOptional
traits.companycv_companyStringOptional
traits.name / context.traits.namecv_nameStringOptional
traits.{x} / context.traits.{x}-Custom fieldsOptional
context.device.typedeviceStringOptional
context.app.nameappStringOptional
ua.browser.name + ua.browser.versionbrowserStringOptional. The visitor profile for a given identifier won’t be published until this field is sent to Woopra.
context.os.nameosStringOptional

FAQ

Where can I find the Woopra project name?

To get your Woopra project name, follow these steps:

  1. Go to your Woopra dashboard.
  2. Select your organization and go to Projects.
  3. You should be able to see all your projects and the associated domain names (Woopra project name):
Woopra project name

Questions? Contact us by email or on Slack