As a default, visitors who answer your survey will be anonymous, but it is easy to add (and we strongly recommend that you do!) an identity and properties to the snippet if you want to track, respond to or segment responses. We refer to this data as a
An identity is the unique information that allows you to track each recipient.
identity_type are required fields, but you can also add a
identity_type is a field that specifies the type of recipient identity, it can be either
custom . Custom identity opens a possibility to pass any type of identity you find meaningful, for example a phone number:
Properties are any other piece of information that you would like to attach to the recipient that will allow you to better respond to and segment your answers.
To add recipient identity and properties simply add hidden inputs inside the
form element, or you can send the data in any other way to the endpoint:
<input type="hidden" name="identity" value="email@example.com">
<input type="hidden" name="identity_type" value="email">
<input type="hidden" name="properties[color]" value="pink">
<input type="hidden" name="properties[device]" value="iPhone">
Values should be dynamically injected depending on backend you are using.
For more technical documentation, see our developer documentation
Solutions to common questions:
Q – Do I have to add an identity and/or properties?
A – We strongly recommend that you add identities and/or properties as it will help you respond to visitors later by storing their information. It is even possible to attach anonymous properties (just leave out any identifying information!)