Campaign change proposal
propose_changeCreate a campaign change proposal (the client's auto policy level applies a reversible change within limits immediately, otherwise it waits for human approval; see status): campaign budget (budget_minor, minor units), Meta ad set budget (kind ad_set_budget, ad_set_id, budget_minor), campaign status (paused|enabled), ad group or ad status (ad_set_status with ad_set_id, ad_status with ad_id), negative keywords or keywords (keywords), Google campaign final URL suffix with UTM tags (kind tracking_suffix, url_suffix), bid strategy (kind bid_strategy: Google campaign — MAXIMIZE_CONVERSIONS with optional target_cpa_minor, MAXIMIZE_CONVERSION_VALUE with optional target_roas, TARGET_SPEND with optional cpc_ceiling_minor, MANUAL_CPC; Meta ad set in a campaign with ad set budgets — ad_set_id and LOWEST_COST_WITHOUT_CAP, or COST_CAP / LOWEST_COST_WITH_BID_CAP with bid_amount_minor; always waits for human approval), Google sitelinks and callouts (kind extensions, extensions; added only), Meta ad set targeting (kind ad_set_targeting, ad_set_id, targeting with only the fields to change: countries, regions, cities, age_min, age_max, genders, advantage_audience, placements, custom_audiences, excluded_audiences, interests; the rest of the targeting stays; always waits for human approval, can be undone), Google keywords of an ad group (kind keyword_update, ad_set_id, keyword_changes: [{criterion_id, status paused|enabled and/or cpc_bid_minor}] from get_ad_group_keywords) and the ad group default CPC bid (kind ad_set_bid, ad_set_id, cpc_bid_minor) — bids apply under manual CPC; always wait for human approval, can be undone. Google campaign targeting — kind campaign_targeting with google_targeting (only the fields to change: locations, excluded_locations, languages, schedule, devices; read get_campaign_targeting first); waits for human approval, can be undone. Remove Google extensions from a campaign — kind extensions_remove with extension_asset_ids from get_campaign_extensions (the assets stay in the account; can be undone). Google ad group audiences — kind ad_set_audiences with ad_set_id and google_audiences (audiences with optional bid_modifier, excluded_audiences; user list ids from get_ad_group_audiences). Microsoft: keyword_update and ad_set_bid as for Google; campaign_targeting with countries — the whole new list of ISO codes; keywords may take ad_set_id — an ad group of the campaign (otherwise the service ad group). LinkedIn: ad_status for a creative (ad_id); ad_set_bid — the campaign bid (ad_set_id of the campaign's only ad group); campaign_targeting with linkedin_targeting (only the fields to change; values from search_linkedin_targeting); bid_strategy MAXIMUM_DELIVERY, MANUAL_BID or COST_CAP with bid_amount_minor. Justification — from specific tool data.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| ad_id | No | ||
| reason | Yes | ||
| status | No | ||
| keywords | No | ||
| ad_set_id | No | ||
| countries | No | Microsoft campaign_targeting: the whole new list of country ISO codes | |
| targeting | No | ||
| extensions | No | ||
| url_suffix | No | ||
| campaign_id | Yes | ||
| target_roas | No | ||
| bid_strategy | No | ||
| budget_minor | No | ||
| cpc_bid_minor | No | ||
| keyword_changes | No | ||
| bid_amount_minor | No | ||
| google_audiences | No | ||
| google_targeting | No | ||
| target_cpa_minor | No | ||
| cpc_ceiling_minor | No | ||
| linkedin_targeting | No | LinkedIn campaign_targeting: only the fields to change; each list is the whole new list | |
| extension_asset_ids | No | Asset ids from get_campaign_extensions (kind extensions_remove) |