List advertiser campaigns with pagination. Filter by campaign group (folderId), status, type, date range, or search query.

Create a new advertiser campaign. Required: type, name, url, folderId (campaign group ID), pricingModel, bid, dailyBudget.

Update a campaign (read-modify-write): pass only the fields to change, same names as create. Handles all targeting/budget/bid/schedule/conversion edits. For status changes use set_campaign_status.

Set status for multiple campaigns. Pass comma-separated IDs and status: active, paused, or archived.

Change ONLY the bid for countries the campaign ALREADY targets (does NOT change geo). To add or change countries use kadam_adv_update_campaign. Unknown countries error out; omit countries to re-bid all current ones.

Set the same bid on multiple campaigns at once. All campaigns in the batch must share one pricing model (mixing CPC/CPA errors out). Countries are required (backend rejects an empty list).

Set per-site (zone) bids for campaigns. Bid is a number ('0.05'), a multiplier ('x1.5'), or '0' to remove.

Get full campaign configuration by ID, including landing page URL, bids per country, budgets, targeting (devices, OS, browsers, languages, sites, SSPs, audiences), frequency caps, schedule, and conversion settings. Use after kadam_adv_list_campaigns to inspect one campaign in detail.

List advertiser campaign groups with pagination. Optional search by name. A campaign group (called 'campaign group' / 'Группа кампаний' in the Kadam UI) is the same entity the API/tool calls a folder.

Create a new campaign group (called 'campaign group' / 'Группа кампаний' in the Kadam UI; API term: folder).

Update campaign group settings: budgets and distribution (campaign group = the UI term for a folder).

List advertiser audiences with pagination. Filter by search query, sort by field and order.

Get a single audience by ID. Returns type-specific details: tracking code for pixel/s2s, campaign links for stat, linked audiences for s2s.

Create an audience. Required fields by type: • audience_code (pixel) — name, expireDays; optional createFingerprint. • audience (stat) — name, expireDays, campaignIds, plus >=1 of hasClicks/hasConversions/hasHolds/hasRejects. • s2s — name, expireDays, linkedAudienceIds (pixel/fingerprint IDs). • fingerprint — not created directly; set createFingerprint=true on a pixel/stat audience.

Update an existing audience (read-modify-write). Fetches current state, merges your changes, sends full payload. Type cannot be changed. Pass only the fields you want to change.

Permanently delete an audience. Requires confirm=true for safety.

List advertiser creatives with pagination. Filter by campaign, status, or search query.

Create a creative. Accepts image/video as a URL or local file path. Required fields by type:

• Push / In-Page Push: title, text, url, imageUrl (icon), mainImageUrl

• Native: title, url, imageUrl (icon), mainImageUrl

• Banner: url, imageUrl, sizeId

• Video: title, url, videoUrl (MP4)

• Popunder: none (campaign URL is the ad) See kadam://reference/creative-formats for sizes and exact dimensions.

Update an existing creative (read-modify-write). Fetches current state, merges your changes, sends full payload. Pass only the fields you want to change. For image changes, create a new creative instead.

Set status for multiple creatives. Pass comma-separated IDs and status: active, paused, or archived.

Lists financial operations (deposits, charges, refunds). Use to check account balance, recent transactions, and spending history.

Advertiser statistics. reportType: 'custom' (default, report builder), 'sites' (per-site), or 'conversions' (event log). For custom reports use names like 'spend,clicks,ctr' (metrics) and 'day,campaign,country' (groupBy).