Segment Connections Destination
The Segment Connections destination enables you to mold data extracted from your warehouse into Segment Spec API calls that can be processed by Segment’s Tracking API.
You can only connect the Segment Connections destination to Reverse ETL warehouse sources.
Getting started
Create a source
- From the Segment web app, navigate to Sources and select Add Source.
- Search for HTTP API in the Sources Catalog, select the HTTP API source, and click Add Source.
- Follow the steps to name your source. This is the source that will receive API calls from the Segment Connections destination.
- Copy the Write Key on the Overview tab. You will need this when you set up the Segment Connections destination.
Connect and configure the Segment Connections destination
- From the Segment web app, navigate to Reverse ETL > Destinations.
- Click Add Destination.
- Select the Segment Connections destination, click Next, and select the warehouse source that will send data to the Segment Connections destination. If you have not set up a warehouse source, follow the steps in the Reverse ETL documentation on Getting started.
- On the Settings tab, name your destination, input the Write Key from the source created above, select an endpoint region, and click Save Changes. It is recommended to configure and enable all mappings before enabling the Segment Connections destination.
- On the Mappings tab, click Add Mapping. Select a data model and the API call type you want to map. Fill in the fields on screen to create the desired mappings, and click Create Mapping to complete the configuration. Repeat this step to configure multiple mappings.
- Enable the configured mapping(s).
- On the Settings tab, click the Enable Destination toggle, and then click Save Changes to enable the Segment Connections destination.
Destination Settings
Setting | Description |
---|---|
Source Write Key | Required. The Write Key of a Segment source. |
Available Actions
Build your own Mappings. Combine supported triggers with the following Segment Connections-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Send Page
Send a page call to Segment’s tracking API. This is used to track website page views.
Send Page is a Cloud action. The default Trigger is: type = "page"
Field | Description |
---|---|
User ID | Type: STRING Unique identifier for the user in your database. A userId or an anonymousId is required. |
Anonymous ID | Type: STRING A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required. |
Timestamp | Type: STRING Timestamp when the message itself took place as a ISO-8601 format date string. Defaults to current time if not provided. |
Page Name | Type: STRING Name of the page that was viewed. |
Page Category | Type: STRING Category of the page that was viewed. |
Application | Type: OBJECT Dictionary of information about the current application. |
Campaign Parameters | Type: OBJECT Dictionary of information about the campaign that resulted in the API call. This maps directly to the common UTM campaign parameters. |
Device | Type: OBJECT Dictionary of information about the device the API call originated from. |
IP Address | Type: STRING The current user’s IP address. |
Locale | Type: STRING Locale string for the current user, for example en-US. |
Location | Type: OBJECT Dictionary of information about the user’s current location. |
Network | Type: OBJECT Dictionary of information about the current network connection. |
Operating System | Type: OBJECT Dictionary of information about the operating system. |
Page | Type: OBJECT Dictionary of information about the current page in the browser. |
Screen | Type: OBJECT Dictionary of information about the device’s screen. |
User Agent | Type: STRING User agent of the device the API call originated from. |
Timezone | Type: STRING The user’s timezone as a tz database string, for example America/New_York. |
Group ID | Type: STRING The group or account ID a user is associated with. |
Properties | Type: OBJECT Free-form dictionary of properties that describe the screen. |
MessageId | Type: STRING The Segment messageId. |
Batch Data to segment | Type: BOOLEAN This is always disabled pending a full removal. When enabled, the action will send batch data. Segment accepts batches of up to 225 events. |
Send Track
Send a track call to Segment’s tracking API. This is used to record actions your users perform.
Send Track is a Cloud action. The default Trigger is: type = "track"
Field | Description |
---|---|
User ID | Type: STRING Unique identifier for the user in your database. A userId or an anonymousId is required. |
Anonymous ID | Type: STRING A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required. |
Timestamp | Type: STRING Timestamp when the message itself took place as a ISO-8601 format date string. Defaults to current time if not provided. |
Event Name* | Type: STRING Name of the action that a user has performed. |
Application | Type: OBJECT Dictionary of information about the current application. |
Campaign Parameters | Type: OBJECT Dictionary of information about the campaign that resulted in the API call. This maps directly to the common UTM campaign parameters. |
Device | Type: OBJECT Dictionary of information about the device the API call originated from. |
IP Address | Type: STRING The current user’s IP address. |
Locale | Type: STRING Locale string for the current user, for example en-US. |
Location | Type: OBJECT Dictionary of information about the user’s current location. |
Network | Type: OBJECT Dictionary of information about the current network connection. |
Operating System | Type: OBJECT Dictionary of information about the operating system. |
Page | Type: OBJECT Dictionary of information about the current page in the browser. |
Screen | Type: OBJECT Dictionary of information about the device’s screen. |
User Agent | Type: STRING User agent of the device the API call originated from. |
Timezone | Type: STRING The user’s timezone as a tz database string, for example America/New_York. |
Group ID | Type: STRING The group or account ID a user is associated with. |
Properties | Type: OBJECT Free-form dictionary of properties that describe the screen. |
Traits | Type: OBJECT Free-form dictionary of traits that describe the user or group of users. |
MessageId | Type: STRING The Segment messageId. |
Batch Data to segment | Type: BOOLEAN This is always disabled pending a full removal. When enabled, the action will send batch data. Segment accepts batches of up to 225 events. |
Send Identify
Send an identify call to Segment’s tracking API. This is used to tie your users to their actions and record traits about them.
Send Identify is a Cloud action. The default Trigger is: type = "identify"
Field | Description |
---|---|
User ID | Type: STRING Unique identifier for the user in your database. A userId or an anonymousId is required. |
Anonymous ID | Type: STRING A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required. |
Timestamp | Type: STRING Timestamp when the message itself took place as a ISO-8601 format date string. Defaults to current time if not provided. |
Application | Type: OBJECT Dictionary of information about the current application. |
Campaign Parameters | Type: OBJECT Dictionary of information about the campaign that resulted in the API call. This maps directly to the common UTM campaign parameters. |
Device | Type: OBJECT Dictionary of information about the device the API call originated from. |
IP Address | Type: STRING The current user’s IP address. |
Locale | Type: STRING Locale string for the current user, for example en-US. |
Location | Type: OBJECT Dictionary of information about the user’s current location. |
Network | Type: OBJECT Dictionary of information about the current network connection. |
Operating System | Type: OBJECT Dictionary of information about the operating system. |
Page | Type: OBJECT Dictionary of information about the current page in the browser. |
Screen | Type: OBJECT Dictionary of information about the device’s screen. |
User Agent | Type: STRING User agent of the device the API call originated from. |
Timezone | Type: STRING The user’s timezone as a tz database string, for example America/New_York. |
Group ID | Type: STRING The group or account ID a user is associated with. |
Traits | Type: OBJECT Free-form dictionary of traits that describe the user or group of users. |
MessageId | Type: STRING The Segment messageId. |
Batch Data to segment | Type: BOOLEAN This is always disabled pending a full removal. When enabled, the action will send batch data. Segment accepts batches of up to 225 events. |
Send Group
Send a group call to Segment’s tracking API. This is used to associate an individual user with a group
Send Group is a Cloud action. The default Trigger is: type = "group"
Field | Description |
---|---|
User ID | Type: STRING Unique identifier for the user in your database. A userId or an anonymousId is required. |
Anonymous ID | Type: STRING A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required. |
Group ID* | Type: STRING The group or account ID a user is associated with. |
Timestamp | Type: STRING Timestamp when the message itself took place as a ISO-8601 format date string. Defaults to current time if not provided. |
Application | Type: OBJECT Dictionary of information about the current application. |
Campaign Parameters | Type: OBJECT Dictionary of information about the campaign that resulted in the API call. This maps directly to the common UTM campaign parameters. |
Device | Type: OBJECT Dictionary of information about the device the API call originated from. |
IP Address | Type: STRING The current user’s IP address. |
Locale | Type: STRING Locale string for the current user, for example en-US. |
Location | Type: OBJECT Dictionary of information about the user’s current location. |
Network | Type: OBJECT Dictionary of information about the current network connection. |
Operating System | Type: OBJECT Dictionary of information about the operating system. |
Page | Type: OBJECT Dictionary of information about the current page in the browser. |
Screen | Type: OBJECT Dictionary of information about the device’s screen. |
User Agent | Type: STRING User agent of the device the API call originated from. |
Timezone | Type: STRING The user’s timezone as a tz database string, for example America/New_York. |
Traits | Type: OBJECT Free-form dictionary of traits that describe the user or group of users. |
MessageId | Type: STRING The Segment messageId. |
Batch Data to segment | Type: BOOLEAN This is always disabled pending a full removal. When enabled, the action will send batch data. Segment accepts batches of up to 225 events. |
Send Screen
Send a screen call to Segment’s tracking API. This is used to track mobile app screen views.
Send Screen is a Cloud action. The default Trigger is: type = "screen"
Field | Description |
---|---|
User ID | Type: STRING Unique identifier for the user in your database. A userId or an anonymousId is required. |
Anonymous ID | Type: STRING A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required. |
Timestamp | Type: STRING Timestamp when the message itself took place as a ISO-8601 format date string. Defaults to current time if not provided. |
Screen Name | Type: STRING Name of the screen that was viewed. |
Application | Type: OBJECT Dictionary of information about the current application. |
Campaign Parameters | Type: OBJECT Dictionary of information about the campaign that resulted in the API call. This maps directly to the common UTM campaign parameters. |
Device | Type: OBJECT Dictionary of information about the device the API call originated from. |
IP Address | Type: STRING The current user’s IP address. |
Locale | Type: STRING Locale string for the current user, for example en-US. |
Location | Type: OBJECT Dictionary of information about the user’s current location. |
Network | Type: OBJECT Dictionary of information about the current network connection. |
Operating System | Type: OBJECT Dictionary of information about the operating system. |
Page | Type: OBJECT Dictionary of information about the current page in the browser. |
Screen | Type: OBJECT Dictionary of information about the device’s screen. |
User Agent | Type: STRING User agent of the device the API call originated from. |
Timezone | Type: STRING The user’s timezone as a tz database string, for example America/New_York. |
Group ID | Type: STRING The group or account ID a user is associated with. |
Properties | Type: OBJECT Free-form dictionary of properties that describe the screen. |
MessageId | Type: STRING The Segment messageId. |
Batch Data to segment | Type: BOOLEAN This is always disabled pending a full removal. When enabled, the action will send batch data. Segment accepts batches of up to 225 events. |
FAQ & Troubleshooting
API Calls and MTUs
The Segment Connections destination sends data to Segment’s Tracking API, which has cost implications. New users will count as new MTUs and each call will count as an API call. For information on how Segment calculates MTUs and API calls, please see MTUs, Throughput and Billing.
Test Mapping
The Test Mapping feature on the Mapping page does not send events to the Tracking API. It only validates the mappings and confirms that the event will be accepted by the Tracking API. To send and validate the event in your source, run a RETL sync.
This page was last modified: 09 Feb 2024
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!