On-site messages obects

To add content to your on-site messages (text, media, or interaction elements), you can use the numerous objects available in the editor.
Simply drag objects into the workspace and configure the related options that appear automatically once dragged.

The available objects are:

	Header	It is composed of a title and a text block
	Text Field	Allows visitors to enter text (e.g., to ask for the visitor's email address).
	Checkbox	Used to accept or deny an option (e.g., to request acceptance of a privacy policy).
	Privacy Text	Adds a block of text formatted graphically as a disclaimer (can be used, for example, to display the full text of a privacy policy).
	Button	Adds a button.
	Spacing	Adds empty space between two objects.
	Image	Adds an image.
	HTML text	Adds a block of plain text.
	Error box	Show error message blocking.
	Multiple choice	Allows you to choose one or more options from those proposed.
	Single choice	Allows you to choose only one option from those proposed.
	Menu a dropdown menu	Adds a dropdown menu. Menu options can be linked to specific database fields.
	Text Area	Allows the visitor to add multiline text.
	Number field	Allows the visitor to enter a number.
	Date field	Allows the visitor to enter a date.
	Matrix	Shows an array of values.
	Captcha	Adds a Captcha control. The visitor is asked to copy the alphanumeric code shown in the image to confirm completion.

Many objects, once dragged onto the workspace, require the configuration of some Parameters that can be accessed by clicking the pencil icon.

Header

To edit the contents of this object, click the pencil symbol and access the text content editor.

Text field

After dragging the object into the work area, the window will open configuration of its options.

• Question Text: 
  Question text displayed to visitors;
• Name for Reports: 
  Label that identifies the question exclusively in platform reports and will not be displayed to visitors;
• Link to a Database Field: 
  If you enable this option, the value entered in the field will be saved in a contact field in the database. You will also need to configure the two options:
  • Contact Field: 
    Choose the database contact field where the values ​​entered in this field will be stored;
  • Error Message: 
    A message that will be displayed in cases of incorrect entry. If you select the Default value, the following message will be displayed: "The value for the field [field_name] is not it is valid." If you choose the Custom value, you will be prompted to customize the message text.
• Field Format: 
  By selecting none, the field will accept any sequence of characters entered. Otherwise, it will perform a consistency check on the entered value to ensure it complies with the chosen field type. The available field formats are:
  • Email Address;
  • List of Values: 
    You are prompted to enter the accepted values ​​for the field;
  • Integer Number: 
    By choosing this option, you can also configure the minimum and maximum accepted limits;
  • Number Decimal:
    You can set the number of decimal places accepted;
  • Phone Number;
  • Minimum/Maximum Number of Characters:
    You can set the minimum and maximum number of characters that can be entered in the field;
  • Italian ZIP Code:
    The field will only accept a 5-digit numeric value;
  • Calculated Expression
    The field will accept the result of an expression.
• Default Answer:
  This is the answer that will be entered by default in the field;
• Answer Length:
  Enter the maximum number of characters accepted in the field;
• Mandatory response:
  If you enable this option, the visitor must fill in the field;
• Error message:
  allows you to customize the error messages displayed to the contact;
• Error message management:
  Choose the position where error messages are displayed:
  • Next to the field;
  • In the Errors box;
  • Next to the field and in the Errors box;
  • Do not show errors.

Checkbox

The check box allows you to select or not a single option. You will need to configure the following options already illustrated for the Text field:

• Question text;
• Name for reports;
• Link to a database field;
• Response required;
• Error Message Management.

You can also configure a default response.

If the user does not change the proposed value, the default response will be saved.

Privacy Text

The Privacy Text object is a block of text formatted to be recognizable as disclaimer.
It does not require any special configuration.

Button

The graphic settings for the Button object must be defined in the "On-site Message Styles" section.
In the specific object configuration, you will need to configure:

• Label:
  The text that will be displayed on the button;
• Name for the report:
  Label that identifies the object in platform reports. It is not displayed to the user;
• Type:
  The object can appear as a button or a link;
• Background Image:
  The button color will be replaced by the selected image.

Multiple Choice

The Multiple Choice object allows the visitor to choose either or more preferences among those indicated in the proposed list. It will need to be configured:

• Question text: 
  The text of the question linked to the options to choose;
• Name for reports: 
  A label that identifies the question exclusively in platform reports. It is not displayed to visitors;
• Link to a database field: 
  By enabling this option, the user's choices will be stored in a database field;
• Field format: 
  The field formatting can be:
  • Simple: 
    Define the possible answers and the values ​​to assign to each individual answer;
  • Starting from a custom table: 
    You can select an existing table and within it a column in which to display the Answers and Values;
  • Starting from a filter on a custom table: 
    You can select the values ​​to show to visitors using a filter query;
  • Using the Values ​​of a database contact field: 
    You will need to select the field containing the options to show to visitors.
• Default answer: 
  You can propose a default answer. If the visitor does not express a preference, the default value will be recorded. Default answer;
• Answer layout: 
  Answers can be displayed vertically or horizontally;
• Randomize answer order: 
  If you enable this option, the answer options will be displayed to visitors randomly;
• Fixed answer order:
  This option ensures that some answers remain in a fixed order even if the option to randomize the answer order has been enabled (for example, to always keep the other option last).
  For example, if you want to keep the first and third options fixed, you would type 1,3.
• Mandatory answer
  If you enable this option, the visitor must You must provide an answer to this question.
• Error Message
  You can customize the error message displayed to contacts if you have enabled the Mandatory Answer option.
• Enable Response Number Validation
  Sets the number of responses the user must select.
• Error Message
  You can customize the error message that will be displayed when a contact does not respond to the configured number of required responses.
• Error Message Management
  This option allows you to choose where error messages will be displayed, choosing between:
  • Show next to field;
  • Show in error box (this choice will be Valid only if you have added an Error Box object to the page);
  • Show next to the field and in the Error Box;
  • Do not show errors.
• More options
  This link allows you to activate the options to Reload the page if the user changes one or more answers and to apply Compatibility with obsolete browsers. In this case, however, an obsolete HTML standard will be applied.

Single Choice

A single-choice question allows the visitor to choose only one answer from those available.
The configuration of the single-choice question is identical to that of the multiple-choice question described previously.

Drop-down menu

The Drop-down menu allows the user to choose a value from those proposed from a drop-down menu. HisThe configuration is identical to that of the Multiple Choice Question described previously.

Text Area

The text area is a field where the visitor can enter text longer than one line. In addition to the fields described above, you will need to configure the options:

• Field Format:
  • None: 
    No checks are applied to the values ​​entered in the field;
  • Minimum / Maximum Number of Characters: 
    You can set the minimum and maximum number of characters accepted in the field;
  • Regular Expression: 
    The character limit is calculated based on an expression.
• Area Length/Height: 
  You can set the length and height of the area. The length is calculated in characters, the height in lines.

Number field

This object inserts a field for the visitor to enter numeric values (integers or decimals). You will need to configure the parameters for:

• Field format: 
  The values ​​entered can be integers or decimals (in the latter case, you will also need to define how many decimal places the number will have);
• Minimum / Maximum Value: 
  Enter the minimum and maximum values ​​the field can accept.

Date Field

The date field allows you to enter a date. In addition to configuring the fields described above, you will need to configure:

• Date format: 
  The valid format for entering a date;
• Set "current date" as default: 
  If you enable this option, the visitor will see the default date of the day they are filling in the field. If it is not enabled, you can customize a default date by entering it in the appropriate field Default response;
• Valid date from / until: 
  In these two fields, you can enter the time limits (from..., until...) accepted in the field.

Matrix/Rating Scale

The Matrix/Rating Scale object creates a table that can assign a value to each element described in the rows of the table itself. This object's configuration includes:

• Question text:
  The text displayed before the table;
• Name for reports:
  A label that identifies the question exclusively in platform reports. This label is not displayed to visitors;
• Type:
  Choose the type of matrix you want to create. You can select a Single Choice Matrix, a Multiple Choice Matrix or a Rating Scale;
• Rows (Labels): 
  Define the row elements that will be displayed to visitors;
• Rows (Report Labels)
  Enter the names that will identify the row elements, exclusively in platform reports. This text will not be visible to visitors;
• Columns (Labels)
  Define the column values ​​associated with the row values. In the Columns field, enter the options as they will be displayed to your contacts. In the Values field, enter the actual numeric value assigned to each option;
• Accept only one answer per column: 
  If this option is enabled, the user can only provide one answer per column;
• Randomize answer order: 
  If this option is enabled, the answer options will be displayed in random order for each user;
• Column label position: 
  You can display the column labels as Column headers or Repeated in each cell;
• Mandatory answer: 
  If you enable this option, this field is mandatory;
• Error message handling
  You can select the position where error messages will be displayed.

Captcha

The Captcha object allows you to insert a Captcha-type control code in the on-site message.
To verify that the form has not been filled in by an automatic system, the visitor must enter the code shown in the image. You will need to configure:

• Question text: 
  The text displayed before the text entry area;
• Name for reports: 
  A label that identifies the question exclusively in reports. It is not visible to visitors.
• Error message: 
  This option allows you to customize the error message displayed when an incorrect code is entered.
• Type: 
  You can choose whether to use the Captcha generated by the platform or the Google ReCAPTCHA v2 (verifies requests with a test) provided by Google. To use this type of code, make sure you have configured it in the Setup section of the journey in which you are creating your Survey.

• Number of characters: 
  number of characters in the code (minimum 4, maximum 15 characters);
• Length: 
  Length (in pixels) of the Captcha. The length must be a minimum of 100 and a maximum of 500 pixels;
• Height: 
  Maximum height of the Captcha. The height can be a minimum of 45 and a maximum of 200 pixels;
• Text Color: 
  Set the color of the Captcha Code text. Clicking on the color shown in the box will open the color picker where you can choose a new color;
• Background Color: 
  Change the background color of the Captcha;
• Layout: 
  Define the code's position;
• Error Message Management: 
  Define the position of the message that appears if the code is entered incorrectly (Next to the field, In the Error Box, Next to the field and in the Error Box, Do not show errors).