CoOpSetting Data Object - Campaign Management

Defines the ad group level settings for feed-based cooperative bidding campaigns.

Note

This setting is only applicable for ad groups in Microsoft Shopping Campaigns that are setup for Cooperative bidding. Not everyone is enabled for Cooperative bidding yet. If you don't, don't worry. It's coming soon.

Syntax

<xs:complexType name="CoOpSetting" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Setting">
      <xs:sequence>
        <xs:element minOccurs="0" name="BidBoostValue" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="BidMaxValue" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="BidOption" nillable="true" type="tns:BidOption" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
BidBoostValue The percentage (greater than zero) that allows your cooperative bid to flex.

For example, let's say your partner bids $5 USD on a keyword. If your bid boost set to 20 percent and your maximum value is 50 cents, your share would be 50 cents and not $1 USD.

Add: Required if the bid option is set to BidBoost, and otherwise you may not set this element.
Update: Required if the bid option is set to BidBoost, and otherwise you may not set this element.
double
BidMaxValue The flat amount of your cooperative bid.

Add: Required if the bid option is set to BidBoost, and otherwise you may not set this element.
Update: Optional if the bid option is set to BidBoost, and otherwise you may not set this element.
double
BidOption Determines whether or not to amplify your partner's bid.

A bid value ad group allows you to bid on products that your merchandising partner doesn't target. A bid boost allows you to amplify your partner's bid.

Add: If this element is not set, the default Cooperative bidding option for the ad group is "bid value" i.e., the auction will use the fixed bid that you set for each BiddableAdGroupCriterion.
Update: Read-only. If you attempt to change the previous bid option an error will be returned.
BidOption

The CoOpSetting object has Inherited Elements.

Inherited Elements

Inherited Elements from Setting

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

Element Description Data Type
Type The type of the setting. This value is CoOp when you retrieve a cooperative setting. For more information about setting types, see the Setting Data Object Remarks.

Add: Read-only
Update: Read-only
string

Requirements

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