<!-- The markdown copy of https://oppalerts.com/docs/app/campaign/edit . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [App](https://oppalerts.com/docs/app/) / Edit Campaign

# Edit Campaign

`App https://oppalerts.com/app/campaign/edit`

## What you use it for

- **Set up a new client.** Write who they are, who buys from them, and which brands are theirs, then finalize it and the research runs on its own.
- **Say which brands are which.** The owned brand, the competitors, the publishers. Every report labels a domain from this list.
- **Start the collection.** "Finalize and Begin Research" is the button that begins the work.

## How it works

![The tab strip, at the top of the page.](https://oppalerts.com/img/docs/app/campaign/edit/the-tab-strip-at-the-top-of-the-page.png)

*The tab strip, at the top of the page.*

The page has four tabs: Dashboard, Settings, Opportunities, and Daily Email. An administrator sees one more tab, Admin. Each tab has its own settings and saves separately.

**It opens on the Dashboard**, unless the campaign is not finalized yet, when it opens on Settings: a campaign still being written has nothing to show on a dashboard, and the tab that finishes it is the one you want.

### The mark on the Settings tab

Until a campaign is finalized, the tab shows one of two small marks:

- A **warning triangle** means something is still missing. The Start the research card at the top of the tab lists what.
- An **exclamation mark in a circle** means everything is there and it has not been finalized. Nothing is wrong; it is waiting for you.

A finalized campaign carries no mark at all.

### When a save is refused

**A refused save keeps what you typed.** The page shows the refusal message, and every box of that form still holds your text, so you correct one box and save again. This is true on the Settings tab, the Opportunities tab, and the Daily Email tab. A save that works shows "Saved."

### Read permissions

A team member with read permissions for the campaign sees this note at the top of each tab: "You have read permissions for this campaign, so its Save buttons are locked. To change this campaign, ask the account owner for edit permissions." Each button that changes the campaign is locked: Save, Add, Archive, Activate, Delete, Rebuild, and "Finalize and Begin Research".

### What is fixed when you finalize, and what is not

**The industry and the description cannot be changed.** **Organizations and the taxonomy presets are never locked**, because they are read when a report or the Content Optimizer is opened rather than when the data is collected, so changing one later is safe.

### The description is the prompt

![The Campaign card, on the Settings tab.](https://oppalerts.com/img/docs/app/campaign/edit/the-campaign-card-on-the-settings-tab.png)

*The Campaign card, on the Settings tab.*

The campaign description is what the research is built on. Write it for a reader who knows nothing about the client. 100 to 1,000 characters.

### Finalizing the campaign

![The Start the research card, at the top of the Settings tab.](https://oppalerts.com/img/docs/app/campaign/edit/the-start-the-research-card-at-the-bottom-of-the-settings-tab.png)

*The Start the research card, at the top of the Settings tab.*

Finalization requires a complete campaign: an industry, a description of 100 to 1,000 characters, and one owned brand with a host name. The page lists whatever is missing. When nothing is missing, the "Finalize and Begin Research" button shows first on every page of the campaign. It opens a pop-up first: after this step, the industry and the description cannot change, because the research starts.

**Finalizing cannot be undone.** After it, the industry and the description cannot be changed. The campaign label stays editable.

Organizations are the exception. They are read when a report is displayed, not when the data is collected, so they can be added and changed at any time, including long after the campaign is finalized.

After it is finalized, the research starts on its own. It can take a few hours, and the pages fill in as each step finishes.

## Tabs

The page has 4 tabs: Dashboard, Settings, Opportunities, and Daily Email. The Settings tab has 3 parts: the campaign, the taxonomy presets, and the organizations. An administrator sees one more tab, Admin.

### Tab 1: Dashboard

### What it shows

The Dashboard has three cards:

1. **Opportunities found, by day.** One column per day for the last 14 days, and **two rows per opportunity**: the News Index on the first, the Prospect Index on the second. Every number is a link to that index's own list of the pages found that day.
2. **News Index links found over time.** One chart, the News Index, one point per day: how many pages were found that day. Under it a table with two rows per organization, the News Index then the Prospect Index, the same shape as the first card.
3. **PageRank history.** Two charts, Domain and Host, one point per month, from July 2017. On the Host chart the line is the larger of the bare host and the **www** host in each month. The web graph began counting www.example.com apart from example.com in January 2026, and a site's score can sit on either one. Reading only one of them would show a fall where nothing had happened to the site.

### Reading the result

**The first card is the one to read every morning.** A **43** under 08-29 on the "Guest posts" News Index row means 43 news pages matching that search were added in the 24 hours ending 09:00 UTC on the 29th, and the **0** under it on the Prospect Index row means that index was searched and held none. Click the 43 and you get those 43 pages and nothing else. The two indexes are kept on their own rows on purpose: one total of 43 used to open the Prospect Index, which held none of them.

**A dot and a 0 are different facts.** A dot means that index was never counted that day. A grey 0 means it was counted and found nothing. The last column is that row added up over the 14 days.

**What the plus means.** To count one day, OppAlerts takes up to 2,500 pages from that day that match the opportunity type and your filters. Then it keeps only the pages that are similar to your campaign description, or to the opportunity's similarity text. When a day has more than 2,500 matching pages, the count covers only the top 2,500, and the number shows a plus. "150+" means at least 150. With a broad opportunity type, only 100 of the 2,500 pages might be similar. With a close one, 1,500 might be. A search engine cannot read every page for every search, so it reads the top results. OppAlerts works the same way.

**An organization is the same color in every chart on this tab.** Your own brand is the OppAlerts teal unless you pick another color for it on the Settings tab, and each competitor keeps its own color, so a line you learn on one chart is the same line on the next.

**The links chart shows the pages found.** If a competitor's line is above yours on the News Index links chart, more news pages linking to them were found that day. The chart does not explain why.

### What it does NOT show

**No goal, no target, and no progress bar.** OppAlerts is not accountable for whether you get the link or the ranking. It is accountable for the research and for telling you quickly what is available. Every number here is what was FOUND, or what the market looks like.

### How to use it

1. **Set up opportunities first.** The first card is empty until you do, and it says so with a link to the tab.
2. **Read the first card daily** and open the numbers that are not zero.

**The Rebuild button.** After a change to the organizations, the stored counts of the brand searches still reflect the old organizations. The first card then shows a **Rebuild the counts** button, or **Fill the missing days** when days have no number. The button shows only for an active, finalized campaign.

### Tab 2: Settings, the campaign

### What it shows

The campaign label, the industry, the description, and the **Start the research** card at the top.

### What each field does

- **Campaign label.** The name in every menu and every report. It stays editable after the campaign is finalized.
- **Industry.** The market this campaign is about. You cannot change it after you finalize the campaign.
- **Description.** 100 to 1,000 characters on this market. You cannot change it after you finalize the campaign.

### How to use it

1. **Write the description for a reader who knows nothing.** Anything you leave out is something the research never knew.
2. **Keep it inside the range in the label.** Finalize refuses a description outside it.
3. **Do not finalize until the other tabs are done.**

### Tab 2: Settings, the taxonomy presets

### What it shows

**Three rows, each a taxonomy and one category inside it.** They are the **Content Optimizer's defaults on this campaign**, and nothing else in the application reads them.

They sit on Settings, under the Campaign card.

### Where the data comes from

The taxonomy list is the installed set: IAB Content, IAB Audience, Google Ads Topics, Google Merchant, IPTC Media Topics, and the rest. The category list under each is fetched when you open the box, so the 5,000-category taxonomies load only when you use one.

**One taxonomy per row.** Two categories of one taxonomy cannot be used together, so a second row naming a taxonomy already used is not saved.

**A row with a taxonomy and no category is not a preset** and is not saved. The pair is the preset.

**When the taxonomy list does not load**, the card says "The taxonomy list did not load. The presets of this campaign are not changed. Try again in a few minutes." The card then has no rows and no save button, so the stored presets stay.

### How to use it

1. **Set them once, per client.** The Content Optimizer then opens with them already chosen and nobody has to find them again for every draft.
2. **Pick the category you actually write for**, not the widest one above it. "Travel > Travel Type > Hotels and Motels" is a useful target; "Travel" is not.
3. **Use two or three when the client writes for two audiences.** One row for the subject, one for the reader.
4. **Finalizing does not fix them.** Change them whenever the writing changes.

**A writer can still change them in the Content Optimizer**, and their own choice is remembered in their own browser for this campaign. It does not change the campaign presets or affect anybody else. The button on that page restores the campaign presets.

### Tab 2: Settings, the organizations

### What it shows

Four boxes, one for each relationship: Owned Brands, Competitors, Partners, and Publishers. Each box lists its organizations, one row each: its hosts and its brand names. The first host is the organization's label.

### What it decides

**This is the labeling for the whole application.** Every report that tags a domain reads this list. A domain that is not here is shown with no tag on every page.

It is also the input to several pages rather than just a label:

- **Brand Mentions and Competitor Mentions** search for the NAMES typed here. No names, no mentions.
- **Brand Links, Competitor Links, Brand Link Gap** search for the HOSTS typed here.
- **Backlinks DB: Link Gap** opens with both boxes filled from this list.

**Finalizing does not fix the organizations.** They are read when a report is displayed, not when the data is collected, so they can be added and changed at any time, including years after the campaign is finalized. A domain added today re-labels every report immediately, including reports built from data collected before it existed.

**A relationship is per campaign.** The same company can be a competitor in one campaign and a publisher in another, and each campaign's reports read its own labels.

### How to use it

1. **Enter the owned brand first**, with every host you own, including old domains and microsites.
2. **Enter the real brand NAMES too, not just the host.** This is the most common reason a mentions page looks empty.
3. **Then the competitors**, with their names.
4. **Then the publishers** you already know about.
5. **Come back every time a report shows an untagged domain** that matters.

### Tab 3: Opportunities

![Add opportunity, on the left of the tab.](https://oppalerts.com/img/docs/app/campaign/edit/add-opportunity-on-the-left-of-the-tab.png)

*Add opportunity, on the left of the tab.*

![The list, on the right of the tab.](https://oppalerts.com/img/docs/app/campaign/edit/the-list-on-the-right-of-the-tab.png)

*The list, on the right of the tab.*

### What it shows

**A campaign opportunity is a saved search.** You choose what to look for once, and every day we count how many NEW pages matching it were added to the Prospect Index and the News Index.

### What each field does

- **Label.** What this opportunity is called on the Dashboard and in the daily opportunities email. It has to be different from every other label in this campaign. Choosing a search writes that search's own name into an empty Label box, and you can change it.
- **Search for.** What the opportunity looks for. A new opportunity opens on the first line, No opportunity type, and its name is in the Label box. Under it is the group Brands / Competitors with the six brand searches: Brand Links, Brand Mentions, Brand Unlinked Mentions, Brand Link Gap, Competitor Links, and Competitor Mentions. Each one uses the organizations you set up on the Settings tab. Then every opportunity type, in the groups of the top menu, and last the group Content Types. No opportunity type finds pages by the vector and the words alone.
- **Min type score.** To the right of Search for. How well a page has to match the opportunity type or the content type. The menu goes from 100 down to 1 and opens at 40. It is locked until you choose a type, and a brand search does not show it.
- **Opportunity vector.** What the pages must be near to in semantic similarity: No vector, Similarity text, or Campaign. A new opportunity opens on Similarity text. Similarity text shows a text box. Write or paste up to 1,000 words, for example a short product review or a summary of a news event. The text gets its own vector when you save. With Similarity text chosen and the box empty, the opportunity is not saved: paste a text, or choose No vector. With No vector, the words and the numbers alone find the pages. A brand search does not show the vector.
- **Title query, Body query, and Combine.** The same boxes as Advanced Search. Title query finds words in the page title. Body query finds words in the text of the page. Combine applies when both boxes have words: Title AND body needs both to match, and Title OR body needs one of them. A new opportunity opens on Title AND body. Each box takes at most 20 words or phrases. A brand search does not show these boxes.
- **A vector or words.** An opportunity needs an Opportunity vector, a Title query, or a Body query. With No vector and the 2 boxes empty, it is not saved. A brand search is a word search of its own, so this rule does not apply to it.
- **Min similarity.** How near in semantic similarity a page must be to the vector before it is counted, on both indexes. It opens at 30%. It is locked while there is no vector: with No vector, or with Similarity text and an empty box. A brand search does not show it.
- **The numbers.** Min domain PR and Min host PR show on the form and open at 10, or at 0 for a brand search. The Advanced fold-out holds Min domain PRoT, Min host PRoT, Max domain PR, Max host PR, Max domain PRoT, Max host PRoT, and the Links out minimums of the article, the navigation, and the comments. A minimum you leave empty, or a 0, sets no limit. Max domain PR and Max host PR open at 100, which sets no limit. A Max PRoT box takes 1 to 1,000,000, and an empty box sets no limit. A brand search shows the numbers too.
- **Saving a change** to a search clears its history. It fills in again after the next nightly update.
- **A refused query.** The Title query and Body query boxes take the [search operators](https://oppalerts.com/docs/the-data/advanced-search-operators) of Advanced Search. A query with a formatting error is not saved. [How to Search the Indexes](https://oppalerts.com/docs/the-data/how-to-search-the-indexes) has every rule of a query. The sentence names the box and the error, for example: "Not saved. The Title query box has a formatting error: a * that is not directly after 3 or more letters or digits. Type at least 3 letters or digits directly before the *."
- **A number box takes digits only.** A value such as 1,000 in Min domain PRoT is not saved: "Not saved. The Min domain PRoT box holds a value that is not a whole number. Type digits only, for example 1000." A minimum above its maximum is not saved either.

### Reading the result

The Filters column is what narrows the search, so the second row is every page in either index that links to one of your own hosts, with no PageRank minimum at all, while the first row is guest-post pages on sites of Domain PR 20 or better that link out at least once from the article body.

The Label is plain text.

### What is counted, and what is not

**The daily count reads the Prospect Index and the News Index, and nothing else.** A page counts as new when it was INDEXED in the 24 hours ending at 09:00 UTC. A News Index page also has to have been published in the last 7 days, because that index holds one table per month and a rotation would otherwise read as a wave of new pages.

### How to use it

1. **Start with two or three.** One opportunity type you actually chase, and one brand search.
2. **Set the numbers the way you would set them on the search page.** Domain PR is the one most people set first.
3. **Read the Dashboard the next morning** and open the numbers.
4. **Archive an opportunity you have stopped chasing.** There is no delete: the counts already taken point at it, and archiving keeps the history and stops the next count.
5. **25 is the limit** for one campaign, active and archived together.

### Tab 4: Daily Email

![The Daily opportunities email card.](https://oppalerts.com/img/docs/app/campaign/edit/the-alert-email-card.png)

*The Daily opportunities email card.*

### What it shows

**One name and one address per campaign**, and a box that turns the daily opportunities email on. The two boxes arrive filled with your own name and address from your sign-in, so one tick and Save is the whole set-up. Nothing is stored until you press Save.

### What the email holds

One email a day. It lists **every active opportunity** on the Opportunities tab, in the same order as the Dashboard: how many pages were found in the last day in the News Index and in the Prospect Index, and how many in the last 7 days. Under each opportunity are the top 3 pages from each index, a link to every page of that day, and a link to the last 7 days. An opportunity that found nothing is one line.

The numbers are the ones on the Dashboard. The email does not count again, so the two cannot disagree.

### When it is sent

Pick one hour of the day and your time zone. The email is built and sent inside that hour. It reports the newest day that has been counted. The time zone menu opens on the time zone of your browser, or on America/New York when the browser does not give one.

### Emails sent

The card beside the form lists the last 30 emails of this campaign. View opens one exactly as it was sent.

### Turning it off

Clear the check box and Save. Every email will also carry an unsubscribe link, which turns the email off without signing in; the tab then shows the date it was unsubscribed and the box has to be ticked again to turn it back on.

### How to use it

1. **Put the address of the person who acts on the work**, not a shared inbox nobody reads.
2. **Keep the opportunities list to what you act on.** Every active opportunity is in the email. Archive one on the Opportunities tab and it leaves the email.

### Tab 5: Admin

### What it shows

The campaign's **reference text**, with its vector beside it.

### Where the data comes from

A model was asked to describe this campaign, and what it wrote was stored. That text was then turned into numbers once, and **those numbers are what every News Index and Prospect Index search on this campaign is matched against**.

**This is where a wrong-looking semantic search starts.**

### How to use it

1. **Read the campaign text** when any page that uses semantic search looks off.
2. **Administrators only**, and the tab is not built at all for anybody else.

## On your own campaign

1. **Create the campaign** and give it a label you will recognize in the campaign menu at the top of every page.
2. **Write the description.** 100 to 1,000 characters, for a reader who knows nothing about the client.
3. **Enter the organizations.** The client's own brand first, then every competitor you want tracked, then the publishers in the market. A domain that is not in this list is shown with no label on every report.
4. **Read the Start the research card** and fix whatever it names.
5. **Finalize it.** Then leave it. The collection takes hours, and every report fills in as its data arrives.

![The organization boxes, on the Settings tab, one row for each.](https://oppalerts.com/img/docs/app/campaign/edit/the-organization-boxes-on-the-settings-tab-one-row-for-each.png)

*The organization boxes, on the Settings tab, one row for each.*

Come back to the Settings tab whenever a new competitor appears in a report. Adding one re-labels every report at once, including the ones drawn from data collected before it was added.

## MCP

These MCP tools give the same data. Each page has every parameter and an example.

- [`campaigns_dashboard`](https://oppalerts.com/docs/mcp/campaigns_dashboard): The campaign dashboard read: the opportunities counted each day on each index, the PageRank of every organization host month by month, and the index links found over time.
- [`campaigns_organizations`](https://oppalerts.com/docs/mcp/campaigns_organizations): The Organizations read of one campaign: every organization with its relationship and its hosts.
- [`campaigns_settings`](https://oppalerts.com/docs/mcp/campaigns_settings): The settings of one campaign (the Settings tab of Edit Campaign): its label, industry, description, state, research, taxonomy presets, and daily opportunities email settings.
- [`campaigns_saved_opportunities`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunities): The saved opportunities of one campaign: every one with its id, label, and state.

These MCP tools make the changes of this page. Each one needs the scope `api:write`. Each page has every parameter, who may call the tool, every error, and an example.

- [`campaigns_activate`](https://oppalerts.com/docs/mcp/campaigns_activate): Makes an archived campaign active again, inside the campaign limits of the plan.
- [`campaigns_archive`](https://oppalerts.com/docs/mcp/campaigns_archive): Archives one campaign: its daily counts and its daily opportunities email stop, and its data stays. A campaign is never deleted.
- [`campaigns_finalize`](https://oppalerts.com/docs/mcp/campaigns_finalize): Finalizes one campaign, so that its research starts. Finalize cannot be undone.
- [`campaigns_organization_add`](https://oppalerts.com/docs/mcp/campaigns_organization_add): Adds one organization to a campaign: your own brand, a competitor, a partner, or a publisher, with its websites and brand names.
- [`campaigns_organization_delete`](https://oppalerts.com/docs/mcp/campaigns_organization_delete): Deletes one organization from a campaign. Its websites and names can be added again later.
- [`campaigns_organization_update`](https://oppalerts.com/docs/mcp/campaigns_organization_update): Changes one organization of a campaign: its websites, its brand names, its relationship, and its chart color. The call replaces the whole organization.
- [`campaigns_rebuild_counts`](https://oppalerts.com/docs/mcp/campaigns_rebuild_counts): Asks for the stored daily counts of one campaign to be counted again. A background job counts in the next minutes.
- [`campaigns_rerun_research`](https://oppalerts.com/docs/mcp/campaigns_rerun_research): Starts the research of one campaign again after it stopped. Only the steps that did not finish run again.
- [`campaigns_saved_opportunity_activate`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunity_activate): Makes an archived saved opportunity active again, inside the plan's limit of active opportunity types.
- [`campaigns_saved_opportunity_add`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunity_add): Adds one saved opportunity to a campaign: a saved search that is counted on the News Index and the Prospect Index every day, and that the daily opportunities email reports.
- [`campaigns_saved_opportunity_archive`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunity_archive): Archives one saved opportunity of a campaign: it is not counted and is not in the daily opportunities email. A saved opportunity is never deleted.
- [`campaigns_saved_opportunity_update`](https://oppalerts.com/docs/mcp/campaigns_saved_opportunity_update): Changes one saved opportunity of a campaign. The call replaces the whole saved opportunity.
- [`campaigns_set_daily_opportunities_email`](https://oppalerts.com/docs/mcp/campaigns_set_daily_opportunities_email): Sets the daily opportunities email of one campaign: the address, the first name, on or off, and the hour and time zone of the send.
- [`campaigns_set_taxonomy_presets`](https://oppalerts.com/docs/mcp/campaigns_set_taxonomy_presets): Sets the 3 taxonomy presets of one campaign: the taxonomy categories the Content Optimizer opens with.
- [`campaigns_update`](https://oppalerts.com/docs/mcp/campaigns_update): Changes the label, the industry, or the description of one campaign. After the campaign is finalized, only the label can change.

## API

These API routes give the same data.

- [`POST /v1/campaigns/dashboard`](https://oppalerts.com/docs/api/campaigns_dashboard)
- [`POST /v1/campaigns/organizations`](https://oppalerts.com/docs/api/campaigns_organizations)
- [`POST /v1/campaigns/settings`](https://oppalerts.com/docs/api/campaigns_settings)
- [`POST /v1/campaigns/saved_opportunities`](https://oppalerts.com/docs/api/campaigns_saved_opportunities)

These API routes make the changes of this page. Each one needs the scope `api:write`.

- [`POST /v1/campaigns/activate`](https://oppalerts.com/docs/api/campaigns_activate)
- [`POST /v1/campaigns/archive`](https://oppalerts.com/docs/api/campaigns_archive)
- [`POST /v1/campaigns/finalize`](https://oppalerts.com/docs/api/campaigns_finalize)
- [`POST /v1/campaigns/organization_add`](https://oppalerts.com/docs/api/campaigns_organization_add)
- [`POST /v1/campaigns/organization_delete`](https://oppalerts.com/docs/api/campaigns_organization_delete)
- [`POST /v1/campaigns/organization_update`](https://oppalerts.com/docs/api/campaigns_organization_update)
- [`POST /v1/campaigns/rebuild_counts`](https://oppalerts.com/docs/api/campaigns_rebuild_counts)
- [`POST /v1/campaigns/rerun_research`](https://oppalerts.com/docs/api/campaigns_rerun_research)
- [`POST /v1/campaigns/saved_opportunity_activate`](https://oppalerts.com/docs/api/campaigns_saved_opportunity_activate)
- [`POST /v1/campaigns/saved_opportunity_add`](https://oppalerts.com/docs/api/campaigns_saved_opportunity_add)
- [`POST /v1/campaigns/saved_opportunity_archive`](https://oppalerts.com/docs/api/campaigns_saved_opportunity_archive)
- [`POST /v1/campaigns/saved_opportunity_update`](https://oppalerts.com/docs/api/campaigns_saved_opportunity_update)
- [`POST /v1/campaigns/set_daily_opportunities_email`](https://oppalerts.com/docs/api/campaigns_set_daily_opportunities_email)
- [`POST /v1/campaigns/set_taxonomy_presets`](https://oppalerts.com/docs/api/campaigns_set_taxonomy_presets)
- [`POST /v1/campaigns/update`](https://oppalerts.com/docs/api/campaigns_update)

## Related pages

- [List Campaigns](https://oppalerts.com/docs/app/)
- [New Campaign](https://oppalerts.com/docs/app/campaign/new)
- [All App Pages](https://oppalerts.com/docs/app/)
