> For the complete documentation index, see [llms.txt](https://appsetup-eng.gitbook.io/appsetup-popups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appsetup-eng.gitbook.io/appsetup-popups/getting-started/campaigns-page.md).

# Campaigns Page

## Campaigns Page Overview

The Campaigns Page is your dedicated hub for managing reward campaigns. Reward campaigns give you the flexibility to offer a variety of rewards with defined win probabilities, rather than using a single fixed reward for all customers. On this page, you can view all existing campaigns, create new ones, and edit or delete campaigns as needed.

***

## Creating a New Campaign

* **Create Campaign Button:**\
  At the top of the Campaigns Page, you’ll find a **Create Campaign** button. Clicking this button automatically creates a default campaign with a sequentially incremented name (for example, “Campaign 1,” “Campaign 2,” etc.).
* **Default Campaign Setup:**\
  When a default campaign is created, it comes with a basic reward setup—for instance, a percentage discount reward set at 10% with a 100% chance of winning. This default configuration is intended as a starting point that you can later customize to suit your needs.

***

## Customizing Your Campaign

After creating a campaign, clicking on a campaign’s **Settings** button opens a full-screen modal where you can adjust various aspects of the campaign:

### **General Settings**

* **Campaign Name:**
  * **Purpose:**\
    Enter a descriptive name for the campaign so you can easily identify it later.
  * **How It Works:**\
    The campaign name is displayed in your campaigns list and used for internal tracking.
* **Reward Configuration:**
  * **Adding Multiple Rewards:**\
    Instead of a fixed reward, campaigns allow you to offer several different rewards.
  * **Reward Options:**\
    You can add multiple reward types—such as percentage discounts, free shipping, free products, or custom messages.
  * **Win Probabilities:**\
    For each reward, you assign a chance (expressed as a percentage) that determines the likelihood of that reward being given to a customer.
    * **Important:**\
      The sum of the chance percentages for all rewards in the campaign must equal 100%. This ensures that every interaction results in one of the defined rewards being selected.
* **Editing Rewards:**
  * **Table Interface:**\
    Rewards are displayed in a table where each row shows:
    * **Reward Type:** Indicates whether it’s a percentage discount, free shipping, free product, or custom message.
    * **Value:** For example, the discount percentage or the specific product for a free product reward.
    * **Chance (%):** The probability that this particular reward is awarded.
  * **Actions:**\
    You can add new reward rows or remove existing ones using the provided buttons. This table makes it easy to adjust and ensure that the total chance sums to 100%.

**Live Reward Preview**

* **Reward Pie Chart:**\
  A small pie chart is provided to visually represent the distribution of win probabilities for your campaign rewards. This chart helps you quickly verify that the total percentage is correctly distributed among the rewards.

***

## Managing Existing Campaigns

* **Campaigns List:**\
  All existing campaigns are displayed in a list or table format. Each campaign card or row shows:
  * **Campaign Name**
  * **Creation Date**
  * **Last Edited Timestamp**
  * **Actions:**\
    A button to open the campaign’s settings for editing or deleting the campaign.
* **Editing and Deletion:**
  * **Edit Campaign:**\
    Clicking the **Settings** button on a campaign opens the full-screen modal where you can modify the campaign’s name and reward options.
  * **Delete Campaign:**\
    You have the option to delete a campaign. A confirmation prompt ensures that you don’t accidentally delete a campaign.

***

## In Summary

The Campaigns Page empowers you to:

* **Create New Campaigns:** Start with a default campaign that you can further customize.
* **Customize Rewards:** Add multiple reward options with defined win probabilities (which must add up to 100%), giving you the flexibility to offer varied incentives.
* **Visualize Distribution:** Use the integrated reward pie chart to ensure your win probabilities are balanced correctly.
* **Manage Campaigns:** Edit or delete existing campaigns through an intuitive interface.

This comprehensive control allows you to design dynamic reward strategies that complement your popups—enabling you to offer varied incentives to your customers while maintaining full control over reward probabilities. Whether you opt for a fixed reward or a campaign-based reward system, the Campaigns Page gives you the tools you need to drive engagement and conversions effectively.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://appsetup-eng.gitbook.io/appsetup-popups/getting-started/campaigns-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
