Insider Destination

1. From the Destinations catalog page in the Segment App, click Add Destination.
2. Search for "Insider" in the Destinations Catalog, and select the Insider destination.
3. Choose which Source should send data to the Insider destination.
4. Go to the Insider dashboard, navigate to Settings > Integration Settings, then find and copy the Segment.com API Key.
5. Enter your Partner Name and API Key in the Insider destination settings in Segment.

If you aren't familiar with the Segment Spec, take a look at the Page method documentation to learn about what it does. An example call would look like:

1
analytics.page("Home", {
2
    url: "https://useinsider.com",
3
    referrer: "http://google.com"
4
});

Segment sends Page calls to Insider as a page view event with the following event parameters.

1
"page_name": "Home",
2
"url": "https://useinsider.com",
3
"referrer": "http://google.com"

If you aren't familiar with the Segment Spec, take a look at the Identify method documentation to learn about what it does. An example call would look like:

1
analytics.identify("userId123", {
2
  email: "john.doe@example.com",
3
  name: "John Doe",
4
  address: {
5
      city: "San Francisco",
6
      country: "USA"
7
    }
8
});

Segment sends Identify calls to Insider as a user insert or update request for the userId123 with the following attributes:

1
"uuid": "userId123",
2
"email": "john.doe@example.com",
3
"name": "John Doe",
4
"city": "San Francisco",
5
"country": "USA"

Insider uses userId, anonymousId, email and phone number as identifiers.

If you aren't familiar with the Segment Spec, take a look at the Track method documentation to learn about what it does. An example call would look like:

1
analytics.track('Product Viewed', {
2
  product_id: '507f1f77bcf86cd799439011',
3
  name: 'Monopoly: 3rd Edition',
4
  price: 18.99,
5
  url: 'https://www.example.com/product/path',
6
  image_url: 'https://www.example.com/product/path.jpg'
7
});

Segment sends Track calls to Insider as a custom event. Only the following Page views are mapped automatically to Insider's default events:

• Product List Viewed
• Product Viewed
• Cart Viewed
• Order Completed.

1
"product_id": "507f1f77bcf86cd799439011"
2
"name": "Monopoly: 3rd Edition",
3
"price": 18.99,
4
"url": "https://www.example.com/product/path",
5
"product_imgage_url": "https://www.example.com/product/path.jpg"

Some Segment Track methods map to Insider's predefined events. These are detected using the event name in the Track event. The table below lists these event names and their Insider mappings.