> ## Documentation Index
> Fetch the complete documentation index at: https://help.getvero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event triggers

> Send automated campaigns when users perform tracked actions in your app or website.

Event-triggered campaigns allow you to send automated marketing emails based on real-time user actions. An event trigger sends a campaign to a user when they performs a specific action that is tracked in Vero using the [Track API](/api-reference/track/overview), one of the [Vero SDKs](/developer-docs/sdk), or one of our [integrations](https://www.getvero.com/integrations/) such as Segment.com.

## Preparing to use event triggers

Before setting up an event-triggered campaign, you must ensure that your project is already tracking user events in Vero. If you haven't set this up yet, follow these steps:

1. [Install the Vero Tracking library](/developer-docs/sdk) - Add the **Vero Tracking API** to your website or app, or set up an integration (e.g., Segment.com).
2. Create a Track API key - An **admin user** must log into your Vero project and generate a **Tracking API Key** in the settings.
3. Track your first event to Vero - Once your tracking setup is complete, send test events to Vero to verify that events are being tracked correctly.

After successfully tracking events, you're ready to create an event-triggered campaign.

## Setting up an event triggered campaign

Once user events are being tracked in Vero, you can create a campaign triggered by any of those events.

Here's how to setup an event triggered campaign:

1. In the Trigger panel of your campaign, click Edit, then select Event Trigger under the "Automated" section. <img src="https://mintcdn.com/vero-c561507b/HPuLSzhpB9G3UI1t/images/vero-2/event-trigger.jpg?fit=max&auto=format&n=HPuLSzhpB9G3UI1t&q=85&s=3371c03cdbf853dc78993d9dc9d1a909" alt="event-trigger" width="2940" height="1964" data-path="images/vero-2/event-trigger.jpg" />
2. From the dropdown menu, choose the event that will trigger the campaign.
   * Example: If you want to send a welcome email when users sign up, select an event like `sign_up`. Users who trigger the selected event will receive the campaign every time they trigger this event.
3. After selecting an event trigger, the **Audience** panel will automatically update to reflect "Users who trigger `sign_up`."
4. Add **Content** to your message:
   * Choose a **channel** (e.g., email, push notification).
   * Set the **From address** and **Subject**.
   * Add body content using one of Vero's content editors.
5. Once all required fields are completed, click **Review and Start** to launch your campaign.
6. Confirm the campaign details and click **Start**. Your campaign status will then be marked as **Live**.

## Personalizing Event-Triggered Messages with Liquid

You can personalize event-triggered messages using Liquid templating to dynamically insert event data into your content. When an event is tracked, the data sent with it can be referenced in your message using `{{ event.property_name }}`.

**Example: Personalizing a Welcome Email**

If a `sign_up` event is tracked with:

```json theme={null}
{
    "eventName": "sign_up",
    "data": {
        "first_name": "Alex",
        "plan": "Premium"
    }
}
```

You can personalize your email like this:

```liquid theme={null}
Hi {{ event.first_name }},

Thanks for signing up for the {{ event.plan }} plan!
```

**Using Conditional Logic:**

```liquid theme={null}
{% if event.plan == "Premium" %}
Enjoy exclusive Premium benefits!
{% else %}
Upgrade to Premium for more features.
{% endif %}
```

For more details on Liquid syntax, visit our [Liquid Personalization Guide](https://www.getvero.com/resources/email-personalization-liquid-guide/).

## Viewing campaign and event activity

Once your campaign is live, you can track its performance in real time using the **Report Summary** and **Insights** page. These reports include key metrics such as:

* Number and % of time the campaign has been **Triggered**
* Number and % of messages **Sent, Delivered, Opened, Clicked**
* A **historical breakdown** and chart of each triggered event and message interaction
* A breakdown of how many times each **link** in the content was clicked

You can also view individual **event logs** in the **Activity** tab, which displays specific event details related to the campaign. To see detailed user profile information, click on a message or event log and then click the **Profile** link.

## Stopping a Campaign

If you need to stop a campaign, click **Stop** in the campaign settings. While stopped, no new messages will be sent, even if users trigger the event.

## Restarting a Campaign

When restarting a campaign:

* Only users who trigger the event **after** the restart will receive messages.
* Events that occurred while the campaign was stopped will **not** trigger messages retroactively.

## Editing a Live Event-Triggered Campaign

You cannot edit an event-triggered campaign while it is **live**. To make changes:

1. **Stop** the campaign.
2. Make your changes.
3. **Restart** the campaign to resume sending messages.