DynamicSearchAdsSetting Data Object - Campaign Management

Defines the Dynamic Search Ads setting for a campaign.

A dynamic search ads setting can only be created within search campaigns. The campaign's ExperimentId element can't be set and the AdGroupType must be set to "SearchDynamic".

Note

You can no longer add, update, or retrieve campaigns that only support dynamic search ads. The campaign type of your existing campaigns has been updated from "DynamicSearchAds" to "Search". The ad groups are now considered "dynamic" ad groups, but there are no structural changes i.e., they contain the same auto targets and dynamic search ads as before.

Syntax

<xs:complexType name="DynamicSearchAdsSetting" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Setting">
      <xs:sequence>
        <xs:element minOccurs="0" name="DomainName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DynamicDescriptionEnabled" nillable="true" type="xs:boolean">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element xmlns:q6="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="PageFeedIds" nillable="true" type="q6:ArrayOflong" />
        <xs:element minOccurs="0" name="Source" nillable="true" type="tns:DynamicSearchAdsSource" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The DynamicSearchAdsSetting object has the following elements: DomainName, DynamicDescriptionEnabled, Language, PageFeedIds, Source.

Element Description Data Type
DomainName Reserved. string
DynamicDescriptionEnabled Determines whether to automatically generate dynamic search ad text in addition to the ad text you provide. During ad delivery, we will use artificial intelligence to choose the best ad text available from these options.

Add: Optional. The default value of false will be set if not otherwise specified.
Update: Optional. If no value is set for the update, this setting is not changed.

Note: Not everyone has this feature yet. If you don't, don't worry - it's coming soon!
boolean
Language The language of the website pages that you want to target for dynamic search ads.

Your website language determines where your ads are eligible to appear. For example, a German-language ad can appear in Germany, Austria, and Switzerland, but not in Spain. If your website contains pages in multiple languages and you want to advertise all of these pages, you should create a separate campaign for each language.

The supported domain languages are Dutch, English, French, German, Italian, Spanish, and Swedish.

Note, if you set the campaign Languages or ad group Language, they will be ignored.

Add: Required
Update: Read-only and required. You cannot update the domain or language, but you must include the current domain and language when updating other properties such as Source.
string
PageFeedIds The page feed identifiers for dynamic search ads.

The Source determines whether or not Microsoft Advertising will use the associated page feeds.

See the Page Feeds technical guide for an implementation overview.

Add: Optional
Update: Optional. You cannot delete page feed IDs, but you can replace the previous set with a new set.
long array
Source Determines whether to use Bing's index, advertiser supplied URLs, or both.

By default only Bing's index is used.

Add: Optional
Update: Optional
DynamicSearchAdsSource

The DynamicSearchAdsSetting object has Inherited Elements.

Inherited Elements

Inherited Elements from Setting

The DynamicSearchAdsSetting object derives from the Setting object, and inherits the following elements: Type. The descriptions below are specific to DynamicSearchAdsSetting, 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 DynamicSearchAds when you retrieve a dynamic search ads setting. For more information about setting types, see the Setting Data Object Remarks.

Add: Read-only
Update: Read-only
string

Requirements

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