<!-- The markdown copy of https://oppalerts.com/docs/getting-started/set-up-your-first-campaign . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [Getting Started](https://oppalerts.com/docs/getting-started/) / Set Up Your First Campaign

# Set Up Your First Campaign

Set up a campaign for your brand so OppAlerts can research your market and begin daily monitoring.

Follow the steps below in the web app, or ask an AI agent to do them for you. The last section lists the tool for each step.

A campaign contains information about one brand and its market. Most web app pages and MCP and API tools work on one campaign. OppAlerts bases its research on the information you enter here.

## 1. Open New Campaign

1. In the web app, open [New Campaign](https://oppalerts.com/docs/app/campaign/new). The page heading is **Set up your campaign**.
2. The page groups the setup into 5 boxes: Campaign, Brands and competitors, Opportunities, Taxonomy presets, and Daily opportunities email. Leaving a field does not save it. Save the form with either of the 2 buttons at the end of the page: **Finalize and Begin Research** and **Save Draft**.
3. Press **Save Draft** to stop and come back later. The page sends only the boxes you changed. The status line at the top of each box shows what happened, for example "saved just now" or "no change". If a value is rejected, the page shows the error in that box, and all your entries stay in the form.

![The first card of New Campaign, with Label, Industry, and Description.](https://oppalerts.com/img/docs/getting-started/set-up-your-first-campaign/first-card.png)

*The first card of New Campaign.*

## 2. Write the three fields

- **Label:** the name of the campaign in every menu and report. Use a name you will recognize, for example "Marriott". You can change it later.
- **Industry:** the market, in 2 to 10 words, for example "Hotels and resorts". Write the market, not the company. Use an industry that no other campaign in your account uses.
- **Description:** 100 to 1,000 characters about the business. OppAlerts uses it as the basis for the research.

### What to put in the description

- The products or services, by name.
- The type of customer, in plain language.
- The price range: budget, mid, or premium.
- The geographic market, if relevant.
- The names of the competitors.

Write for someone who knows nothing about your business. An AI model reads the description, so use concrete details. Marketing words such as "best" or "leading" give it no information.

## 3. Click Save Draft

- The first save creates the campaign with five saved opportunities: Brand Mentions, Brand Unlinked Mentions, Brand Link Gap, Competitor Mentions, and Competitor Links.
- Nothing is collected yet. The research starts only when you finalize the campaign.
- Two limits apply: your plan's active campaign limit and the number of campaigns you can start in 24 hours. If you reach either limit, the page tells you which one.

## 4. Add your brand and your competitors

- Add your own sites and your brand names. Add old domains and microsites too.
- Add each competitor: its hosts and its brand names.
- Brand Mentions and Competitor Mentions search for the names. Brand Links, Competitor Links, and Brand Link Gap search for the hosts. Without brand names, these searches cannot find mentions.
- After setup, add partners, publishers, and more hosts for an organization, or change chart colors, on the Settings tab of [Edit Campaign](https://oppalerts.com/docs/app/campaign/edit).

## 5. Optional settings

- **Opportunities:** choose up to 3 opportunity types that you want to follow, for example Guest Posts. A free account allows 1. For each type, set Min type score (defaults to 40), Opportunity vector (defaults to Campaign), and Min similarity (defaults to 30%). The other search settings are on the Opportunities tab of Edit Campaign. [Daily Monitoring and Alerts](https://oppalerts.com/docs/getting-started/daily-monitoring-and-alerts) explains them.
- **Taxonomy presets:** the default categories of the [Content Optimizer](https://oppalerts.com/docs/app/content/optimizer) for this campaign, up to 3. If the taxonomy list does not load, the box shows a message. Saving in that state keeps the existing presets.
- **Daily opportunities email:** an email with new pages. It is enabled by default for 7 o'clock in your browser's time zone.

## 6. Finalize and begin the research

1. Review Start the research at the end of the page. After the first save, it lists what is still needed to start the research.
2. Click **Finalize and Begin Research**. A pop-up explains that starting the research prevents further changes to the industry and description. Confirm in the pop-up.
3. The page saves every part and finalizes the campaign. If any part is rejected, or the list still has an outstanding item, the campaign is not finalized.
4. The campaign Dashboard opens.

**The campaign does not start until it is finalized.** Finalizing cannot be undone. After finalizing, you cannot change the industry or the description. The label, the organizations, and the saved opportunities can still change. Check the industry and the description before you click.

## What the research does

- OppAlerts asks several AI models about your market: which sites they recommend, what people search for, and the language used in that market. See [AI Model Answers](https://oppalerts.com/docs/the-data/ai-model-answers).
- OppAlerts stores a description of your market, built from those answers. Semantic searches use it to find pages that are semantically similar to your market. See [How Semantic Search Works](https://oppalerts.com/docs/the-data/how-semantic-search-works).
- OppAlerts counts results for your saved opportunities each day from then on.

## Check the campaign

Open [Keyword Research](https://oppalerts.com/docs/app/content/keyword_research) and read the top 20 search keywords. If they do not reflect your market, the industry or description is incorrect, and every report in the campaign will be incorrect too.

## Let an AI agent do it

An AI agent can perform each step through the MCP server. Your own code can do the same through the API. The agent needs edit permissions: see [Authentication](https://oppalerts.com/docs/getting-started/authentication#scopes). Paste the "Set up my agent" prompt from [Use OppAlerts in Your AI Agent](https://oppalerts.com/docs/getting-started/use-oppalerts-in-your-ai-agent), and the agent asks you for the website and the market.

- Steps 2 and 3, the three fields and the first save: [`campaigns_create`](https://oppalerts.com/docs/mcp/campaigns_create). [`campaigns_update`](https://oppalerts.com/docs/mcp/campaigns_update) changes them before finalizing.
- Step 4, your brand and the competitors: [`campaigns_organization_add`](https://oppalerts.com/docs/mcp/campaigns_organization_add).
- Step 5, the opportunities: [`campaigns_saved_opportunity_add`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunity_add). The taxonomy presets: [`campaigns_set_taxonomy_presets`](https://oppalerts.com/docs/mcp/campaigns_set_taxonomy_presets). The daily email: [`campaigns_set_daily_opportunities_email`](https://oppalerts.com/docs/mcp/campaigns_set_daily_opportunities_email).
- Step 6, finalize: [`campaigns_finalize`](https://oppalerts.com/docs/mcp/campaigns_finalize). The agent must have your explicit permission. You can give it at the start of the task. If the agent does not finalize, it tells you that the campaign has not started.
- After setup: [`campaigns_list`](https://oppalerts.com/docs/mcp/campaigns_list) shows the ID of the campaign, its state, whether it is finalized, and its research progress.

A campaign that was finalized by mistake can be archived with [`campaigns_archive`](https://oppalerts.com/docs/mcp/campaigns_archive).

## Related Pages

- [New Campaign](https://oppalerts.com/docs/app/campaign/new) How to use the New Campaign page of the OppAlerts web app.
- [Campaigns](https://oppalerts.com/docs/getting-started/campaigns) What a campaign is and how to set one up.
- [Daily Monitoring and Alerts](https://oppalerts.com/docs/getting-started/daily-monitoring-and-alerts) Get the new mentions, links, and opportunities of your market each morning, without searching for them.
- [How Semantic Search Works](https://oppalerts.com/docs/the-data/how-semantic-search-works) Find the pages about your subject even when they use other words than you do.
- [AI Model Answers](https://oppalerts.com/docs/the-data/ai-model-answers) See your market the way AI models see it: the sites they recommend, the words they say people search, and the way the market writes.
- [campaigns_list](https://oppalerts.com/docs/mcp/campaigns_list) Lists every campaign in your account, with its id, label, state, whether it is finalized, and how far its research got.
