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

# Campaign Audience Limit

> Cap the number of users who receive a campaign in MoEngage based on engagement metrics like sent, delivered, impressions, or conversions.

# Overview

In marketing, controlling campaign reach and expenditure is crucial for effective resource allocation and achieving specific business goals. The **Campaign audience limit** feature in MoEngage empowers you with this control by allowing you to cap the number of users who receive a campaign based on key engagement metrics such as Sent, Impressions, Open, Delivered, and Conversions. This functionality directly addresses the need to manage promotional offers, limit redemptions, and gate access to exclusive content for a defined audience size, ensuring optimal budget utilization.

Furthermore, for recurring campaigns targeting large user segments, the Campaign audience limit enables you to manage the maximum number of users engaged per instance (particularly with the daily and instance-level options), contributing to broader reach over time, even though the system randomly selects users for each instance and some overlap may occur.

# Use Case

Are you looking to stay within your campaign budget cap? The Campaign audience limit feature is just what you need. By setting a specific threshold for the number of users who will receive your campaign, you can ensure that your budget remains intact and avoid exceeding your spending limits. Once the designated number of users has been reached, the campaign will automatically pause, preventing budget breaches.

# Configure Campaign Audience Limit

The **Campaign audience limit** option is available in the **Target Users** step while creating a campaign. You can turn on the toggle to trigger the user limit based on the configuration. <img alt="image (2).png" src="https://mintcdn.com/moengage/50ZszvUJB4M_6y_L/images/moengage_e9c476.png?fit=max&auto=format&n=50ZszvUJB4M_6y_L&q=85&s=c701acc92666afd992075f701f9437f5" width="2854" height="1280" data-path="images/moengage_e9c476.png" />

This feature allows you to set the following campaign audience limits based on the delivery types:

## Total

The campaign will be paused when the events (Sent, Impressions, Open, Delivered, Conversions) have reached the desired limit.

## Daily

The campaign will be paused when the day's events (Sent, Impressions, Open, Delivered, Conversions) reach the desired limit for that day.

## Instance

The campaign will be paused when the events (Sent, Impressions, Open, Delivered, Conversions) from the specific instance have reached the desired limit.

The following table displays the campaign audience limits supported for channels based on campaign delivery types:

| Channel                                                                                                        | Delivery Type                              | Total | Daily | Instance Level |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ----- | ----- | -------------- |
| <ul><li>Push</li><li>Email</li><li>SMS</li><li>WhatsApp</li><li>Cards</li><li>Connectors</li><li>RCS</li></ul> | One time                                   | Yes   | No    | No             |
| <ul><li>Push</li><li>Email</li><li>SMS</li><li>WhatsApp</li><li>Cards</li><li>Connectors</li><li>RCS</li></ul> | Periodic                                   | Yes   | No    | Yes            |
| <ul><li>Push</li><li>Email</li><li>SMS</li><li>WhatsApp</li><li>Cards</li><li>Connectors</li><li>RCS</li></ul> | Event Triggered                            | Yes   | Yes   | No             |
| <ul><li>Push</li><li>Email</li><li>SMS</li><li>RCS</li></ul>                                                   | Business Event Triggered                   | Yes   | Yes   | Yes            |
| <ul><li>In-app</li><li>On-site messaging</li></ul>                                                             | One Time (Continuously Active in duration) | Yes   | Yes   | No             |
| <ul><li>In-app</li><li>On-site messaging</li></ul>                                                             | Periodic (Periodically Active)             | Yes   | Yes   | No             |
| <ul><li>Push</li></ul>                                                                                         | Location-triggered                         | Yes   | Yes   | No             |
| <ul><li>Push</li><li>SMS</li><li>WhatsApp</li><li>RCS</li><li>Connected Apps</li></ul>                         | Event Triggered Flows                      | Yes   | Yes   | No             |
| <ul><li>Push</li><li>SMS</li><li>WhatsApp</li><li>RCS</li><li>Connected Apps</li></ul>                         | Business Event Triggered Flows             | Yes   | Yes   | No             |
| <ul><li>Push</li><li>SMS</li><li>WhatsApp</li><li>RCS</li><li>Connected Apps</li></ul>                         | On Flow Exit Flows                         | Yes   | Yes   | No             |
| <ul><li>Push</li><li>SMS</li><li>WhatsApp</li><li>RCS</li><li>Connected Apps</li></ul>                         | One-time / Periodic Flows                  | Yes   | No    | No             |

# How Does the Campaign Audience Limit Work?

You can configure the campaign audience limit to total, daily, or instance level. The metrics used to calculate and enforce these limits are:

* Sent
* Impressions
* Open
* Delivered
* Conversions

<Info>
  When setting a campaign audience limit based on Impressions or Conversions, note that the campaign might not pause precisely at the specified limit. You may observe a few additional impressions or conversions beyond the set value.
</Info>

### Total

You can set the total campaign audience limit to pause the campaign when the impressions, sent, conversions have reached a desired limit. The following scenarios will help you better understand the total campaign audience limit.

**Scenario 1**

An event-triggered Push campaign must be paused when the total sent count reaches 2000 users.

**User action**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Select **sent** and **total** from the lists.
3. Enter the limit, which is 2000, in the space provided. <img alt="ET push.png" src="https://mintcdn.com/moengage/CaPmX0z_ys8cr0ms/images/moengage_081f87.png?fit=max&auto=format&n=CaPmX0z_ys8cr0ms&q=85&s=105e10378c3ba83fbd526b1df4694272" width="994" height="382" data-path="images/moengage_081f87.png" />

**Observed campaign behavior**

| Total Sent           | Behavior           |
| -------------------- | ------------------ |
| 1500                 | Campaign proceeds  |
| 2000 (limit reached) | Campaign is paused |

**Scenario 2**

A one-time Email campaign limit is 4500 users. When it exceeds, the status will be changed to **SENT.**

**User action**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Enter the limit, which is 4500, in the space provided. <img alt="OT email.png" src="https://mintcdn.com/moengage/rmgWdhG7TCISpEIz/images/moengage_d67c1b.png?fit=max&auto=format&n=rmgWdhG7TCISpEIz&q=85&s=8699f484f158f9c738d056a13ea0a145" width="886" height="382" data-path="images/moengage_d67c1b.png" />

**Observed campaign behavior**

| Total Sent           | Behavior               |
| -------------------- | ---------------------- |
| 1500                 | Campaign proceeds      |
| 4500 (limit reached) | Status changes to SENT |

### Daily

You can set the daily campaign audience limit to pause the campaign when the impressions, sent,  conversions for the day have reached the desired limit. The following scenarios will help you better understand the daily campaign audience limit.

<Info>
  The campaign will automatically pause when the limit is reached and will resume precisely at midnight (12:00 AM) in your campaign timezone.
</Info>

**Scenario 1**

An event-triggered SMS campaign must be paused when the daily conversion count reaches 3000 users.

**User action**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Select **conversions** and **daily** from the lists.
3. Enter the limit, which is 3000, in the space provided. <img alt="ET sms.png" src="https://mintcdn.com/moengage/50ZszvUJB4M_6y_L/images/moengage_e9b3d3.png?fit=max&auto=format&n=50ZszvUJB4M_6y_L&q=85&s=c77b77f5e416c0b88c14f4ea4880040a" width="1024" height="394" data-path="images/moengage_e9b3d3.png" />

**Observed campaign behavior**

| Total Conversions    | Behavior           |
| -------------------- | ------------------ |
| 1500                 | Campaign proceeds  |
| 3000 (limit reached) | Campaign is paused |

**Scenario 2**

A business event-triggered Email campaign must be paused when the daily sent count reaches 2500 users.

**User action**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Select **daily** from the list.
3. Enter the limit, which is 2500, in the space provided. <img alt="BET sms.png" src="https://mintcdn.com/moengage/xeb_76Bworf1GG6P/images/moengage_964e14.png?fit=max&auto=format&n=xeb_76Bworf1GG6P&q=85&s=d248e45c2ad5433067623ee85cf37549" width="812" height="358" data-path="images/moengage_964e14.png" />

**Observed campaign behavior**

| Total Sent           | Behavior           |
| -------------------- | ------------------ |
| 1500                 | Campaign proceeds  |
| 2500 (limit reached) | Campaign is paused |

### Instance Level

You can set the instance-level campaign audience limit to pause the campaign when the impressions, sent, conversions for the specific instance have reached the desired limit. The following scenarios will help you better understand the instance-level campaign audience limit.

<Info>
  At the instance level, the parent campaign will remain active, while the child campaign will be marked as SENT because it has reached its limit.
</Info>

**Scenario 1**

A business event-triggered Push campaign must be paused when the sent count for an instance reaches 1000 users.

**User action:**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Select **instance** from the list.
3. Enter the limit, which is 1000, in the space provided. <img alt="BET Push.png" src="https://mintcdn.com/moengage/4hNKOAjPrnhpJB2_/images/moengage_808d64.png?fit=max&auto=format&n=4hNKOAjPrnhpJB2_&q=85&s=c065269d80244fc8e7d697d861087456" width="850" height="362" data-path="images/moengage_808d64.png" />

**Observed campaign behavior**

| Total Sent           | Behavior           |
| -------------------- | ------------------ |
| 500                  | Campaign proceeds  |
| 1000 (limit reached) | Campaign is paused |

**Scenario 2**

A periodic Push campaign must be paused when the sent count for an instance reaches 4000 users.

**User action:**

1. In the **Target users** step during campaign creation, turn on the **Campaign audience limit** toggle.
2. Select **instance** from the list.
3. Enter the limit, which is 4000, in the space provided. <img alt="P push.png" src="https://mintcdn.com/moengage/epqsPEpMsGQCYy1r/images/moengage_5bb47e.png?fit=max&auto=format&n=epqsPEpMsGQCYy1r&q=85&s=aef9a0f828bcea0921999a87cd517412" width="854" height="364" data-path="images/moengage_5bb47e.png" />

**Observed campaign behavior**

| Total Sent           | Behavior           |
| -------------------- | ------------------ |
| 1500                 | Campaign proceeds  |
| 4000 (limit reached) | Campaign is paused |

If you attempt to resume a campaign that has been automatically paused after reaching its campaign audience limit, the following error message will appear.

<img src="https://mintcdn.com/moengage/xaH8HoR16_YVDek5/images/moengage_d02e5a.png?fit=max&auto=format&n=xaH8HoR16_YVDek5&q=85&s=19e1bf7c11e3f9253ae2fba9d0da908b" alt="manual try max.png" width="906" height="392" data-path="images/moengage_d02e5a.png" />

# Editing Campaign Audience Limit

You can edit the campaign audience limit of a campaign to a higher or lower number whenever necessary. The campaign resumes based on the updated limit. The following table outlines the campaign behavior in response to increasing or decreasing campaign audience limits at different levels.

| Level                 | Scenario                                               | Behavior When Increasing Limit                     | Behavior When Decreasing Limit                                |
| --------------------- | ------------------------------------------------------ | -------------------------------------------------- | ------------------------------------------------------------- |
| Total Level           | Limit is breached                                      | The campaign resumes to reach the new limit.       | You cannot decrease the limit if it has already been reached. |
| Limit is not breached | The campaign continues until the new limit is reached. | The campaign pauses when the new limit is reached. |                                                               |
| Daily Level           | Limit is breached                                      | The campaign resumes to reach the new limit.       | The campaign pauses, and the new limit applies the next day.  |
| Limit is not breached | The campaign continues until the new limit is reached. | The campaign pauses based on the new limit.        |                                                               |
| Instance Level        | NA                                                     | The updated limit applies from the next instance.  | The updated limit applies from the next instance.             |

### Example Scenarios

**Scenario 1: When the Campaign audience limit is increased**

A campaign with a total limit of 2000 users is performing well. The better performance incurred a higher budget for the campaign, which demands a 3000-user count as the total limit.

**User action**

Edit the total limit of 2000 to 3000.

**Observed behavior**

The campaign resumes to reach an additional 1000 users.

**Scenario 2: When the Campaign audience limit is increased**

Due to a budget shortage, the campaign's total limit needs to be reduced from 4000 users to 2000 users.

**User action**

Edit the total limit from 4000 to 2000.

**Observed campaign behavior**

The campaign pauses when the total limit reaches 2000 users.

<Info>
  You can also disable the campaign audience limit if required. After the campaign audience limit is disabled, the campaign will be sent to the entire segment from the following instance.
</Info>

# Campaign Analytics and Info

On the Campaign Analytics page, you can:

* View the campaign performance stats. To do so, navigate to **Engage** > **Campaigns**. In the **All Campaigns** page, search for your campaign. Click the campaign name to access the **Campaign analytics and info** page. In the **Campaign analytics and info** page, navigate to **Analytics > Campaign performance stats**.
* Identify if the campaign has the campaign audience limit enabled. If enabled, the info icon on the **Analytics** tab will have the following message: This campaign has campaign audience limit enabled. This will limit the number of users who will receive the campaign. <img alt="analytics email max.png" src="https://mintcdn.com/moengage/xeb_76Bworf1GG6P/images/moengage_977799.png?fit=max&auto=format&n=xeb_76Bworf1GG6P&q=85&s=278255c00e0df05f7d4f9a51f0ea6373" width="2904" height="1512" data-path="images/moengage_977799.png" />

<Info>
  The Failed count does not include users removed due to the campaign audience limit and the drop is expected. You can view the count of removed users in the error breakdown table.

  <img src="https://mintcdn.com/moengage/UX7SFw6G5JwoHWFq/images/moengage_63b079.png?fit=max&auto=format&n=UX7SFw6G5JwoHWFq&q=85&s=d476304e20a8a62a397848e5883b1781" alt="image (3).png" width="2744" height="720" data-path="images/moengage_63b079.png" />
</Info>

On the Campaign Info page:

* You can view the campaign audience limit defined during campaign creation. To do so, navigate to **Engage** > **Campaigns**. In the **All Campaigns** page, search for your campaign. Click the campaign name to access the **Campaign analytics and info** page. In the **Campaign analytics and info** page, navigate to **Info** > **Audience** > **Target**. <img alt="info email max.png" src="https://mintcdn.com/moengage/wjYnJKL0xml-g3HM/images/moengage_4743bc.png?fit=max&auto=format&n=wjYnJKL0xml-g3HM&q=85&s=f3fe4b6884a872635f35943af557624b" width="1726" height="694" data-path="images/moengage_4743bc.png" />
  <Info>
    In the **Campaign Info** page of WhatsApp campaigns, you can view the campaign audience limit defined during campaign creation in the **Segmentation** card.

    <img src="https://mintcdn.com/moengage/xaH8HoR16_YVDek5/images/moengage_ccb4bf.png?fit=max&auto=format&n=xaH8HoR16_YVDek5&q=85&s=40c98ce6e71306a96d0d99a50e40a088" alt="info whatsapp max.png" width="2346" height="818" data-path="images/moengage_ccb4bf.png" />
  </Info>
* If you edit the campaign audience limit, a new version will be created. The old or new limit will be displayed based on your current version.

<Info>
  The campaign audience limit will be applied at the overall campaign level, not individually to each version.
</Info>
