kadam_adv_update_campaign
Update an ad campaign by passing only the fields to change. Modify targeting, budget, bid, schedule, and conversion settings with a read-modify-write approach.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Campaign ID to update | |
| name | No | Campaign name shown in dashboard | |
| url | No | Landing page URL | |
| folderId | No | Campaign group ID (API field: folderId) | |
| dailyBudget | No | Daily spending limit in USD | |
| bid | No | Bid amount in USD. For cpa_target this is the target CPA cost | |
| disableProxy | No | Block proxy/VPN traffic | |
| subscriptionAges | No | Comma-separated subscription-age IDs (push / in-page push only; see campaign options 'subAges'). Replaces the current set. Example: '1' = newest only. | |
| countries | No | Comma-separated ISO country codes (e.g. 'US,DE,BR') | |
| devices | No | Comma-separated device names or IDs (e.g. 'Desktop,Smartphone' or '1,4') | |
| os | No | Comma-separated OS names or IDs (e.g. 'Android,iOS' or '10,20') | |
| browsers | No | Comma-separated browser names or IDs (e.g. 'Chrome,Firefox' or '8,16') | |
| languages | No | Comma-separated language names or IDs | |
| connectionType | No | Network connection type filter (all = no filter) | |
| audienceIncludeIds | No | Comma-separated audience IDs to include | |
| audienceExcludeIds | No | Comma-separated audience IDs to exclude | |
| siteWhitelist | No | Comma-separated site IDs for whitelist | |
| siteBlacklist | No | Comma-separated site IDs for blacklist | |
| sspMode | No | SSP list mode: whitelist (allow listed) or blacklist (block listed) | |
| sspIds | No | Comma-separated SSP IDs for the whitelist/blacklist | |
| totalBudget | No | Total campaign budget in USD | |
| evenDistribution | No | Spread budget evenly across the day | |
| startDate | No | Start date (YYYY-MM-DD) | |
| endDate | No | End date (YYYY-MM-DD) | |
| timezone | No | Timezone offset in hours (e.g. 3 for UTC+3) | |
| schedule | No | Comma-separated hours (0-23) to show ads, applied to all days (e.g. '9,10,11,17') | |
| frequencyCapViews | No | Creative-level cap: max views of ONE creative per user within frequencyCapDays | |
| frequencyCapDays | No | Window in days for frequencyCapViews | |
| campaignCapViews | No | Campaign-level cap: max views of ANY creative from this campaign per user within campaignCapDays | |
| campaignCapDays | No | Window in days for campaignCapViews | |
| impTracker | No | Third-party impression tracking pixel URL | |
| categories | No | Comma-separated category IDs from kadam://reference/categories (or the 'mainstream'/'adult' keyword) | |
| secondPush | No | Enable second push notification (push/inpage_push only) | |
| pauseAfterModeration | No | Pause campaign after creatives pass moderation | |
| conversionTemplateId | No | Conversion template ID (from campaign options). Use 0 for custom mapping via conversionApproved/Hold/Reject | |
| conversionApproved | No | Postback status name for 'Approved' conversions (e.g. 'dep'); used with conversionTemplateId=0 | |
| conversionHold | No | Postback status name for 'Hold' conversions (e.g. 'reg') | |
| conversionReject | No | Postback status name for 'Rejected' conversions | |
| postViewWindow | No | Post-view attribution window in hours (1-168) | |
| postClickWindow | No | Post-click attribution window in hours (1-168) | |
| countFirstConversionOnly | No | Count only the first conversion per user (default: true) | |
| countLastCampaignOnly | No | Attribute conversion only to the last campaign impression (default: true) | |
| postClickAttrPriority | No | Post-click attribution takes priority over post-view (default: true) | |
| postConversionAudienceIds | No | Comma-separated audience IDs for post-conversion retargeting |