Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Priyanshu471/ad-management/llms.txt

Use this file to discover all available pages before exploring further.

The Campaigns page at /advertiser/campaigns gives you a complete view of every ad campaign associated with your account. From here you can monitor performance metrics at a glance, open the campaign modal to make inline edits, and permanently remove campaigns you no longer need — all from a single paginated table.

Campaign List View

Campaigns are displayed in a CampaignsTable component that renders a table with the following columns passed via the headings prop:
ColumnDescription
NameThe campaign title as entered during creation
StatusCurrent lifecycle status of the campaign
BudgetTotal allocated budget for the campaign
ClicksNumber of clicks recorded against the campaign
CtrClick-through rate expressed as a percentage
EditAction button (...) that opens the Campaign Modal
The table is paginated and displays 5 campaigns per page by default. Use the Pagination controls at the bottom of the table to move between pages.

Campaign Status Values

Every campaign carries one of four status values that reflect its current lifecycle stage.
StatusMeaning
ActiveCampaign is currently running and serving ads
EndCampaign has reached its end date and is no longer running
LiveCampaign has been published and is actively live
DeletedCampaign has been removed and is no longer visible in standard views

Editing a Campaign

Click the ... (MoreHorizontal) icon in the Edit column of any row to open the Campaign Modal for that campaign. The modal pre-fills all existing campaign values and exposes three actions.

Campaign Modal Actions

  • Edit — Updates the campaign’s title, description, budget, duration, and status via PATCH /api/campaign. Changes take effect immediately and are reflected in the table on the next render.
  • Delete — Permanently removes the campaign from the database via DELETE /api/campaign. This action cannot be undone.
  • Cancel — Closes the modal and discards any unsaved changes.

Edit Request

// PATCH /api/campaign
{
  prevTitle: "Just Do It",
  title: "Just Do It - Updated",
  description: "Updated description",
  budget: "15000",
  duration: "14 days",
  status: "Active"
}
The prevTitle field is used to locate the existing document in MongoDB, since the title acts as a human-readable identifier during the update operation.

Delete Request

// DELETE /api/campaign
{ id: "65f1a2b3c4d5e6f7a8b9c0d1" }
The campaign id is the MongoDB _id string of the campaign document. Once deleted, the campaign is permanently removed and cannot be recovered from the UI.

Pagination

The Pagination component beneath the table lets you navigate through your full campaign list. The page size defaults to 5 campaigns per page. The current page number and total page count are computed inside the CampaignsTable component from the length of the campaignsData array passed as a prop.
Click Create New at the top of the Campaigns page to jump directly to the campaign creation form at /advertiser/create and add a new campaign to your list.

Build docs developers (and LLMs) love