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