Skip to main content
All CollectionsCollectEmail Embed Channel
Adding Recipient Identities and Properties to Email Embedded Survey
Adding Recipient Identities and Properties to Email Embedded Survey

How to add recipient identities and properties to your Email Embed surveys

L
Written by Lisa Rentrop
Updated over a week ago

As default, answers to your survey will be anonymous - but it's easy to add Identities & Properties to your feedback to allow you to track, respond to or segment responses.

Content:

Definitions

  • Identities are the unique identifying information for the customer (aka recipient). For example: email, order_id or customer_id

  • Properties are any additional information attached to each recipient. For example: delivery provider, order_id or payment type

  • The Recipient is the person answering the survey

Adding Identities to the Recipient

https://responses.zenloop.com/web/response/<survey_hash_id>/
email_embed/10?identity=test@example.com&identity_type=email
&first_name=john&last_name=brown

  • Required: identity is dynamically injected. The placeholder depends on the system you're using

  • Required: identity_type is either email or custom for everything else. Tip: a custom identity allows you to pass any type of identity like an order id

  • first_name is dynamically injected. The placeholder depends on the system you're using

  • last_name is dynamically injected. The placeholder depends on the system you're using

Adding Properties to the Recipient

Single value:

&properties[color][]=red&properties[country][]=DE

Multiple value:

&properties[color][]=red&properties[color][]=blue

The values are dynamically injected. The placeholder depends on the system you're using.

Example

Identities and properties should take the following format and be added after each scoring link:

https://responses.zenloop.com/web/response/<survey_hash_id>/email_embed/10?is_a_test=false&identity=test@example.com&identity_type=email&first_name=john&last_name=brown&properties[color][]=red&properties[country][]=DE

For more technical documentation, see our developer documentation


Solutions to common questions:

Q – Do I have to add 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!)

Q – Is there a limit to the number of values a property has?

A – The limit is 50


Did this answer your question?