Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

BiddableAdGroupCriterion Data Object

Defines the conditions that determine whether product ads in the ad group get served. If the conditions are met, the specified bid is used in the auction.

<xs:complexType name="BiddableAdGroupCriterion">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element name="DestinationUrl" type="xs:string" nillable="true" minOccurs="0"/>
        <xs:element name="EditorialStatus" type="tns:AdGroupCriterionEditorialStatus" nillable="true" minOccurs="0"/>
        <xs:element name="Param1" type="xs:string" nillable="true" minOccurs="0"/>
        <xs:element name="Param2" type="xs:string" nillable="true" minOccurs="0"/>
        <xs:element name="Param3" type="xs:string" nillable="true" minOccurs="0"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The BiddableAdGroupCriterion object derives from the AdGroupCriterion object. For a list of inherited elements, see the AdGroupCriterion object.

Element

Description

Data Type

Add

Update

CriterionBid

The bid to use in the auction.

CriterionBid

Required

Optional

DestinationUrl

The URL of the webpage that the user is taken to when they click the ad. The URL can contain a maximum of 1,024 characters. This destination URL is used if specified; otherwise, the ad’s destination URL is used.

The URL can include the dynamic text strings described in Dynamic Text for Product Ad Destination URL.

On update, to remove the destination URL, set it to an empty string.

string

Optional

Optional

EditorialStatus

The criterion’s editorial review status. The status indicates whether the criterion is pending review, has been approved, or has been disapproved.

The criterion is in effect only when its editorial status is approved. This means that if the ad group contained two criterions and the editorial status of one of the criterions was Active and the other was Inactive, only the Active criterion would be used to serve ads.

AdGroupCriterionEditorialStatus

Read-only

Read-only

Param1

The string to use as the substitution value if DestinationUrl contains {Param1:default}.

The string can contain a maximum of 1,022 characters. However, the actual limit depends on the length of the element that includes the substitution string.

For example, the destination URL can contain a maximum of 1,024 characters. If the URL contains a string that is 1,000 characters long (not including the length of {Param1}), the value of Param1 cannot exceed 24 characters.

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the element that includes it.

On update, to remove the parameter value, set it to an empty string.

string

Optional

Optional

Param2

The string to use as the substitution value if DestinationUrl contains {Param2:default}.

The string can contain a maximum of 70 characters. However, the actual limit depends on the length of the element that includes the substitution string.

For example, the destination URL can contain a maximum of 1,024 characters. If the URL contains a string that is 1,000 characters long (not including the length of {Param2}), the value of Param2 cannot exceed 24 characters.

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the element that includes it.

On update, to remove the parameter value, set it to an empty string.

string

Optional

Optional

Param3

The string to use as the substitution value if DestinationUrl contains {Param3:default}.

The string can contain a maximum of 70 characters. However, the actual limit depends on the length of the element that includes the substitution string.

For example, the destination URL can contain a maximum of 1,024 characters. If the URL contains a string that is 1,000 characters long (not including the length of {Param3}), the value of Param3 cannot exceed 24 characters.

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the element that includes it.

On update, to remove the parameter value, set it to an empty string.

string

Optional

Optional

Requirements

CampaignManagementService.svc v9

Namespace: https://bingads.microsoft.com/CampaignManagement/v9

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.