Segment

Send customer event data from Segment to Natero. To learn more about Segment, please visit their website.

Overview

Segment events contain information about interactions users have with your product. These interactions can be tracked and logged in Natero. Each event contains information about the specific interaction. This includes: the time at which the interaction occurred, the module and feature associated with the action, and the account and user ID that performed the action.

In addition to tracking user actions, the integration with Segment can also be used to add information about new users and/or accounts, and update existing users and/or accounts.

Our Segment Integration API doc outlines Segment events, and the properties of those events that Natero requires to perform these tasks.

Modules and Features

Modules and features specify a hierarchy by which to categorize events. Modules may include multiple features; while features are mapped to individual clicks or events within a module. For example, a dashboard is typically a module, while the specific action of adding a widget to a dashboard is a feature.

Limitations

Since Segment does not track the time a user spends within the product, Natero attempts to estimate the time spent within a module and time spent within a session. When we do not see a session ID (Segment anonymousId) for a period of 30 minutes, we 'timeout' the session and compute the time spent within that session. We perform similar calculations to determine the amount of time spent within a module.

Note: Our Natero JS event collector library tracks user idle time and provides much more accurate information regarding the time spent within sessions and modules.

Other Mappings

The Segment Integration API doc also outlines the preferred method for integrating Segment with Natero. We recognize that there are many ways to provide similar information. Thus, we built Natero's event collection layer to be flexible enough to support many different mappings. Please contact support@natero.com if your mappings are different to those outlined below.

Setup

Follow these steps to setup your Segment integration:

  1. In Natero, visit the IT Administration page to obtain your Natero API keys.
  2. Log into your Segment account.
  3. Search to find the Natero application.
  4. Turn on the Natero application and fill in the required Send Key (the Natero Event API Key) and Auth Key (the Natero Event Auth Key).
  5. Click "SAVE AND CLOSE".

As soon as the integration is enabled within Segment, Natero will start receiving your data. Notify support@natero.com once you enable the integration to verify that data is being received by Natero.

Have more questions? Submit a request

Comments