google-ads-create-bid-modifiers

name	google-ads-create-bid-modifiers
description	Use when adjusting Google Ads bid modifiers (device, location, audience). Loaded after the create master skill.

Google Ads — Update Bid Modifiers / Ad Schedule

Tool: google_ads_propose_update_bid_modifiers. Tool schema describes shape; this skill covers the business rules.

What this covers

Adjust bid modifiers and ad-schedule criteria on an existing campaign or ad group. Supported target_types: DEVICE, AD_SCHEDULE, LOCATION, AGE_RANGE. Each criterion is created automatically when you ADD a modifier on a target that doesn't have one yet.

There is no separate create tool — ADD on a new target IS the create.

Non-Schema Rules

• bid_modifier = 0 is allowed only for DEVICE (opt-out of that device). Setting 0 on AD_SCHEDULE / LOCATION / AGE_RANGE rejects.
• bid_modifier range: 0.1 – 10.0 (inclusive). Anything outside rejects.
• AD_SCHEDULE per-day cap: ≤ 6 entries per day per parent. The 7th rejects.
• AD_SCHEDULE minute enum: only ZERO, FIFTEEN, THIRTY, FORTY_FIVE. Other values reject.
• One target per change: don't combine device + ad_schedule (etc.) in the same change item.

Pure Dayparting (no bid multiplier)

To restrict serving to a window without changing bids, omit bid_modifier on the AD_SCHEDULE entry. Google interprets this as "serve only during these schedules." Useful for "only run weekdays 9–5" requests.

Undoing a Bid Modifier

We don't expose entity removal, but bid modifiers are criterion-level — to undo an effect:

• For DEVICE / LOCATION / AGE_RANGE: UPDATE the change to bid_modifier = 1.0 (neutral — no boost, no cut).
• For pure-dayparting AD_SCHEDULE: UPDATE to set a neutral bid_modifier = 1.0 to preserve the schedule but stop adjusting bids; if the user wants to remove the schedule restriction entirely, that requires criterion deletion which this skill doesn't expose — tell the user to manage it in the Ads UI.

GAQL Probes

When you need an existing criterion's id (to UPDATE):

SELECT campaign_criterion.criterion_id, campaign_criterion.type, campaign_criterion.bid_modifier
FROM campaign_criterion
WHERE campaign.id = <campaign_id> AND campaign_criterion.bid_modifier IS NOT NULL

Or ad_group_criterion for ad-group-scoped modifiers.

Output After Execution

Done. Updated bid modifiers on campaign <name>: +20% MOBILE, +30% AD_SCHEDULE Mon-Fri 9-5.