Segment

​

Overview

Segment, now known as Twilio Segment, is a customer data platform (CDP) that helps you collect, clean, and activate your customer data. Segment establishes a modern customer data foundation and helps you make data driven decisions. Paired with Extole, you can use Segment to target your advocation and engagement programs to specific groups of customers.

​

Prerequisites

​

Segment Destination

Extole supports using a Segment Destination to send events into the Extole Platform. Typically the Segment Destination will work together with Extole Tags to manage a referral experience. Extole recommends the first friend event, such as a friend landing capture, signup form, or purchase, is tracked to Extole using Extole Tags. The Extole tags are able to take advantage of the web context providing the best possible advocate-matching and fraud-detection capabilities. Segment does not pass this data and should be focused on sending offline events or supplementing profiles. From your Segment UI’s Destinations page click on “Add Destination”.

• Search for “Extole Platform” within the Destinations Catalog and confirm the Source you’d like to connect to.
• Drop the API Key—generated in your My Extole account in the Security Center—in your Segment Settings UI.

​

Identify

Identify calls are sent to Extole as an identify event. Extole will create a new profile or update an existing one. Find below a list of basic traits mapping: An example identify call: identify

​

Track

By default, Extole discards all of the track events sent by Segment to the Extole Destination. In order for a track event from Segment to be handled by Extole, your program needs to be set up to listen for particular track events. This setup should occur as part of the launch process by your Solutions Engineer or Support Engineer. The following is an example track call for conversions: userId

​

Extole Segment Source

You can configure Extole as a Segment Source. As a Segment Source, when various events occur in the referral program, Extole will send these events into Segment. There are a standard set of events, but any step within your Extole programs can be configured to send to Segment. In order to setup Extole as a Segment Source you’ll need to create a new HTTP API source in Segment and provide the Write Key to your Extole team. Segment HTTP Source </Image> Segment Write Key </Image>

​

Identify Event

Whenever someone is identified in your Extole program, an identify event is fired. This event includes a unique User ID and any profile attributes for that visitor stored in their Extole profile. People are identified when they share, receive a share message, provide an email address via Extole email capture, or make a purchase. firstName

​

Track Event

When customers perform an action, Extole fires a track event with an event name describing that action. Common events include referred, registered, purchased, and was_referred, but we can accommodate any custom event you might need.

​

Mapping Event Properties

Certain properties, like partner_user_id and partner_conversion_idare mapped automatically. Your Extole team will work with you to ensure any other necessary event properties map to Extole’s.

​

Track Referred Event

The referred event is fired when an Advocate shares via an Extole Share Experience. The following code is an example track call with referred event name: lastName

Field	Description
userId	This is the Extole Partner User Id, which is an identifier that you have passed to Extole that identifies the user.
anonymousId	This is the Extole Profile Identifier which unique identifies a profile at Extole, including anonymous profiles.
channel	Describes which share channel that advocate used to share to their friend and can include: FACEBOOK, TWITTER, MESSENGER, WHATSAPP, PINTEREST, SMS, PERSONAL_LINK.
funnel	Indicates if the event occurred on the ADVOCATE or the FRIEND funnel.
campaign	Indicates the name of the referral campaign.
friend_emails	In the case of an email share channel, the advocate profiles the friend’s email addresses which are returned in this array.

​

Track Registered Event

The registered event is fired when a registration happens. The following code is an example track call with registered event name: other

​

Track Purchased Event

The purchased event is fired when a purchase happens. The following code is an example track call with purchased event name: identify

​

Custom Events

Extole is an events platform where any event in your programs can be routed out of Extole via Webhooks to any other system. The data contained in those events is configurable and can contain any piece of data known about a person or event. If you need to have additional program events sent to Segment or would like to adjust the data being sent in your track events, please work with your Extole Customer Success Manager to create a custom request for Extole Support to implement.