Meta Ads -- Support For Value Rules

Please expose Meta's Value Rules (the bid-multiplier replacement) through the ads API:

Reference: https://developers.facebook.com/docs/marketing-api/bidding/value-rules

Value Rules are Meta's mechanism for weighting delivery by segment: an ad account holds named rule sets, each rule mapping audience criteria (age, gender, OS, device, location, placement, conversion location, audience label) to a bid adjustment (+1–1000% / −1–90%).

Two capabilities needed:

1. Rule-set management — account-scoped CRUD, e.g.:

POST /v1/ads/value-rule-sets { accountId, name, rules: [{ name, adjustSign: "INCREASE"|"DECREASE", adjustValue, criteria: [{ type: "OS_TYPE", values: ["IOS"] }] }] } GET /v1/ads/value-rule-sets?accountId=… PUT /v1/ads/value-rule-sets/{valueRuleSetId} DELETE /v1/ads/value-rule-sets/{valueRuleSetId}

2. Ad-set attachment — valueRuleSetId (+ valueRulesApplied) on POST /v1/ads/create and PUT /v1/ads/ad-sets/{adSetId}; valueRulesApplied: false to detach.

Both map ~1:1 onto Meta's /act_{id}/value_rule_set endpoints and the ad-set value_rule_set_id field, so it should slot into your existing pattern of thin, verbatim Meta passthroughs.

Why:

Value rules are the only Meta-sanctioned way to de-prioritize segments without hard exclusions.

In practice: down-weighting iOS or Android (OS_TYPE −90%) or placements like Audience Network (PLACEMENT −90%) suppresses delivery there while keeping Advantage+ placements/audience fully on — the algorithm keeps its full optimization surface instead of being constrained by manual placements or narrowed targeting.

In our experiments this pattern delivers 10–20% performance improvement vs. hard exclusions.