name | string | Yes | - | Campaign name (3-1000 characters). |
status | string or SelectableOption | Yes | - | Campaign status: ‘active’ or ‘paused’. |
bidding_type | string or SelectableOption | No | - | Campaign objective / bidding type: ‘impressions’ (the default if omitted), ‘clicks’, or ‘conversions’. Use ‘conversions’ together with conversion_event_setting_ids. |
budget_type | string or SelectableOption | Yes | - | Budget type — a ‘daily’ or ‘lifetime’ spend limit. |
budget_amount | number | Yes | - | Budget amount in your account currency (e.g. US dollars), i.e. 50 for $50. This value is converted to micros automatically before sending to the API. |
mode | string or SelectableOption | No | - | Campaign mode: ‘standard’ (the default if omitted) or ‘product_feed’ for a campaign that advertises items from a product feed set up in OpenAI Ads Manager. The mode cannot be changed after creation; ad groups under a product-feed campaign need a product_feed_id. |
description | string | No | - | Optional campaign description. |
start_date | string | No | - | Optional campaign start date in YYYY-MM-DD format (converted to a Unix timestamp). |
end_date | string | No | - | Optional campaign end date in YYYY-MM-DD format (converted to a Unix timestamp). |
location_ids | array (also accepts a comma-separated string) | No | - | Optional list of location IDs to target, obtained from the openai_ads_search_geo node. Omit to reach all available locations. |
conversion_event_setting_ids | array (also accepts a comma-separated string) | No | - | Optional list of conversion event setting IDs, obtained from the openai_ads_list_conversion_events node. Typically used when bidding_type is ‘conversions’. |