Create Campaign - Markifact

Creates a DV360 campaign under an advertiser with goal, performance target, flight dates, and frequency cap. Amounts are entered in the advertiser’s currency and converted to DV360 micros automatically.


App	DV360
Operation ID	`dv360_create_campaign`
Type	Action
Connection	`dv360` (required)
Credits per run	2
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the DV360 advertiser to create the campaign under.
`campaign_name`	string	Yes	-	Display name of the campaign. Max 240 bytes.
`status`	string or SelectableOption	No	`{'value': 'PAUSED', 'label': 'Paused'}`	Status when the campaign is created: ACTIVE or PAUSED. Default: PAUSED.
`campaign_goal_type`	string or SelectableOption	Yes	-	Campaign goal: APP_INSTALL (drive app installs), BRAND_AWARENESS (raise awareness), OFFLINE_ACTION (drive offline or in-store sales), or ONLINE_ACTION (drive online actions or visits).
`performance_goal_type`	string or SelectableOption	Yes	-	Performance goal metric. Money goals (use performance_goal_amount): CPM, CPC, CPA, CPIAVC, CPE, CPV, VCPM. Percentage goals (use performance_goal_percentage): CTR, VIEWABILITY, CLICK_CVR, IMPRESSION_CVR, VTR, AUDIO_CR, VIDEO_CR. OTHER uses performance_goal_string.
`performance_goal_amount`	number	No	-	Goal amount in the advertiser’s currency (for example 2.5 for a $2.50 CPM). Required for money performance goals; converted to DV360 micros automatically.
`performance_goal_percentage`	number	No	-	Goal percentage (for example 70 for 70%). Required for percentage performance goals; converted to DV360 percentage micros automatically.
`performance_goal_string`	string	No	-	Key performance indicator text. Required when performance_goal_type is OTHER.
`start_date`	string	Yes	-	Planned flight start date as YYYY-MM-DD, in the advertiser’s timezone.
`end_date`	string	No	-	Optional planned flight end date as YYYY-MM-DD. Must be on or after start_date.
`planned_spend`	number	No	-	Optional planned spend for the flight in the advertiser’s currency; converted to micros automatically. Informational only; DV360 does not enforce it.
`unlimited_frequency_cap`	boolean	No	`True`	When true (default), no campaign-level frequency cap. Set false to cap impressions per user with the frequency_cap_* fields.
`frequency_cap_max_impressions`	integer	No	-	Maximum impressions per user for the chosen time window. Required when unlimited_frequency_cap is false.
`frequency_cap_time_unit`	string or SelectableOption	No	-	Frequency cap window unit: LIFETIME, MONTHS, WEEKS, DAYS, HOURS, or MINUTES. Required when unlimited_frequency_cap is false.
`frequency_cap_time_unit_count`	integer	No	-	How many time units the window lasts (for example 1 WEEK). Required when unlimited_frequency_cap is false, except for LIFETIME.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the created DV360 campaign details. Fields: campaign_id, campaign_name, entity_status, advertiser_id, campaign