Comment on page
Segment
Sending form events or answers data to Segment
Segment is by far the most dynamic integration option, which allows you to pick and choose other third - party providers to send data to within Segment.
When the form flow loads, and a Segment integration is enabled, we will call segment's identify method, using the responder UUID as the identification. The remaining events, using
track()
will also include the responder UUID.If you are manually providing the responder's UUID, that will be used instead.
Alternatively, if you'd rather have identify called with the anonymous ID assigned by Segment, you can check Identify with anonymous ID. You will still have the responder UUID within the payload of the event if you need it to do some downstream correlations.
If you'd rather use the user's email as an identifying ID, you can set that option using Use email instead of uuid to identify users.
Use email instead of uuid to identify users is not recommended by Segment since it is easy to have email collisions.
analytics.track('FlowLoaded', {
answers: {},
flowLabel: 'segment-test',
responderUuid: '7f2ee814-6eb2-4607-a0f0-1ccb382dc0ba',
variantLabel: 'main',
variantUuid: '18d59d22-b4b4-4b62-a0f6-0e22861280f9'
});
In the preview window, events are normally not sent to third parties, but are instead logged. When you have Segment connected, you can also verify on the Segment side.
For step-aware flow events, such as
StepLoaded
or StepCompleted
, the step index and step ID will also be sent. Step ID falls back to step index if an ID is not explicitly defined - we recommend setting Step IDs to facilitate analysis, as the index of steps may change over time.analytics.track('StepLoaded', {
answers: {},
flowLabel: 'segment-test',
responderUuid: '7f2ee814-6eb2-4607-a0f0-1ccb382dc0ba',
stepId: 0,
stepIndex: 0,
variantLabel: 'main',
variantUuid: '18d59d22-b4b4-4b62-a0f6-0e22861280f9'
});
By default, no answers are send to Segment.
If the answer state looks like:
answers will just be an empty object.
analytics.track('StepLoaded', {
answers: {},
}
If you check Send answers, then all non-PII answers will be sent along with each event's metadata:
analytics.track('StepLoaded', {
answers: {
"favorite_cat": "Olivia",
},
}
If Send PII is checked, PII answers, such as the responder's email (when it is given that semantic label), will be sent along with the answers:
analytics.track('StepLoaded', {
answers: {
"email": "[email protected]",
"favorite_cat": "Olivia",
},
}
If Stringify answers object in payload is checked, the answers will be sent as a JSON string rather than a JSON object:
If Only send answers from current step is checked, only the answers from the current step will be sent.
- If Hide IP is checked, the IP that Segment normally sends along in the
context
will be replaced with0.0.0.0
, per the - If Hide page context is checked, the values of
path
,referrer
,url
andsearch
will be replaced in thepage
set in thecontext
sent by segment.
Last modified 1yr ago