Submit

The submit event triggers the action when a form is submitted. See the Options section for more information on customizable event settings.

Keyboard-controlled events

Key Press

The event triggers when a key is pressed. See the Options section for more information on customizable event settings.

Media-based events

Media Ended

The event triggers when the media ends. See the Options section for more information on customizable event settings.

Media-Loaded Data

The event triggers when the media loads data. See the Options section for more information on customizable event settings.

Media Pause

The event triggers when the media is paused. See the Options section for more information on customizable event settings.

Media Play

The event triggers when the media is played. See the Options section for more information on customizable event settings.

Media Stalled

The event triggers if the media stalls. See the Options section for more information on customizable event settings.

Media-Time Played

The event triggers if the media is played for a specified length of time. You must specify the duration that the media must be played for in order to trigger the event. See the Options section for more information on customizable event settings.

Media-Volume Changed

The event triggers if the volume is raised or lowered. See the Options section for more information on customizable event settings.

Mobile-device-orientated events

Orientation Change

The event triggers if the device’s orientation changes. You must specify the duration that the orientation must change for in order to trigger the event. There are no settings for this event type.

Zoom Change

The event triggers if the user zooms in or out. There are no settings for this event type.

Mouse-controlled events

Click

The event triggers if the specified element is selected (clicked). Optionally, you can specify property values that must be true for the element before the event is triggered.

If the element is an anchor tag (<a>) to linked content, you can also specify whether to delay navigation for a period of time. This can be useful if your rule requires extra time to execute and would not normally complete before page navigation takes place.

WARNING
This option should be used with extreme caution due to the potential negative consequences it poses to the user experience if used incorrectly.

When you use link delay, Experience Platform actually prevents the browser from navigating off the page. It then performs a JavaScript redirect to the original destination after the specified timeout. This is especially dangerous when when your page markup has <a> tags where the intended functionality does not actually navigate the user away from the page. If you cannot solve your problem in any other way, you should be extremely precise with your selector definition so that this event will trigger exactly where you need it and nowhere else.

The default link delay value is 100 milliseconds. Please note that tags will always wait for the amount of time specified and is not connected to the execution of the rule’s actions in any way. It is possible that the delay will force the user to wait longer than is necessary, and also possible that the delay will not be long enough for all the rule’s actions to successfully complete. Longer delays provide more time for rule execution but also worsen the user experience.

To enact the delay it is necessary to provide both the selected element that triggers the event, and the specific amount of time before the event is triggered.

For the advanced options see the Options section for more information.

Hover

The event triggers if the user hovers over a specified element. You must also configure whether the rule is triggered immediately or after a specified number of milliseconds. See the Options section for more information on customizable event settings.

Other events

Custom Event

The event triggers if a custom event type occurs. Named JavaScript functions that are defined elsewhere in the codebase can be used as a custom event type. You must specify the name of the custom event type and configure any other settings as described in Options section below.

Data Element Changed

The event triggers if a specified data element changes. You must provide a name for the data element. You can select the data element by either typing its name into the text field, or selecting the data element icon to the right side of the text field and choosing from a list provided within the dialog that appears.

Direct Call

A direct call event bypasses event detection and lookup systems. Direct call rules are ideal for situations where you want to tell the system exactly what is happening. Also, they are ideal when the system cannot detect an event in the DOM.

When defining a direct call event, you must specify a string that will act as this event’s identifier. If a trigger direct call action containing the same identifier is fired, then any direct call event rules listening for that identifier will run.

Screenshot of a Direct Call event in the Data Collection UI

Element Exists

The event triggers if a specified element exists. See the Options section for more information on customizable event settings.

Enters Viewport

The event triggers if the user enters a specified viewport. You must provide a CSS selector as a criteria to target matching elements. You must also configure whether the rule is triggered immediately or after a specified number of milliseconds, and whether the event should trigger every time the event occurs or only the first time.

See the Options section for more information on customizable event settings.

History Change

The event triggers if a pushState or a hashchange event occurs. There are no settings for this event type.

Time-Spent on Page

The event triggers if the user remains on the page for a specified number of seconds. You must specify the number of seconds that must pass before the event is triggered.

Page-load events

DOM Ready

The event triggers when the DOM is ready and the user can interact with the page. There are no settings for this event type.

Library Loaded (Page Top)

The event triggers as soon as the tag library is loaded. There are no settings for this event type.

Page Bottom

The event triggers once _satellite.pageBottom(); has been called. When loading the tag library asynchronously, this event type should not be used. There are no settings for this event type.