Form

Form events are designed for standard HTML forms. A simple form might look like this:

<form id="contact-form">
  <input type="text" name="name" placeholder="Your name">
  <input type="email" name="email" placeholder="Your email">
  <input type="submit" value="Submit">
</form>

When configuring form rules, use a stable ID, class, or data attribute. Avoid targeting a form only by its position on the page.

Keyboard

• Key Press fires when a visitor presses a keyboard key. For example, a visitor presses Enter to submit a search or activate a button.

Media

• Media Play fires when media starts or resumes. For example, a visitor clicks Play on an HTML5 video.
• Media Pause fires when a visitor pauses media. For example, a visitor watches a video for 20 seconds and then clicks Pause.
• Media Ended fires when media reaches the end. For example, a visitor watches a video until it finishes.
• Media Loaded Data fires when the browser has loaded media data. This is mainly useful for technical debugging rather than engagement reporting.
• Media Stalled fires when media playback cannot continue. For example, a video pauses because of a slow or unstable connection.
• Media Time Played fires after media has played for a specified time. For example, you can trigger an event after 30 seconds of playback.
• Media Volume Changed fires when a visitor changes the volume. For example, a visitor lowers the volume while watching a video.

Mobile

Mouse

• Click fires when a selected element is clicked. For example, a visitor clicks a Contact Us button, download link, banner, or navigation item.
• Hover fires when a visitor moves the pointer over a selected element. For example, a visitor keeps the mouse over a product image for one second.
• Mousedown fires when the pointer is over an element and the mouse button is pressed. It occurs before Click and is mainly useful for interactions such as drag-and-drop.

Other

• Custom Code fires a rule when your JavaScript calls trigger(). Use it when a built-in event cannot detect the required behavior.

  if (window.location.pathname === "/thank-you") {
    trigger();
  }

• Custom Event fires when the website dispatches a custom browser event. For example, a developer can dispatch an addToCart event after a product is successfully added to the cart.

  document.dispatchEvent(
    new CustomEvent("addToCart", {
      detail: {
        productId: "SKU-123",
        quantity: 1,
        price: 49.99
      }
    })
  );

• Data Element Changed fires when a selected Launch data element changes. For example, a data element storing the selected subscription plan changes from basic to pro.
• Direct Call fires when the website calls _satellite.track(). For example, the website can trigger a rule after a contact form has been successfully submitted.
  _satellite.track("contactFormSuccess", {
    formName: "contact form",
    formId: "contact-form"
  });

• Element Exists fires when a selected element appears on the page. For example, a confirmation message or logged-in navigation element becomes available.
• Enters Viewport fires when a selected element becomes visible in the visitor’s viewport. For example, a visitor scrolls down until a promotional banner appears on screen.
• History Change fires when the browser URL changes through pushState, replaceState, or hashchange. For example, a visitor navigates between pages in a single-page application without a full page reload.
• Time Spent on Page fires after a visitor remains on the page for a specified time. For example, you can trigger an event after 30 seconds.

Page load