As a default, visitors who answer your survey will be anonymous, but it is easy to add an identity and properties to the snippet if you want to track, respond to or segment responses. We refer to this data as a recipient.
An identity is the unique information that allows you to track each recipient. identity and identity_type are a required fields, but you can also add a first_name and last_name. identity_type is a field that specifies the type of recipient identity, it can be either email or custom . Custom identity opens a possibility to pass any type of identity you find meaningful, for example a phone number: identity: '+4900300300' identity_type: 'custom'
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.
A recipient should take the following format and be added after the custom snippet you used to embed the survey on your website:
<script>
var Zenloop = window.Zenloop || {};
Zenloop.recipient = {
identity: 'test@example.com',
identity_type: 'email',
first_name: 'John',
last_name: 'Doe',
properties: {
color: 'red',
height: 100
}
};
</script>
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 – No, these are not required, but will help you to respond to visitors later by storing their information. It is even possible to attach anonymous properties (just leave out any identifying information!)