Overview
The Action Widget provides a simple way to configure "if this happens, then do that" situations on campaigns. It does so by providing a list of all of the events that the widgets on your campaign can initiate, and allows you to set up actions to take when these events occur.
The list of events and actions available to the Action Widget depends on the widgets already on your campaign, which means it's best to configure the Action Widget last, after adding and configuring all of the other widgets you’re going to use.
Setup
- Select a Widget Event using the drop-down menus under IF.
a. Select the widget that you want to create actions for.
b. Select the event that the actions will respond to. - Select actions to take using the drop-down menus under THEN.
a. Select the widget that should take an action when the event occurs.
b. Select the action that the widget should take.
Additional actions can be configured by clicking the "Add Action" button.
Events
Widget Events are triggered when something happens on a widget. Not all widgets have events, and not all interactions have events associated with them. This table is a short list of widgets and the events they create:
Widget Name | Events |
Form Widget | Form is submitted, Form has an error |
Like Widget | Is Liked* |
MailChimp Newsletter Widget | Form is submitted, Form has an error |
RSS Widget | Feed is updated** |
Voting Widget | Vote is received, Entries are loaded** |
Video Widget | Video is played, Videos are loaded**, Video is changed |
* Only works when the Like Widget is configured not to reload the page when clicked - see the "Like Widget's Advanced Options section".
** Feed items are loaded when pagination is used on certain widgets and when data is refreshed.
Actions
Actions are the different ways you can configure widgets on your Campaign to respond to events. The most common widget actions are shown in the table below. Note that not every widget has every action available to it.
Action | Description |
Show | If the widget’s visibility is set to “Starts Hidden,” attempt to show the widget. |
Hide | If the widget is visible, attempt to hide it. |
Popup Share Prompt | If the widget has sharing configured, attempt to show the share prompt in a popup. |
Popup Widget | If the widget is configured to display in a popup, attempt to display the popup. This is often best used along with the “Scroll to Widget” action. |
Scroll to | Attempts to scroll the browser to the specified widget. The widget must be visible before the browser can scroll to it. |
Note: This is not a full list. Some widgets have more specific actions that can be taken.
Special Considerations
The order of the actions makes a difference in more advanced configurations. For example, consider an Image Widget that's set to Starts Hidden. The Action Widget can be configured to both show the Image Widget and scroll to the Image Widget, but if the Action Widget attempts to scroll to the Image Widget before it has been shown, the browser may not scroll to the expected location.