Connect Segment as a source or destination
Use your Segment events and traits to target Screeb surveys, and send survey displays and answers back to Segment.
Screeb connects to Segment in both directions. As a source, Segment forwards your users’ events and traits to Screeb, so you can target surveys on them. As a destination, Screeb sends an event to Segment each time a survey is displayed or answered, so your other tools get the feedback.
Before you start
Section titled “Before you start”- Both integrations are part of your plan. If a card shows Upgrade to install, your plan does not include it.
- You are an Admin of the Screeb workspace: only Admins install and remove integrations.
- You can add sources and destinations in your Segment workspace.
- If your organization runs on a dedicated Screeb platform, the source page shows “Contact us to connect this integration to your workspace.”: contact us and we connect it for you.
Send Segment data to Screeb (source)
Section titled “Send Segment data to Screeb (source)”- Open Integrations and, on the Segment source card, click Install. The integration is created and its page shows your API key.
- Click Copy next to the key.
- In Segment, add the Screeb destination from the destination catalog, connect it to the source that collects your users’ events, paste the key in its API Key setting and enable it.
- Back in Screeb, choose whether to drop events: turn on Would you like to ignore events from anonymous users? to keep only events that carry a
userId, and Would you like to ignore group events? to skip groups. Click Save.


Reset next to the key creates a new key: the old one stops working at once, so paste the new key in Segment right away.
When the workspace setting Ignore anonymous users is on, the anonymous switch is locked on.
Keep the same identity in Segment and Screeb
Section titled “Keep the same identity in Segment and Screeb”Screeb finds the respondent of each Segment event from its userId, or from its anonymousId when the visitor is not logged in. To keep one profile per person, identify users with the same id in Segment and Screeb, and give Screeb the Segment anonymous id: see User identity across tools.
Send Screeb data to Segment (destination)
Section titled “Send Screeb data to Segment (destination)”- In Segment, create a source of type HTTP API and copy its write key.
- In Screeb, open the Segment destination page.
- In Host, keep Oregon (default), or pick Dublin if your Segment workspace stores its data in the EU region.
- Paste the key in Write key.
- Click Install.

Data exchanged
Section titled “Data exchanged”From Segment to Screeb, as soon as Segment delivers each event:
identify: the traits become user properties.track: the event and its properties, listed in User events, ready for targeting.screen: a screen view.group: the user joins or leaves the group, with its traits.- Traits and groups sent in the context of any event update the user too.
pageandaliascalls are ignored.
New users from Segment count in your plan’s monthly tracked users, like users of the SDK.
From Screeb to Segment, for every survey of the workspace (not messages), as track calls:
Survey seenwhen a survey is displayed.Survey question answeredat each answer, with every answer of the response so far.
The userId is the id Screeb shows for the respondent: the first of its linked ids that is not a UUID (usually the user id you identified), else its first linked id, else its Screeb id. An anonymous respondent known from a Segment anonymousId is therefore sent with that anonymousId as its userId, and only a respondent without linked ids is sent with its Screeb id. The anonymousId is always empty. Properties include the survey, the channel, the response (id, time, language, tags, completion), the respondent’s name, email and groups, the questions and answers, the respondent’s properties at response time, and hidden_field_* and context_* properties.
Troubleshooting
Section titled “Troubleshooting”No Segment events in Screeb. Check that the Screeb destination is enabled in Segment and uses the current key, and that the events carry a userId if an anonymous setting is on. Page views never show, see above.
A visitor shows up twice. Screeb and Segment use different anonymous ids: see User identity across tools.
Disconnect
Section titled “Disconnect”Open the integration page and click More at the top right, then Delete, and confirm with Delete integration. Its configuration is deleted. Also remove the Screeb destination or the HTTP API source in Segment, which would otherwise keep failing.