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.