# Custom Events from Scene and Push Actions

Track user interactions that matter most with Custom Events from Scenes and push notifications.

For [Scenes](https://www.airship.com/docs/reference/glossary/#scene), emit an event when a user taps a button, image, or screen. For [Push Notifications](https://www.airship.com/docs/reference/glossary/#push_notification), emit an event when a user taps the message or a button within the message. You can add a new event when configuring the action or select an existing event.

This enhancement makes it easier than ever to track user behavior, measure the true impact of your Scenes, and create connected, multi-step experiences for your users.

Here are the key improvements you'll find:

* **Clearer UI** — The user interface now clearly states that you can emit a Custom event directly from a button tap.

* **Connected experiences** — You can easily connect user actions by triggering follow-up experiences. For example, a "Show Me How" button in a help Scene can emit a `start_product_tour` event, which can then launch a separate experience.

* **Better conversion tracking** — You can measure the direct impact of your Scenes. For instance, a "Buy Now" button in a promotional Scene can emit a `promo_scene_clicked` event. You can use this to build a specific funnel report to track how many users who clicked that button actually completed the purchase, giving you clear conversion ROI.

* **Screen-level interaction reporting** — We added an Interactions table to the [Scene Detail](https://www.airship.com/docs/guides/messaging/in-app-experiences/scenes/create/scene-reports/#scene-detail) section of a Scene report that lists click/tap counts for each screen.

## Configuration

![Emit a custom event when a user interaction occurs](https://www.airship.com/docs/images/whats-new/emit-custom-event_hu_32b4b0317a544789.webp)

*Emit a custom event when a user interaction occurs*

When configuring content in the Dashboard, after selecting an action:

1. Select **Configure options**.
1. Under **Options**, select **Emit custom event** and search for an event. If no result is found, select **Use \<event name>**.
1. (Optional) Set an event value and/or specify property values to filter by in segments and triggers:
   1. Select **Add event properties**, then:
      * For a value, select **Add event value** and enter a numeric value for the event.
      * For properties, select **Add property**, then **Search for properties**, and then search for a string, number, or boolean event property and enter or select a value.
   1. Select **Save**.

To use properties, you must define the event and its properties in your project in advance. To emit Custom Events from the API, use the [add_custom_event](https://www.airship.com/docs/developer/rest-api/ua/schemas/push/#actionsobject) notification action.

## Requirements and documentation

For Scenes, see [Emit a Custom Event](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/#emit-a-custom-event) in *Actions* for Scenes. For push notifications, minimum SDKs iOS 20 and Android 20 are required. See [Creating content](https://www.airship.com/docs/guides/messaging/messages/content/app/push-notifications/#creating-content) in *Push Notification Content* and [Buttons (App)](https://www.airship.com/docs/guides/messaging/messages/buttons/) in *Optional Features*.