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.
Scope: write token required · money-moving. 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
| Parameter | Type | Required | Description |
|---|---|---|---|
campaignId | string | Yes | |
device | "MOBILE" | "TABLET" | "DESKTOP" | "CONNECTED_TV" | Yes | |
bidModifierPercent | number | Yes | -100 = exclude the device; -30 = bid 30% less; 20 = bid 20% more. |
reason | string | Yes | |
projectId | string | No | Target account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token. |