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
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.
Your Source will have a Write Key associated with it under Settings > API Keys.
Provide your Write Key and Data Geographical location
After you locate your Write Key, copy and paste this value into a .txt file.
Clarify whether you will be collecting EU data, Non-EU data, or both.
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
For security reasons, we ask that you transfer the information from your .txt file via Dropbox File request. Please submit your file using this URL.
Next steps
Our Integrations Team will be notified once this information is submitted, and will be in contact with you regarding timelines and testing.