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.
Add your credentials in the platform
Once you have the required credentials and endpoint details, add them directly to your integration in the platform.
Note: All integration credentials are now managed directly within the platform. From the Integrations module, you can name your integration, enter the required credentials, and configure your field mappings — no file submission required.
Next steps
Our integrations team will be notified once your integration is configured, and will be in contact regarding timelines and testing.