ad_group_id | string or SelectableOption | Yes | - | Ad group ID to update (from openai_ads_list_ad_groups). |
billing_event_type | string or SelectableOption | Yes | - | Bid / billing event type. Must match the parent campaign’s objective: ‘impression’ for an impressions campaign, ‘click’ for both clicks and conversions campaigns (for a conversions/oCPC campaign the bid amount is the target CPA). |
strategy | string or SelectableOption | No | - | Bidding strategy: ‘fixed_bid’ (the default if omitted) bids the bid_amount; ‘maximize_clicks’ / ‘maximize_conversions’ bid automatically, making bid_amount optional. |
bid_amount | number | No | - | Maximum bid in account currency, not micros. This value is converted to micros automatically before sending to the API. Required unless strategy is ‘maximize_clicks’ or ‘maximize_conversions’. For a conversions (oCPC) campaign this is the target CPA per conversion. |
custom_audience_bid_multipliers | array of OpenAIAdsAudienceBidMultiplier | No | - | Audience bid adjustments as objects or JSON. Omit to preserve existing adjustments; pass [] to clear, including when switching to Maximize strategies. |