Integrate with Segment
Last Update: Oct 2024 • Est. Read Time: 2 MINKustomer provides features that allow you to dynamically add tracking events from Segment into customer timelines in real-time.
Who can access this feature? | |
User types | Admins can set up this integration. |
In this article
- Prerequisites
- Install the Segment app in Kustomer
- Configure Kustomer in Segment
- Traits
- Track customer events
- Beyond tracking events
Prerequisites
Before connecting Segment to Kustomer, you must have a Segment account and the desired sources configured and collecting data.
Install the Segment app in Kustomer
To integrate Segment with Kustomer, install the Segment app from within the Kustomer App Directory.
- Go to Appsand select Explore Directory.
- Search for Segment in the App Directory, and then select Install.
Configure Kustomer in Segment
Once the app is installed, you need to configure your Kustomer organization in Segment. Once configured, your data will automatically be sent to your Kustomer organization. Customer records and tracking events will automatically be created in your count as data is sent to this new destination.
- Go to Appsand select Segment in the sidebar.
- Copy the Segment API key.
- In another browser tab, sign in to your Segment account.
- Select Catalog in the left navigation bar and then select the Destinations tab.
- Search for Kustomer in the field provided.
- Select the Kustomer card and then select Configure Kustomer.
- Select a source from the list and then select Confirm Source.
- Select API Key in Connection Settings to edit it.
- Paste the Kustomer Segment API key into the text field, then select Save.
- Leave the Segment site open. Return to Kustomer in your other browser tab, and in the Segment App Settings copy the Org Pod to your clipboard.
- Back on the Segment site, select Org Pod in the Connection Settings.
- Paste the Org Pod from the Kustomer settings into the text field, then select Save.
Traits
Most traits are mapped to an appropriate customer Standard Object (KObject) attribute in Kustomer. For more details, see Segment’s Traits documentation.
In addition to the Segment traits, the following properties are automatically mapped together:
- Segment userId -> Kustomer externalId
- Segment context.locale -> Kustomer locale
Track customer events
The kustomer_session_id
is an optional string that identifies a session within your application. Kustomer groups tracking events within a single session as one item within a customer’s timeline. If a kustomer_session_id
is not supplied, Kustomer will automatically generate session ids based on time between tracking events. Learn more about why Segment doesn't offer session tracking.
Beyond tracking events
If basic tracking events do not satisfy your needs, it’s possible to create a custom webhook in Kustomer and use Workflows to create custom objects (KObjects), publish events, create or update customers, and more.