- 01 Nov 2023
- 6 Minutes to read
Sending Segment Events to Insider
- Updated on 01 Nov 2023
- 6 Minutes to read
You can establish Insider as a destination in Segment’s ecosystem, and send data from your website and apps to Insider. With this integration, you can enable Insider to collect Segment’s Page, Identify, and Track specs.
This integration guide provides a complete frame of:
- Use cases
- Configuring Insider as a destination
- Create or update a User Profile
- Event Actions for Insider Cloud Destination
Use Cases
Sending your website and app data from Segment to Insider helps you leverage a range of use cases as follows:
- Triggering journeys
- Personalizing user experience
Triggering Journeys
You can track user behavior (e.g. cart abandonment, purchase, etc.) to trigger journeys with Insider’s Architect product, and target users across channels (e.g. website, web push, email, etc.).
Personalizing User Experience
You can leverage the comprehensive user information (e.g. name, age, viewed products, items added to cart, interest categories, etc.) that is passed from Segment, and deliver personalized user experiences and messaging.
Configuring Insider As a Destination
Follow these steps to configure Insider as a destination in your Segment account.
1. Log into your Segment account to find Insider Cloud (Actions) in the destination catalog.
2. Click Insider Cloud (Actions) > Configure Insider to select the source. Your source can be any source that you would like to connect Insider to.
3. Configure your Insider account settings for the integration.
4. Enter your Insider API key and partner name.
5. Use the toggle to enable the Insider integration.
Create or update a User Profile
Understanding the Identify Spec
Segment calls the Identify spec to collect user attributes. This spec connects users to their actions, and records this information along with a unique user ID and any other optional user data (e.g. name, email, etc.). Insider uses this spec to identify users, and registers their attributes.
Identification
Insider uses the following Segment attributes and maps them in the database as displayed in the following table:
Segment attribute | Mapping on Insider | Additional Information |
---|---|---|
userID | uuid | |
(Optional) Utilizing “Treat Email as Identifier” field, can be selected as identifier. | ||
phone | phone number | (Optional) Utilizing “Treat Phone Number as Identifier” field, can be selected as identifier. |
anonymousId | segment_anonymous_Id |
If you want to send email or SMS campaigns to your users, you must pass the respective opt-in information of the user to Insider as email opt-in and sms opt-in along with GDPR opt-in, email and phone number (in E.164 format). You can pass the email opt-in, SMS opt-in, WhatsApp opt-in and GDPR opt-in information as Boolean.
Insider also maps the mutual predefined attributes from Segment in the following mappings (can be changed while configuration):
Attribute on Segment | Mapping on Insider |
---|---|
Age | Age |
Birthday | Birthday |
firstName | Name |
lastName | Surname |
Gender | Gender |
address.country | Country |
address.city | City |
Event Actions for Insider Cloud Destination
To easily map any events on your Segment platform to Insider, click new mapping and use actions modal to create an event mapping for the following events in the table.
Event Name | Description |
---|---|
Product List Viewed | Record Product List View Event to Insider |
User Registered | Record User Registered Event to Insider |
Cart Viewed | Record Cart Viewed Event to Insider |
Product Removed | Record Product Removed Event to Insider |
Checkout | Record Checkout Events to Insider |
Product Viewed | Record Product View Event to Insider |
Product Added | Record Product Added Event to Insider |
Order Completed | Record Order Completed Event to Insider |
Track Event | Record custom event to Insider |
Identification
Insider uses the following Segment attributes and maps them in the database as displayed in the following table:
Segment attribute | Mapping on Insider | Additional Information |
---|---|---|
userID | uuid | |
(Optional) Utilizing “Treat Email as Identifier” field, can be selected as identifier. | ||
phone | phone number | (Optional) Utilizing “Treat Phone Number as Identifier” field, can be selected as identifier. |
anonymousId | segment_anonymous_Id |
Understanding the Track Spec
Segment calls the Track spec to record user actions along with their details. Insider receives the Track spec from Segment, and registers the events based on this spec’s data.
The name and other parameters attributes become event name and event parameters of this event respectively.
You can easily insert any custom event kept on your Segment Account but selecting Track Event and completing the mapping flow. After you launch the actions, data will start to flow to Insider.
Understanding the Ecommerce Spec
Insider uses the Ecommerce spec to map the following events:
Event on Segment | Mapping on Insider |
---|---|
Product Viewed | Product Detail Page View |
Product List Viewed | Listing Page View |
Product Added | Add to Cart |
Cart Reviewed | Cart Page View |
Order Completed | Purchase (Confirmation Page View) |
Checkout Started or Checkout Step Viewed | Checkout Page Viewed |
Product Viewed/Product Detail Page View
Insider receives the track event named Product Viewed in the Ecommerce spec, and registers it as Product Detail Page View.
Insider also maps the mutual properties as the following event parameters:
Property on Segment | Mapping on Insider |
---|---|
product_id | product ID |
category | taxonomy |
name | name (Product Name) |
price | unit price, unit sale price |
currency | currency |
image_url | product image url |
url | url |
You can find the all available default fields within the actions framework, any other property within this event is registered as a custom event parameter on Insider which you can configure under the event parameters mapping section.
Product List Viewed/Listing Page View
Insider receives the track event named Product List Viewed in the Ecommerce spec, and registers this event as Listing Page View.
Insider also registers category as taxonomy within the event parameters.
You can find the all available default fields within the actions framework, any other property within this event is registered as a custom event parameter on Insider which you can configure under the event parameters mapping section.
Cart Viewed/Cart Page View
Insider receives the track event named Cart Viewed in the Ecommerce spec, divides the products into events, and registers each product within the spec as a separate event by the Cart Page View event name. Within these events, Insider also maps the properties into the event parameters as follows:
Parameter on Segment | Mapping on Insider |
---|---|
product_id | product ID |
product.category | taxonomy |
product.name | name (Product Name) |
product.price | unit price, unit sale price |
product.image_url | product image url |
product.url | url |
currency | currency |
cart_id | event group ID |
You can find the all available default fields within the actions framework, any other property within this event is registered as a custom event parameter on Insider which you can configure under the event parameters mapping section.
Order Completed/Purchase
Insider receives the track event named Order Completed in the Ecommerce spec, divides the products into events, and registers each product within the spec as a separate event by the Purchase (confirmation page view) event name. This tracks event parameters such as tax, affiliation, revenue, shipping, discount, coupon, currency, and checktout_id. Within these events, Insider also maps the properties into the event parameters as follows:
Parameter on Segment | Mapping on Insider |
---|---|
product_id | product ID |
product.category | taxonomy |
product.name | name (Product Name) |
product.price | unit price, unit sale price |
product.image_url | product image url |
product.url | url |
currency | currency |
order_id | event group ID |
You can find the all available default fields within the actions framework, any other property within this event is registered as a custom event parameter on Insider which you can configure under the event parameters mapping section.
That's it! You can now send data from Segment to Insider and start automating journeys and personalizations.