Writes (money-moving)

gads_propose_device_bid_modifier

Set a campaign's DEVICE bid adjustment (e.g.

Set a campaign's DEVICE bid adjustment (e.g. -30 = bid 30% less on that device) or exclude a device entirely (-100). Review-tier. IMPORTANT: on Smart Bidding campaigns (tCPA/tROAS/Maximize*) Google IGNORES device modifiers — only -100 (exclusion) is honored there; modifiers only work on manual-CPC / Maximize-clicks campaigns. Check getSegmentPerformance first.

Type: money-moving write. Every write is dry-run validated, then classified by the safe-apply policy — auto-applied when bounded and low-risk, otherwise queued for approval.

Parameters

ParameterTypeRequiredDescription
campaignIdstringYes
device"MOBILE" | "TABLET" | "DESKTOP" | "CONNECTED_TV"Yes
bidModifierPercentnumberYes-100 = exclude the device; -30 = bid 30% less; 20 = bid 20% more.
reasonstringYes
projectIdstringNoTarget account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts.

On this page