Skip to main content

Segment integration

Updated over a month ago

Experiences by Jebbit makes it easy to send Identify and Track events in Segment from data collected via your Jebbit Experiences to a specified Source. This Source can then be connected to Segment’s vast library of Connections for a seamless data integration.

Before you begin

  • You will need administrative access to your account to perform these steps.

  • Obtain your Segment Write Key.


How it works?

When a consumer's email is collected in Experiences by Jebbit, the integration sends two events to Segment.

Identify Event

Once a user’s email is collected in Jebbit, an Identify event is sent to Segment. The userId value will be a SHA256 hash of the user’s email address. Jebbit mapped attributes collected from the user, including the plain text email address, are included as traits. Traits will appear as the Jebbit attribute ID you have mapped in Jebbit. See the below example of an Identify Event as it would appear from your Debugger:

{ 
"context": {
"externalIds": [
{
"collection": "users",
"encoding": "none",
"id":
"f320794388bf29dabc846c54fe7ff28f78fc3bc3c13748783335a9bf33440d55",
"type": "emailSha256Hash"
}
]
},
"timestamp": "2021-03-12T00:00:00.000Z",
"traits": {
"email": "[email protected]",
"emailSha256Hash":
"f320794388bf29dabc846c54fe7ff28f78fc3bc3c13748783335a9bf33440d55",
"attribute_id_1": "attribute_value_1",
"attribute_id_2": "attribute_value_2"
},
"type": "identify",
"userId":
"f320794388bf29dabc846c54fe7ff28f78fc3bc3c13748783335a9bf33440d55"
}

Track Event

Once a user’s email is collected in Jebbit, a Track event by the name “Survey Completed” is sent to Segment. The userId value will be a SHA256 hash of the user’s email address. Jebbit mapped attributes collected from the user are included as a property as “questions”. Questions will appear as the Jebbit attribute ID you have mapped in Jebbit. Also included in the properties will be the surveyId (Campaign ID), surveySessionId (Unique Session ID), surveyTitle (Campaign Name), and trafficSource (Source). See the below example of an Identify Event as it would appear from your Debugger:

{ 
"context": {
"externalIds": [
{
"collection": "users",
"encoding": "none",
"id":
"f320794388bf29dabc846c54fe7ff28f78fc3bc3c13748783335a9bf33440d55",
"type": "emailSha256Hash"
}
]
},
"event": "Survey Completed",
"timestamp": "2021-03-12T00:00:00.000Z",
"properties": {
"questions":{
"attribute_id_1": "attribute_value_1",
"attribute_id_2": "attribute_value_2"
},
"surveyId": "n3zrik6g",
"surveySessionId": "y2P5ks05mqzGsdkIGjbQ",
"surveyTitle": "New Quiz",
"trafficSource": "Owned+Web"
},
"type": "track",
"userId": "f320794388bf29dabc846c54fe7ff28f78fc3bc3c13748783335a9bf33440d55"
}

Create a Segment integration

Follow these steps to securely provide Experiences by Jebbit with access for the integration.

Create an HTTP Tracking API Source

  1. Create a Jebbit Source to which Jebbit can send data to. Alternatively, you can choose to use an existing HTTP Tracking API Source if you already have one.

  2. Your Source will have a Write Key associated with it under Settings > API Keys.

Provide your Write Key and Data Geographical location

  1. After you locate your Write Key, copy and paste this value into a .txt file.

  2. Clarify whether you will be collecting EU data, Non-EU data, or both.

  3. Copy the information from the previous steps into your .txt file. Include your name and company name in the name of your .txt file.

Example File

File Name:

John Doe - Company A.txt

Content:

Write Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Non-EU Data

Submit your .txt File via Dropbox File request


Next steps

  • Our Integrations Team will be notified once this information is submitted, and will be in contact with you regarding timelines and testing.

Did this answer your question?