criteria_payload | object or string | Yes | - | Native Microsoft Ads request body, as an object or JSON string, forwarded unchanged. Use CriterionType=Targets for locations, location intent, radii, day/time, age, gender and device mutations; use Audience for audience mutations or the appropriate native type for other criteria. Up to 100 criteria per request. Add a location: {“CriterionType”:“Targets”,“CampaignCriterions”:[{“Type”:“BiddableCampaignCriterion”,“CampaignId”:123,“Criterion”:{“Type”:“LocationCriterion”,“LocationId”:456}}]}. To exclude a location use Type=NegativeCampaignCriterion. Update a bid adjustment: {“CriterionType”:“Targets”,“CampaignCriterions”:[{“Type”:“BiddableCampaignCriterion”,“CampaignId”:123,“Id”:789,“CriterionBid”:{“Type”:“BidMultiplier”,“Multiplier”:10}}]}. Remove: {“CampaignId”:123,“CampaignCriterionIds”:[789],“CriterionType”:“Targets”}. Add/update rows include CampaignId; update rows also include Id. Ad schedules use DayTimeCriterion with Day, FromHour, FromMinute, ToHour and ToMinute. Changing schedule days/hours requires explicit remove then add calls; this operation does not rebuild criteria. Microsoft validates nested fields. |
