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

# Audiences

> Create targeted customer segments for personalized campaigns

Audiences (also called Segments) let you group customers based on shared characteristics. They're the foundation of targeted, personalized marketing in RevBridge AI.

## Overview

Access Audiences from **Definitions → Audiences** in the sidebar. Here you can:

* View all existing audiences
* Create new audiences
* Edit audience definitions
* See audience sizes

## Creating Audiences

Click **Create Audience** to start the audience builder. You'll choose from three creation methods:

### Manual Rules

Define audiences using conditions on customer attributes and behavior.

<Steps>
  <Step title="Name Your Audience">
    Give your audience a descriptive name (e.g., "High-Value Customers", "Cart Abandoners")
  </Step>

  <Step title="Add Conditions">
    Build rules using the visual condition builder
  </Step>

  <Step title="Preview Size">
    See how many customers match your criteria
  </Step>

  <Step title="Save">
    Save the audience definition
  </Step>
</Steps>

#### Condition Types

| Type         | Description                  | Example                                |
| ------------ | ---------------------------- | -------------------------------------- |
| **Property** | Based on customer attributes | `Total Revenue > $500`                 |
| **Event**    | Based on customer actions    | `Has "purchase" event in last 30 days` |
| **Segment**  | Based on other segments      | `Is in "Newsletter Subscribers"`       |

#### Operators

| Operator         | Use With      | Example                                 |
| ---------------- | ------------- | --------------------------------------- |
| `equals`         | Text, numbers | `Country equals "USA"`                  |
| `does not equal` | Text, numbers | `Status does not equal "unsubscribed"`  |
| `greater than`   | Numbers       | `Purchase count greater than 3`         |
| `less than`      | Numbers       | `Days since last purchase less than 30` |
| `contains`       | Text          | `Email contains "@gmail"`               |
| `is set`         | Any           | `Phone is set`                          |
| `is not set`     | Any           | `Birthday is not set`                   |

#### Combining Conditions

Use **AND** and **OR** logic to create complex rules:

```
(Total Revenue > $500 AND Purchase Count > 3)
OR
(VIP Tag = true)
```

### CSV Import

Upload a list of customer emails to create a static audience.

<Steps>
  <Step title="Prepare CSV">
    Create a CSV with a column containing customer emails
  </Step>

  <Step title="Upload File">
    Drag and drop or click to upload
  </Step>

  <Step title="Map Email Column">
    Select which column contains the email addresses
  </Step>

  <Step title="Name and Save">
    Give the audience a name and save
  </Step>
</Steps>

<Info>
  CSV audiences are **static**—they don't update automatically. To add new customers, re-upload the CSV.
</Info>

### Shopify Integration

Create audiences based on Shopify data:

* **Shopify Customer Segments**: Import existing Shopify segments
* **Shopify Events**: Build rules using Shopify-specific events
  * Customers who abandoned checkout
  * Customers with specific order tags
  * Customers who bought specific products

## Audience Types

### Dynamic Audiences

Audiences created with rules are **dynamic**:

* Membership updates automatically as customer data changes
* A customer enters the audience when they meet the criteria
* A customer exits when they no longer meet the criteria

### Static Audiences

Audiences created from CSV imports are **static**:

* Membership is fixed at the time of creation
* Customers don't automatically enter or exit
* Must be re-uploaded to update membership

## Viewing Audiences

The audience list shows:

| Column           | Description                      |
| ---------------- | -------------------------------- |
| **Name**         | Audience name                    |
| **Type**         | Dynamic or Static                |
| **Size**         | Current customer count           |
| **Created**      | Creation date                    |
| **Last Updated** | When the definition last changed |

Click on an audience to see:

* Full definition (rules or import details)
* Customer list
* Campaigns using this audience

## Editing Audiences

To modify an audience:

1. Click on the audience name
2. Click **Edit**
3. Modify the rules or settings
4. Save changes

<Warning>
  Editing a dynamic audience immediately affects its membership. Customers may enter or exit based on the new rules.
</Warning>

## Common Audience Examples

### E-commerce Audiences

| Audience              | Definition                                                                      |
| --------------------- | ------------------------------------------------------------------------------- |
| **Cart Abandoners**   | Has "cart\_abandon" event in last 7 days AND no "purchase" event in last 7 days |
| **First-Time Buyers** | Purchase count equals 1                                                         |
| **Repeat Customers**  | Purchase count greater than 1                                                   |
| **High-Value**        | Total revenue greater than \$500                                                |
| **At-Risk**           | Days since last purchase greater than 60 AND Total revenue greater than \$100   |
| **Browse Abandoners** | Has "product\_view" event in last 3 days AND no "purchase" event in last 3 days |

### Engagement Audiences

| Audience                | Definition                                      |
| ----------------------- | ----------------------------------------------- |
| **Engaged Subscribers** | Email open count in last 30 days greater than 2 |
| **Inactive**            | Days since last event greater than 90           |
| **New Customers**       | Created date in last 30 days                    |

## Using Audiences

Audiences can be used throughout RevBridge AI:

### In Campaigns

Select an audience when creating a campaign to target those specific customers.

### In Analytics

Filter reports by audience to understand segment-specific performance.

### As Building Blocks

Use audiences as conditions in other audience definitions for complex targeting.

## Best Practices

### Keep Audiences Focused

Create audiences around specific behaviors or characteristics:

* ✅ "Abandoned Cart Last 7 Days"
* ❌ "People We Should Email"

### Name Descriptively

Use clear, descriptive names that explain who's in the audience:

* ✅ "High-Value Repeat Customers (>\$500, 3+ orders)"
* ❌ "Segment 1"

### Review Size Regularly

Monitor audience sizes:

* Shrinking audiences may indicate a problem with your rules
* Growing audiences may need subdivision for better targeting

### Avoid Over-Segmentation

Too many small audiences can complicate campaign management. Start broad and refine as needed.

<Tip>
  The AI Campaign MAB algorithm optimizes across your entire audience. You don't need to create micro-segments for testing—the AI handles personalization at the individual level.
</Tip>
