Change a Microsoft Advertising bid adjustment
msads_set_bid_adjustmentDestructiveIdempotent
Set a campaign's bid adjustment, in percent (20 = bid 20% more, -20 = 20% less, 0 = none), for a device, a location or a day/time slot. For devices this creates the adjustment if there is none. For a location or a day/time slot only an EXISTING one can be changed (see msads_get_targeting): adding one would also change where or when ads show, which this tool does not do. An adjustment above +100, or -100 on a device (which stops ads on it), needs allowLargeChange. Returns the previous adjustment so it can be restored. Use dryRun first when unsure.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | For DayTime: the day. | |
| dryRun | No | Preview only. Microsoft has no validate-only mode, so Caybl reads the current value and shows exactly what would change (before and after) without sending anything. Free, and cannot affect spend. | |
| toHour | No | For DayTime: end hour, 1-24. | |
| fromHour | No | For DayTime: start hour, 0-23. | |
| accountId | No | Microsoft Advertising account id or account number (e.g. 'F123ABCD'), as listed by msads_list_accounts. Only needed when the sign-in can reach more than one account. | |
| criterion | Yes | What the adjustment applies to. | |
| campaignId | Yes | Campaign id, from msads_get_campaigns. | |
| deviceName | No | For Device: Computers, Smartphones or Tablets. | |
| locationId | No | For Location: the Microsoft location id (shown by msads_get_targeting). | |
| allowLargeChange | No | A change that more than doubles the current value is refused unless this is true. Set it only when the increase is deliberate and the user has confirmed it. | |
| adjustmentPercent | Yes | Percent change to bids: 20 = +20%, -20 = -20%, 0 = none. |