Documentation / Getting Started / Campaigns
Campaigns
Set up a campaign for your brand and market, then finalize it to start the research.
What a campaign is
A campaign brings together your brand's sites, competitors, market description, and saved opportunities. OppAlerts uses this information for searches. Most web app pages and tools work on one campaign.
- The Owned Brands box on the Settings tab of Edit Campaign contains the brand's sites. Brand Links and Brand Mentions search for these sites.
- Competitors are organizations with the competitor relationship. Competitor Links and Competitor Mentions search for their sites.
- A saved opportunity is a search whose results OppAlerts counts every night. Every campaign starts with five: Brand Mentions, Brand Unlinked Mentions, Brand Link Gap, Competitor Mentions, and Competitor Links. A campaign can hold 25 opportunities in total, including active and archived opportunities. A free account can have 7 active opportunities.
Set one up
- Open New Campaign in the web
app. An AI agent uses
campaigns_create. - Fill in the form: the label, the industry (2 to 10 words), and the description (100 to 1,000 characters).
- Add your brand and competitors. An AI agent uses
campaigns_organization_add. - Save the opportunities you want to monitor. An AI agent uses
campaigns_saved_opportunity_add. - Finalize the campaign. An AI agent uses
campaigns_finalize.
Set Up Your First Campaign explains each step.
Finalize
- Finalizing starts the campaign. Until then, OppAlerts does not run research, count daily results, or send the daily opportunities email.
- After finalizing, you cannot change the industry or description. You can still change the label, organizations, and saved opportunities.
- An agent finalizes only with your explicit permission, which you can give at the start of the task. If the agent does not finalize the campaign, it tells you that the campaign has not started.
- A campaign that was finalized by mistake can be archived.
Campaigns in MCP and the API
- Most tools take a
campaignparameter: the campaign ID.campaigns_listlists your account's campaigns with their IDs. - An agent can also create and change a campaign: the label, the organizations, the saved opportunities, the daily opportunities email, and more. It needs edit permissions. Change a campaign lists each tool and who can use it.
- After setup, change a campaign on the Settings tab of Edit Campaign, or ask your agent.