Skip to main content

Quick Actions on Interactive Widgets

Interactive Widgets

Checkboxes

  • A checkbox widget can be checked or unchecked. Repeatedly pressing a checkbox will toggle it between these two states.

  • When submitting, the event name and either the checked or unchecked event value will be sent. For example, if the below checkbox was checked, {info: show} could be sent to your API. Also, the info column in the downloadable .csv file will contain show.

img.png
  • If there are two ore more Checkboxes in a Content with the same Event name, Checked event value and Unchecked event value, they are considered to be the same, and if one of them gets checked or unchecked, the others will follow suit.

  • This way you can have the same checkbox across multiple Pages or add some nice visual effects:

    • Checking a small Checkbox with a label next to it can also make a bigger visualization appear somewhere else.
    • To achieve this, the connected Checkbox has to have a transparent image as its Unchecked src and the visualization as Checked src.
img_2.png
  • Checkboxes can also have a Button group, which can be sent out to API calls, if needed.

  • Also, it will be taken into consideration when deciding if two Checkboxes are identical.

  • A Checkbox can start in "checked" state.

  • It will also reset back to checked when a Submit or Reset button is pressed.

img_3.png
  • You can set visual changes to the checkbox to see it's state.
img_1.png
  • If a Checkbox is unchecked, it will display its Unchecked src image.
  • In addition, you can also turn on these options.
  • They are most useful if the Checked and unchecked src is the same.
  • You can easily set the Unchecked src to match the Checked src by pressing this icon shown below.

Radio buttons

  • Radio buttons usually come in groups.
  • In a group, only one Radio button can be selected (checked) at a time.
  • If one of the buttons in a group is pressed, the others will become unchecked.
  • Repeatedly pressing one Radio button usually won't accomplish anything.
img.pngimg_1.png
  • Radio button's most important properties are Button group and Checked event value.
  • Usually, you want to have multiple Radio buttons with the same Button group and different Checked event values.
  • When submitting, only the one checked Radio button's Checked event value will be sent out as the value belonging to the Button group.
example

With the above two Widgets, the sent out data would either be {direction: left} or {direction: right}, depending on the currently selected one.

  • Regards to starting out Checked, having Shrink, Blur and Grayscale options, Checked src and Unchecked src, they work the same as Checkboxes.

  • Also, identical Radio buttons will become checked to be consistent with the pressed button.

  • Radio buttons also have a Jump to option.

    • Here, you can choose from the other Pages in this Content.
    • When this button is pressed, in addition to becoming selected, the Content will also jump to the selected Page.
    • Also, Event name will be logged into the Content interaction log.
img_2.png
  • You can also turn on Quick submit and choose from the same options as for a Submit button.
  • This can be used in a simple Content, such as a customer satisfaction survey at a checkout line with 3-5 choices, submitting automatically when any of the buttons are pressed.
img_3.png

User input

  • If you need any other input from your users, you can add a User input widget that lets them type in something.

  • It can be useful to get their e-mail address or a comment regarding their order.

  • A User input has an Event name, this will be used in the submitted data.

  • They also have a Button group but if you would use that only in bigger, more complicated Contents, if you really need the separation.

Submit button

A Submit button will submit the value of all the interactive elements in the content. It means the following steps will be executed:

  • The values will be added into the downloadable .csv file

  • The selected type of action will be executed. You can read more about this later in this guide!

  • All the interactive widgets will be reset to their original values.

  • If there is a Jump to target, the Content will jump to that Page

  • The Source for the Submit button is the image that will be displayed.

  • If you turn on Do not reset, the interactive widgets won't be reset to their original values.

  • It can be useful in some cases, for example, if you have Call API as your action and only want to reset if the transaction was successful.

  • In the API response events, you can trigger a hidden Reset button to achieve this.

img_4.png

Reset button

  • Similar to Submit buttons, Reset buttons have a Source image to appear as and an optional Jump to

Table widget cells

  • Embedded Checkboxes and Radio buttons.

Data summary

  • Data summary's main purpose is to help you test your Content while creating it.
  • It will show all the values of the interactive widgets.
  • In some really simple cases, it can also be used in production.

Submit types

  • Different submit types and options are available both on Submit buttons and Radio buttons with quick submit enabled.
  • You can also trigger Submit buttons from Sensor events, this way the selected widget's options will be used.

Default behaviour

  • A submit action will be logged into the downloadable .csv file.

  • You can find it on the Home menu, right-clicking on a content and selecting Content info.

  • Here, you can either download all the available data or clear all or some of the recorded data.

    • You can specify a date.

    • Any data recorded before that will be cleared.

    • If it is left empty, all the data for this Content will be cleared.

    • When downloading, you can specify a range.

    • Only data between these dates will be added to the file.

    • If left empty, all recorded data will be downloaded.

  • You can open this file with any software you usually use to open .xls files (such as Excel).

  • :::caution please note Make sure to select comma as a separator! :::

  • The spreadsheet will contain several columns:

    • Content id
    • Content name
    • Content comment
    • Device id
    • Device name
    • Timestamp are always present.
  • Other columns will be the Button group + Event names of your interactive widgets.

  • Rows will contain the result of individual Submit presses.

img_5.png

E-mail

  • If you select e-mail, you will need to set the receiver e-mail address.
  • This can be set in one place for all the submit actions in the Content.
  • It is located in the left hand menu, around the bottom of the Content section.
img_6.png

Call API

  • If you need a more complicated calculation, need to fetch data from or save data to your own database, etc..., you can call your own API as a submit action.
img_7.png
  • The request will be called as POST, and the request body will contain the widget's values as key-value pairs.

Sensor event

  • Sensor event will send the same data in the same format to the connected sensor interface as it would send as request body to an API.
  • The Use button groups option also works the same.
ⓘ Click here to know more about Sensor events