> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Start conversations using basic proactive campaigns

## Overview\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_Overview]

Basic Proactive Campaigns transform your customer support from reactive
to proactive. Solve issues before they become issues, creating an
unparalleled customer experience. For key pages on your website, think
about common questions, issues, or requests that your customers might
have. Then create a Campaign to proactively address those questions,
issues, or requests.

### Requirements\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_Requirements]

All Ada packages include Basic Proactive Campaigns as a feature;
however, your Ada integration must meet certain requirements before you
can use Basic Campaigns.

* [Embed2](https://developers.ada.cx/reference/add-chat-to-website) –
  Your integration must use Ada’s **Embed2** script. If you’re still
  using Embed1, Proactive Campaigns won’t work.

* Proactive Campaigns supports bots deployed on the web and mobile web.
  Campaigns currently don’t support mobile applications.

* Custom CSS styling of the Ada widget could affect the appearance of
  your Campaigns.

## How Basic Proactive Campaigns work\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_How20Basic20Proactive20Campaigns20work]

The logic behind when to trigger a Basic Proactive Campaign is based on
a URL and simple timing parameters.

If you want to use additional methods to start conversations with your
chatters, as well as Campaign reporting functionality, see [Start customizable interactions using advanced proactive campaigns](/scripted/docs/build-and-maintain-your-bot/create-conversations/start-customizable-interactions-using-advanced-proactive-campaigns).

> **Note**
>
> The types of campaigns you can make vary based on the subscription
> package your organization has. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

## Create a new Campaign\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FDB63SF6FZ2AX2Z0NH5917WY]

How to setup a new Basic Proactive Campaign:

1. On the Ada dashboard, go to **Build** > **Campaigns**.

2. Click **New Campaign**. The Create a new Campaign dialog appears.

3. Add a **Name** and **Description** to the corresponding dialog
   fields.

4. Click **Next**. The dialog disappears to reveal your new Campaign’s
   configuration settings.

![](/_fern-files/_img/43515a47d8ae0aff3b273d80ad73cd4c695af48c8f7902fa943347ad88801b79.webp)

## Configure a new Campaign\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_Configure20a20Campaign]

There are a few configuration options available for your Basic Proactive
Campaign. Let’s look at how to set them up.

![](/_fern-files/_img/b1311b650742022e1f164ed08b6cfce61865797c6f685e38f42d1d4d61c4713d.webp)

### Campaign Triggers\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMA7QAC1BK31JYQJ82M4PFCN]

Campaign Triggers define the parameters in which the Basic Proactive
Campaign will be surfaced. The Campaign will be triggered on any of the
URLs you provide. To add URLs to your Campaign Triggers:

1. Click **+ Add URL**.

2. Select the appropriate URL matching option from the drop-down menu.
   To learn more about URL matching, please see the table here:

   <table>
     <thead>
       <tr>
         <th>
           Option
         </th>

         <th>
           Definition
         </th>

         <th>
           Example
         </th>
       </tr>
     </thead>

     <tbody>
       <tr>
         <td>
           **Exactly Matches**
         </td>

         <td>
           This option will look for the exact match of your URL. Query
           parameters will not be part of the matching logic.
         </td>

         <td>
           Specifying **[https://www.example.com/checkout](https://www.example.com/checkout)** in the configuration will match to **[https://www.example.com/checkout?q=hello](https://www.example.com/checkout?q=hello)** and **[https://www.example.com/checkout/](https://www.example.com/checkout/)**
         </td>
       </tr>

       <tr>
         <td>
           **Contains**
         </td>

         <td>
           This option will match URLs that contain your specified string anywhere in the URL. Query parameters containing your values.
         </td>

         <td>
           Specifying **example** in the configuration will match to **[https://www.example.com/checkout](https://www.example.com/checkout)** and **[https://www.hello.com?q=example](https://www.hello.com?q=example)**
         </td>
       </tr>

       <tr>
         <td>
           **Ends With**
         </td>

         <td>
           This option will match URLs ending with your specified string. Query parameters will be ignored for this option.
         </td>

         <td>
           Specifying **/checkout** in the configuration will match to **[https://www.example.com/checkout](https://www.example.com/checkout)** and **[https://www.hello.com/checkout?q=example](https://www.hello.com/checkout?q=example)**
         </td>
       </tr>

       <tr>
         <td>
           **Regular Expression**
         </td>

         <td>
           This option gives you full control in specifying the matching URLs using the [regular expression pattern matching language](https://regex101.com/) over the full URL, including query parameters.
         </td>

         <td>
           Specifying **`product[0-8]+[^9]*$`** will match any page that includes the string ‘product’ and any number of any length afterwards, as long as the number 9 never appears.

           Specifying **`^https:\/\/acme\.com(?!.*\/(promo|pricing)$).*$`** will match on all [https://acme.com](https://acme.com) pages except for those ending with /promo or /pricing.
         </td>
       </tr>
     </tbody>
   </table>

3. Input the full URL or URL component.

4. Repeat for additional URLs where you want the Campaign to be
   triggered.

5. Click to select when the trigger will initiate,

   * When the page loads

   * After a delay (customizable in seconds or minutes)

6. Click to identify how long the Campaign is shown to customers,

   * Show indefinitely

   * Dismiss after a set time (customizable in seconds or minutes)

### Campaign Content\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMA7QSYTZN7GGKCS9SPCEXCV]

Campaign Content is the messaging for your Campaign. There are two parts
to Campaign messaging. First, craft a proactive message your web
visitors see pop out from the chat button on your webpage. Interested
visitors can click the message or the chat button to engage your bot.
The bot then opens the conversation with your chosen follow up message.
This message is a bot Answer that you can tailor specifically for this
campaign.

* Add the proactive message to the text field. This is what displays to
  your web visitors when the Campaign triggers.

* Click the drop-down menu and select an Answer to display as the
  follow-up message. This is the custom greeting the bot opens the
  conversation with.

![](/_fern-files/_img/7aefce4a9893177e0275322f6c482f5ceca528089fa8b1cd2d67a5acc8dce812.webp)

### Embed code\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMA7R35H1QBYGXMBR9N484GB]

You must include the Ada Embed Code on every webpage where you want to
trigger this Campaign. Learn more about [Ada Embed2](https://developers.ada.cx/reference/add-chat-to-website).

## Publish Campaign\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMA7RBEBMDRV2JQ8ZTJ98WXC]

If you want to continue making changes before publishing the Campaign,
click **Save For Later**. If you are ready to launch the Campaign, click
**Publish**.

## Prioritize Campaigns\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMA7RBEBMDRV2JQ8ZTJ98]

A webpage can only surface one Campaign at a time. It is possible,
though, for a webpage to have two or more Campaigns assigned to it. In
this case, rank your Campaigns based on priority. That way your website
visitor only encounters the Campaign you want them to see.

To reprioritize your Campaigns:

1. Go to **Build** > **Campaigns**.

2. Click **Prioritize**.

3. In the Set Priority dialog, drag and drop your Campaigns to reorder
   their priority.

4. Click **Save**.

### How prioritization works\[#UUID-ffeeb7b7-31e2-c52a-82df-a3671992340f_id_4410370067731_id_h_01FMAXEJZWARZH3G73SCD8GYKN]

Let’s say you have two Campaigns:

* Campaign 1—Free Shipping. This is assigned to the base URL
  `www.test.com`.

* Campaign 2—10% Discount. This is assigned to the specific URL
  `www.test.com/promo`.

As you can see, both Campaigns are valid for the specific URL
`www.test.com/promo`. But you want to make sure that, on that page, your
site visitors only ever see the 10% Discount Campaign. You do this by
moving the 10% Discount Campaign to position 1 in the priority list.
Now, any visitors to this specific URL are shown only the 10% Discount
offer.

![](/_fern-files/_img/f5ae246704dc7743206c3628fa3eee502ba7d4d8bdf3d0c467cf957a9b847f2e.webp)

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).