BidMultiplier Data Object - Campaign Management

Defines the multiplier by which to adjust your base bid for the corresponding criterion.

Syntax

<xs:complexType name="BidMultiplier" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:CriterionBid">
      <xs:sequence>
        <xs:element minOccurs="0" name="Multiplier" type="xs:double" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
Multiplier The percentage amount that you want to adjust the bid for the corresponding criterion. If the campaign uses MaxClicks, MaxConversions, or TargetCpa bid strategy types, then the multiplier will inform rather than directly modify or override the automated bid. For auto bidding the multiplier is used as a weighted percentage to inform Microsoft Advertising about how much you value the criterion relative to other criteria. For example, a -50 percent bid multiplier for a mobile device criterion with the Max Conversions bid strategy to indicate that you value conversions from mobile traffic half as much as other device types. The same bid multiplier with the Max Clicks bid strategy would indicate that you value clicks on mobile half as much as other device types.

For most criterion types the valid bid multiplier range is -90 through 900. For exceptions, see DeviceCriterion Usage and LocationIntentCriterion Usage below. Regardless of the criterion type, if the campaign uses MaxClicks, MaxConversions, or TargetCpa bid strategy types, the valid range of values that you can use to inform auto bidding is -100 through 30.

Although this element supports a double data type, you should use whole integer values i.e., -90 through 900, for parity with the web application.

Add: Required
Update: Required
double

The BidMultiplier object has Inherited Elements.

Inherited Elements

Inherited Elements from CriterionBid

The BidMultiplier object derives from the CriterionBid object, and inherits the following elements. The descriptions below are specific to BidMultiplier, and might not apply to other objects that inherit the same elements from the CriterionBid object.

Element Description Data Type
Type The type of the criterion bid. This value is BidMultiplier when you retrieve a bid multiplier. For more information about criterion types, see the CriterionBid Data Object Remarks.

Add: Read-only
Update: Read-only
string

Remarks

DeviceCriterion Usage

If the Criterion property of the BiddableCampaignCriterion or BiddableAdGroupCriterion object is a DeviceCriterion, please note the following usage of BidMultiplier properties.

Multiplier

Supported values are -100 (negative one hundred) through positive 900 (nine hundred) percent. Setting the bid adjustment to -100 percent will result in the exclusion of the corresponding DeviceName for the DeviceCriterion.

LocationIntentCriterion Usage

If the Criterion property of the BiddableCampaignCriterion or BiddableAdGroupCriterion object is a LocationIntentCriterion, please note the following usage of BidMultiplier properties.

Multiplier

You cannot bid on a location intent criterion. The service will ignore the multiplier without returning any error.

Requirements

Service: CampaignManagementService.svc v12
Namespace: https://bingads.microsoft.com/CampaignManagement/v12