ResponsiveAd Data Object - Campaign Management
A responsive ad format for audience ads and multimedia ads.
The ResponsiveAd object is used for both Multimedia ads in the search network and Audience ads in the Microsoft Audience Network. See the remarks section below for details about the key differentiators.
Note
Duplicate responsive ads are allowed in the same ad group.
<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Ad">
<xs:sequence>
<xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
<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="BusinessName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
<xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
<xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
<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="LongHeadline" nillable="true" type="tns:AssetLink" />
<xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
<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="Text" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
<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="Videos" nillable="true" type="tns:ArrayOfAssetLink">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elements
The ResponsiveAd object has the following elements: AdSubType, BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.
Element | Description | Data Type |
---|---|---|
AdSubType | The possible ad sub types. | AdSubType |
BusinessName | The name of the business. Your business's name may appear in your ad, depending on the ad placement. The length of the string is limited to 25 characters. Add: Required Update: Optional. If no value is set for the update, this setting is not changed. |
string |
CallToAction | A brief, punchy reason for customers to click your ad right now. This is displayed on your call to action button. Add: Not applicable for audience ads; Required for multimedia ads Update: Optional. If no value is set for the update, this setting is not changed. |
CallToAction |
CallToActionLanguage | The language that the call to action will be served in. The call to action will always be served in this language, regardless of the campaign's language settings. Add: Not applicable for audience ads; Required for multimedia ads Update: Optional. If no value is set for the update, this setting is not changed. |
LanguageName |
Descriptions | The descriptions that are shown below the path in your ad. To maximize impressions across all ad formats, the descriptions might not always be shown in your ad. To maximize impressions across all ad formats the descriptions might not always be shown in your ad. Unless you pin one of the descriptions to a specific position, Bing will optimize the ad layout dynamically with the best headlines and descriptions for the user's search query. From a data model perspective the desriptions and headlines are each stored as text assets i.e., one TextAsset per AssetLink. The same asset can be used by multiple ads. For example if "Seamless Integration" is a text asset, it will have the same asset identifier across all ads in the same Microsoft Advertising account. You must set between 1-5 descriptions. Each description's Text must contain at least one word. For efficient use of resources we recommend that you use dynamic text strings such as {keyword} instead of creating new ad copy for each keyword. For more information, see the Microsoft Advertising help article Automatically customize your ads with dynamic text parameters. The maximum input length of each description's Text is 1,000 characters including dynamic text strings, and of those 1,000 no more than 90 final characters are allowed after substitution. The ad will fail to display or default text will be used if the length exceeds 90 characters after dynamic text substitution occurs. For languages with double-width characters e.g. Traditional Chinese the maximum input length is 500 characters including dynamic text strings, and of those 500 no more than 45 final characters are allowed after substitution. The ad will fail to display or default text will be used if the length exceeds 45 characters after dynamic text substitution occurs. The double-width characters are determined by the characters you use instead of the character set of the campaign or ad group language settings. Double-width characters include Korean, Japanese and Chinese languages characters as well as Emojis. The Text cannot contain the newline (\n) character. Add: Required for multimedia ads and audience ads. Not applicable for video ads. Update: Optional. To retain all of the existing asset links, set or leave this element nil. If you set this element, any descriptions that were previously linked to this ad will be replaced. |
AssetLink array |
Headline | Headlines are the most prominent text that appears in your ad, so you should make the most out of the available characters. We require multiple headlines so the ad can flexibly display across a variety of publishers and placements. The length of the string is limited to 30 characters. Add: Required for video ads. Not applicable for multimedia ads and audience ads. Update: Optional. Deprecated for multimedia and audience ads. Use Headlines instead. |
string |
Headlines | Headlines are the most prominent text that appears in your ad, so you should make the most out of the available characters. We require multiple headlines so the ad can flexibly display across a variety of publishers and placements. Unless you pin one of the headlines to a specific position, Bing will optimize the ad layout dynamically with the best headlines and descriptions for the user's search query. From a data model perspective the desriptions and headlines are each stored as text assets i.e., one TextAsset per AssetLink. The same asset can be used by multiple ads. For example if "Seamless Integration" is a text asset, it will have the same asset identifier across all ads in the same Microsoft Advertising account. You must set between 1-15 headlines. Each headline's Text must contain at least one word. For efficient use of resources we recommend that you use dynamic text strings such as {keyword} instead of creating new ad copy for each keyword. For more information, see the Microsoft Advertising help article Automatically customize your ads with dynamic text parameters. The maximum input length of each headline's Text is 1,000 characters including dynamic text strings, and of those 1,000 no more than 30 final characters are allowed after substitution. The ad will fail to display or default text will be used if the length exceeds 30 characters after dynamic text substitution occurs. For languages with double-width characters e.g. Traditional Chinese the maximum input length is 500 characters including dynamic text strings, and of those 500 no more than 15 final characters are allowed after substitution. The ad will fail to display or default text will be used if the length exceeds 15 characters after dynamic text substitution occurs. The double-width characters are determined by the characters you use instead of the character set of the campaign or ad group language settings. Double-width characters include Korean, Japanese and Chinese languages characters as well as Emojis. The Text cannot contain the newline (\n) character. Add: Required for multimedia ads and audience ads. Not applicable for video ads. Update: Optional. To retain all of the existing asset links, set or leave this element nil. If you set this element, any headlines that were previously linked to this ad will be replaced. |
AssetLink array |
Images | Image assets with different sizes and aspect ratios so they can flexibly display across a variety of publishers and placements. Include one or more AssetLink objects that each contain an ImageAsset with SubType and crop settings that match the desired aspect ratio. For more information see the remarks below. Add: Required Update: Optional. If no value is set for the update, this setting is not changed. If you include images during update, any previously set images will be replaced. |
AssetLink array |
ImpressionTrackingUrls | The URLs for 1x1 impression tracking pixels. Each pixel will report Microsoft Audience Network impressions to your third-party ad reporting tool. You can include up to 2 impression tracking URLs for each responsive ad. Each URL must be accessible. The length of the URL is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit. For each Microsoft Audience Network impression, Microsoft will ping the URL to enable impression tracking in your third party ad reporting tool. Advanced-level user tracking such as conversion tracking or tracking based on cookies or IP addresses is not supported. This element is not returned by default. To get this element, include the ImpressionTrackingUrls value in the ReturnAdditionalFields element when you call the GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds service operations. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed. To remove impression tracking URLs set this element to an empty string array. |
string array |
LongHeadline | For Audience campaigns, LongHeadline is the longer of two possible responsive ad headlines. | AssetLink |
LongHeadlines | You must set between 1-5 long headlines. Each headline's Text must contain at least one word. The Text cannot contain the newline (\n) character. If the parent campaign associates to a store and you specify LongHeadlines, you must also specify Headlines, Descriptions, and Images. Add: Optional if the parent campaign associates to a store, required if its parent campaign does not associate to a store. Will use LongHeadlineString if empty. Update: Optional. To retain all of the existing asset links, set or leave this element nil. If you set a value for this element, any headlines that were previously linked to this asset group will be replaced. If the parent campaign associates to a store and you set this element to an empty list, the previous setting will be deleted. |
AssetLink array |
LongHeadlineString | Headlines are the most prominent text that appears in your ad, so you should make the most out of the available characters. We require multiple headlines so the ad can flexibly display across a variety of publishers and placements. The length of the string is limited to 90 characters. Add: Optional. Ignored when LongHeadlines is provided. We will fill in LongHeadlines with LongHeadlineString if LongHeadlines is empty. Not applicable for multimedia ads. Update: Optional. If no value is set for the update, this setting is not changed. |
string |
Text | This text will appear below or adjacent to your ad's long or short headline, depending on the ad placement. You have more character space to work with in the ad text than in the headline. So once the imagery and headline have a potential customer's attention, the ad text needs to convince them to click it. What sets your product or service apart? The text must contain at least one word. The length of the string is limited to 90 characters. The text cannot contain the newline (\n) character. Add: Required for video ads. Not applicable for multimedia ads and audience ads. Update: Optional for video ads. Use Descriptions instead for audience ads or multimedia ads (deprecated). |
string |
VerifiedTrackingSettings | VerifiedTrackingSetting relates third-party measurement settings. This allows you to track viewability, brand safety, and invalid traffic metrics via a third-party verification provider, such as Integral Ad Science. This feature is available for native, display, and online video ads using the CPM bid strategy. Note: Currently, IAS is the only supported vendor (vendorName), but other verification providers are coming soon. The example below pertains to IAS. There are 3 key-value pairs for IAS:
|
VerifiedTrackingSetting |
Videos | Video assets with different sizes and aspect ratios so they can flexibly display across a variety of publishers and placements. Include one or more AssetLink objects that each contain a VideoAsset with a SubType. Add: Required for video ads Update: Optional. If no value is set for the update, this setting is not changed. If you include videos during an update, any previously set videos will be replaced. |
AssetLink array |
The ResponsiveAd object has Inherited Elements.
Inherited Elements
Inherited Elements from Ad
The ResponsiveAd object derives from the Ad object, and inherits the following elements: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. The descriptions below are specific to ResponsiveAd, and might not apply to other objects that inherit the same elements from the Ad object.
Element | Description | Data Type |
---|---|---|
AdFormatPreference | Not supported for this ad type. | string |
DevicePreference | Not supported for this ad type. | long |
EditorialStatus | The editorial review status of the ad, which indicates whether the ad is pending review, has been approved, or has been disapproved. Add: Read-only Update: Read-only |
AdEditorialStatus |
FinalAppUrls | Not supported for this ad type. | AppUrl array |
FinalMobileUrls | The mobile landing page URL. The following validation rules apply to Final URLs and Final Mobile URLs. - The length of the URL is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit. - You may specify up to 10 items for both FinalUrls and FinalMobileUrls; however, only the first item in each list is used for delivery. The service allows up to 10 for potential forward compatibility. - Usage of '{' and '}' is only allowed to delineate tags, for example {lpurl}. - Final URLs must each be a well-formed URL starting with either http:// or https://. - If you specify FinalMobileUrls, you must also specify FinalUrls. - You may not specify FinalMobileUrls if the device preference is set to mobile. This URL is used only if the keyword does not specify a final mobile URL. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed. If you set this element to an empty list, the previous setting will be deleted. |
string array |
FinalUrls | The landing page URL. The domain portion of the URL in combination with the path 1 and path 2 strings cannot exceed 67 characters. The following validation rules apply to Final URLs and Final Mobile URLs. - The length of the URL is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit. - You may specify up to 10 items for both FinalUrls and FinalMobileUrls; however, only the first item in each list is used for delivery. The service allows up to 10 for potential forward compatibility. - Usage of '{' and '}' is only allowed to delineate tags, for example {lpurl}. - Final URLs must each be a well-formed URL starting with either http:// or https://. - If you specify FinalMobileUrls, you must also specify FinalUrls. - You may not specify FinalMobileUrls if the device preference is set to mobile. Also note that if this ad's TrackingUrlTemplate or UrlCustomParameters element are set, then at least one final URL is required. This URL is used only if the keyword does not specify a final URL. Add: Required Update: Optional |
string array |
FinalUrlSuffix | The final URL suffix can include tracking parameters that will be appended to the end of your landing page URL. We recommend placing tracking parameters that your landing page requires in a final URL suffix so that your customers are always sent to your landing page. For more details and validation rules see Final URL Suffix in the technical guides. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed. If you set this element to an empty string (""), the previous setting will be deleted. |
string |
ForwardCompatibilityMap | The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version. Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for this object. |
KeyValuePairOfstringstring array |
Id | The unique Microsoft Advertising identifier of the ad. Add: Read-only Update: Required and Read-Only |
long |
Status | The status of the ad. You can set the ad status to Active or Paused. Add: Optional Update: Optional |
AdStatus |
TrackingUrlTemplate | The tracking template to use as a default for all landing page URLs. The following validation rules apply to tracking templates. For more details about supported templates and parameters, see the Microsoft Advertising help article What tracking or URL parameters can I use? - Tracking templates defined for lower level entities e.g. ads override those set for higher level entities e.g. campaign. For more information, see Entity Limits. - The length of the tracking template is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit. - The tracking template must be a well-formed URL beginning with one of the following: http://, https://, {lpurl}, or {unescapedlpurl}. - Microsoft Advertising does not validate whether custom parameters exist. If you use custom parameters in your tracking template and they do not exist, then the landing page URL will include the key and value placeholders of your custom parameters without substitution. For example, if your tracking template is https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} and neither {_season} or {_promocode} are defined at the campaign, ad group, criterion, keyword, or ad level, then the landing page URL will be the same.Add: Optional Update: Optional. If no value is set for the update, this setting is not changed. If you set this element to an empty string (""), the previous setting will be deleted. |
string |
Type | The type of the ad. This value is ResponsiveAd when you retrieve a responsive ad. For more information about ad types, see the Ad Data Object Remarks. Add: Read-only Update: Read-only |
AdType |
UrlCustomParameters | Your custom collection of key and value parameters for URL tracking. Microsoft Advertising will accept the first 8 CustomParameter objects that you include within the CustomParameters object, and if you include more than 8 custom parameters an error will be returned. Each CustomParameter includes Key and Value elements. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed. Set the UrlCustomParameters element to null or empty to retain any existing custom parameters. To remove all custom parameters, set the Parameters element of the CustomParameters object to null or empty. To remove a subset of custom parameters, specify the custom parameters that you want to keep in the Parameters element of the CustomParameters object. |
CustomParameters |
Remarks
The ResponsiveAd object is used for Multimedia ads in the search network and Audience ads in the Microsoft Audience Network.
Most supported properties are the same, but here are some of the key differentiators.
- For audience ads you'll set BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines, and Descriptions.
- For multimedia ads you'll set BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Images, and LongHeadlines.
Note
The data for Images are provisioned via the AddMedia operation. You can use the GIF, JPEG, or PNG MIME types. Images with animation are not supported. Although you can only add media with a few aspect ratios via the AddMedia operation, you can use ImageAsset crop settings to determine the effective aspect ratio in the context of each responsive ad AssetLink. The aspect ratio of the stored image would be unchanged in the account level media library.
The maximum file size is 5 MB. The maximum width and height in pixels are 2592 and 2048 independently, and you must still maintain one of the supported aspect ratios. For example if the image asset with sub type LandscapeImageMedia is 2592 in width, then the height must be 1357.
Multimedia ad images
For multimedia ads you'll create multiple image assets with different sizes and aspect ratios. You need to add at least 1 image with 1.91:1 aspect ratio and 1 image with 1:1 aspect ratio.
In the Images element include one or more AssetLink objects. Each asset link contains an ImageAsset with SubType set to one of the string values in the table below.
Sub Type | Aspect ratio | Minimum dimensions in pixels |
---|---|---|
LandscapeImageMedia | 1.91:1 | 703 width x 368 height |
ImageMedia4x1 | 4:1 | 608 width x 152 height |
SquareImageMedia | 1:1 | 470 width x 470 height |
ImageMedia1x2 | 1:2 | 470 width x 940 height |
Multimedia ad logos
For multimedia ads you'll create multiple logo assets with different sizes, aspect ratios, and crop settings so they can flexibly displayed in the thumbnail list.
The sub type must be set to "Logo" if the image is associated with an ad as a "LandscapeLogoMedia" or "SquareLogoMedia".
Sub Type | Aspect ratio | Minimum dimensions in pixels |
---|---|---|
LandscapeLogoMedia | 4:1 | 512 width x 128 height |
SquareLogoMedia | 1:1 | 128 width x 128 height |
Audience ad images
For audience ads you'll create multiple image assets with different sizes, aspect ratios, and crop settings so they can flexibly display across a variety of publishers and placements.
In the Images element include one or more AssetLink objects. Each asset link contains an ImageAsset with SubType set to one of the string values in the table below.
Note
The image sub types and in the table below for Audience ads version 2 and are currently in pilot.
Sub Type | Aspect ratio | Minimum dimensions in pixels |
---|---|---|
OriginalImage | N/A | 703 width x 368 height |
LandscapeImageMedia | 1.91:1 | 300 width x 157 height |
SquareImageMedia | 1:1 | 114 width x 114 height |
ImageMedia201X100 | 2.01:1 | 612 width x 304 height |
ImageMedia120X100 | 1.2:1 | 300 width x 250 height |
ImageMedia200X100 | 2:1 | 200 width x 100 height |
ImageMedia169X100 | 1.69:1 | 628 width x 372 height |
ImageMedia124X100 | 1.24:1 | 104 width x 84 height |
ImageMedia153X100 | 1.53:1 | 306 width x 200 height |
Note
The image sub types in the table below are for Audience ads version 1.
Sub Type | Minimum dimensions in pixels |
---|---|
LandscapeImageMedia | 703 width x 368 height Aspect radio 1.91:1 |
SquareImageMedia | 300 width x 300 height Aspect radio 1:1 |
ImageMedia169X100 | 622 width x 368 height Aspect radio 1.69:1 |
ImageMedia93X100 | 311 width x 333 height Aspect radio 0.93:1 |
ImageMedia15X10 | 300 width x 200 height Aspect radio 1.5:1 |
ImageMedia155X100 | 300 width x 194 height Aspect radio 1.55:1 |
ImageMedia133X100 | 100 width x 75 height Aspect radio 1.33:1 |
ImageMedia178X100 | 624 width x 350 height Aspect radio 1.78:1 |
ImageMedia172X100 | 300 width x 174 height Aspect radio 1.72:1 |
You are only required to provide a default image OriginalImage image asset (the default image was previously LandscapeImageMedia). In the Images element include an AssetLink that contains one ImageAsset with SubType set to OriginalImage. The recommended dimensions for the OriginalImage are 1200 width x 628 height. Optionally you can include additional asset links, i.e., one image asset for each supported sub type. For any image asset sub types that you do not explicitly set, Microsoft Advertising will automatically create image asset links by cropping the OriginalImage.
Given the GetAdsByAdGroupId response example below, please take note of the following:
- The same image asset identifier (e.g., 1234567890000) is used for all auto-generated image asset sub types. Whether or not you let Microsoft Advertising automatically generate the cropped images, the Id does not need to be unique among the image assets linked to the same ad.
- Because the ad in this example was created without crop settings for the OriginalImage image asset sub type, all image assets are cropped except for the OriginalImage associated image.
- Microsoft Advertising will use the crop settings of the OriginalImage for all of the default crop settings. In this example the crop height for all system-generated image assets is 628, and we can infer that the OriginalImage (OriginalImage sub type) with 1.91:1 aspect ratio has width and height of 1200x628. The crop settings of the auto-generated image assets are based on the crop settings of the OriginalImage asset link.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
</s:Header>
<s:Body>
<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Ad i:type="ResponsiveAd">
<AdFormatPreference i:nil="true"/>
<DevicePreference>0</DevicePreference>
<EditorialStatus>Inactive</EditorialStatus>
<FinalAppUrls i:nil="true"/>
<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://mobile.contoso.com/womenshoesale</a:string>
</FinalMobileUrls>
<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://www.contoso.com/womenshoesale</a:string>
</FinalUrls>
<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
<Id>9876543210000</Id>
<Status>Active</Status>
<TrackingUrlTemplate i:nil="true"/>
<Type>ResponsiveAd</Type>
<UrlCustomParameters i:nil="true"/>
<BusinessName>Contoso</BusinessName>
<CallToAction>AddToCart</CallToAction>
<Headline>Fast & Easy Setup</Headline>
<Images>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight i:nil="true"/>
<CropWidth i:nil="true"/>
<CropX i:nil="true"/>
<CropY i:nil="true"/>
<SubType>OriginalImage</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>628</CropWidth>
<CropX>286</CropX>
<CropY>0</CropY>
<SubType>SquareImageMedia</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>942</CropWidth>
<CropX>129</CropX>
<CropY>0</CropY>
<SubType>ImageMedia15X10</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>835</CropWidth>
<CropX>183</CropX>
<CropY>0</CropY>
<SubType>ImageMedia133X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>1118</CropWidth>
<CropX>41</CropX>
<CropY>0</CropY>
<SubType>ImageMedia178X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
</Images>
<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
<LandscapeLogoMediaId i:nil="true"/>
<LongHeadline>Find New Customers & Increase Sales!</LongHeadline>
<SquareImageMediaId>1234567890000</SquareImageMediaId>
<SquareLogoMediaId i:nil="true"/>
<Text>Find New Customers & Increase Sales! Start Advertising on Contoso Today.</Text>
</Ad>
</Ads>
</GetAdsByAdGroupIdResponse>
</s:Body>
</s:Envelope>
Requirements
Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
Used By
CreateResponsiveAdRecommendation
RefineResponsiveAdRecommendation