Which parameters can be defined for website widgets?

When editing your survey, you can switch to the "Embed" tab and select "Website". You will be provided with a line of code of the following form:

< script src="//feedback.callexa.com/widget/slideup/sdFLjkLsG?email=">< /script>

Using this code, your visitors will be able to participate in your survey directly from your website. By default no personal data is transmitted, and the received ratings will be anonymous. Now lets say your website uses accounts, and the visitor is logged in to his account. So your server can provide certain information, like the email address or name of the visitor. You can optionally append such data to the script source above, so the reply is no longer anonymous. The following parameters are available:

• email
• salutation (0 = unknown, 1 = male, 2 = female)
• firstname
• lastname
• relation (some unique attribute identifying the client entry, e.g. the account id)
• custom1 (secondary data, any info you want to attach to the client entry, max length is 255 characters)
• custom2
• custom3
• custom4
• custom5
• tags (separated by semicolon)

The "tags" part needs further explaining. Remember you can set tags (e.g. Service, Shipping Time, etc.) for your survey and the participants will be able to rate those tags on a 5 star scale? That is one way to use tags. Another way would be to append tags to replies for internal use, which are not shown in the survey.

Here is an example on how to include the visitors email and tags with the responsible customer service agent's name and a service category.

< script src="//feedback.callexa.com/widget/slideup/sdFLjkLsG?email=john@doe.com&tags=Logistics Department;Michael Anderson|auto">< /script>

Please note how tags must be formatted. Individual tags are separated by semicolons. Optionally, a rating can be predefined for each individual tag. To do this, use this separator | (example: "Service|5") on a scale from 1 to 5. If you use "auto" instead, the tag rating is derived from the general NPS score. Thus, in this example, "Logistics Department" is appended to the reply and the employee "Michael Anderson" is rated according to the survey score. For example, if the participant gives an NPS score of 8 in the survey, the tag rating of "Michael Hoffmann" is saved with 4 stars. A statistical evaluation of all employees with their average rating can therefore be carried out via the tag cloud.

Often those values are dynamic, coming from a server side programming language. So you must replace the values with the matching placeholders, e.g. in PHP:

< script src="//feedback.callexa.com/widget/slideup/sdFLjkLsG?email=< ?= $email ?>&tags=< ?= $department ?>;< ?= $agent ?>|auto">< /script>

We are happy to answer any questions you may have about Callexa Feedback. Please do not hesitate to contact us.