Ad Extensions
Ad extensions are additional pieces of information about your business, like a phone number or a link to a specific page on your website, you can add to your ads. Ad extensions are free to add to your ads, with the usual charges for any clicks you get. Including ad extensions can improve the visibility of your ads, which can lead to more clicks and improve your ROI.
There are many types of ad extensions available in Microsoft Advertising: Action Extensions, App Extensions, Call Extensions, Callout Extensions, Filter Link Extensions, Flyer Extensions, Image Extensions, Location Extensions, Price Extensions, Promotion Extensions, Review Extensions, Sitelink Extensions, and Structured Snippet Extensions. For more about ad extensions, see the About ad extensions help article.
Tip
Providing extension data allows our algorithms to evaluate all the possible layouts for your ad. It increases the changes of additional space being allocated and increasing clicks for your ad.
Ad extensions are stored in a shared library at the account level. After adding the extension to your shared library, you must also explicitly associate it with the account or one or more campaigns or ad groups within the account for the extension to become eligible for delivery. For more details on associating ad extensions, see Managing Ad Extensions with the Bulk Service and Managing Ad Extensions with the Campaign Management Service in the sections below. For ad extension association limits per entity, please see Entity Limits for Ad Extensions.
Note
Call ad extensions can only be associated at the campaign level.
Location ad extensions can only be associated at the account and campaign level i.e., cannot be associated with ad groups.
You can associate ad extensions at the ad group, campaign, or account level. When ad extensions from higher levels in your account are predicted to improve your performance, they are eligible to serve alongside extensions of the same type from lower levels. We recommend that you associate extensions at a level that makes sense for your account and ensure they're relevant for any subsequent levels.
You can manage ad extensions with either the Bulk Service or Campaign Management Service. You should use the Bulk Service if you need to upload or download a high volume of entity settings. For example you can update all ad extensions for your entire account in a single upload. In comparison, with the Campaign Management Service you can only update 100 ad extensions per call. For details see the following sections.
Ad Extension Types
Ad extension types include Action Extensions, App Extensions, Call Extensions, Callout Extensions, Filter Link Extensions, Flyer Extensions, Image Extensions, Location Extensions, Price Extensions, Promotion Extensions, Review Extensions, Sitelink Extensions, and Structured Snippet Extensions.
Action Extensions
With Action Extensions, your ads will include with a call-to-action button.
App Extensions
With App Extensions, your ads will include a link to install an application.
Call Extensions
With Call Extensions, you can provide a phone number that is not associated with a particular location, but is appropriate for all locations where your ads display. In comparison, you typically use Location Extensions to provide an address and local phone number associated with a local location.
If the campaign is also associated with a Location Extensions, the call extension phone number will override the location extension phone number.
Callout Extensions
With Callout Extensions, you can provide an extra snippet of text that highlights your business, products, or services to include in An ad. This extension is not clickable and can appear in addition to your ad's description. Providing additional details about your store can make your ad more relevant to potential customers.
Each account, campaign, or ad group can be associated with between 2 and 20 callout ad extensions. If you associate one or fewer callout extensions with your account, campaign, or ad group, no callout text will serve with your ad. An ad may include between 2 to 4 callouts per impression.
Filter Link Extensions
With Filter Link Extensions, your ads will include one header with between 3 and 10 clickable text values that tell customers more about your business.
Flyer Extensions
Flyer Extensions enable advertisers to distribute product or store catalogues (flyers) to potential customers. They can display prominently on broad queries like "weekly deals" or "weekly sales" and thus encourage shoppers to click on your ad instead of the competition's. By their nature they help to better inform searchers, and as a result, increase user engagement e.g., click through rate.
Image Extensions
With Image Extensions, your ads may include an image or alternative text.
Location Extensions
With Location Extensions, you can choose to show the address of your business location that is closest to the customer and also include a local phone number. Better yet, if the customer is viewing your ad on a smartphone, they can click that number to give you a call.
If the campaign is also associated with a Call Extensions, the phone number in the call extension will override the location extension phone number.
Logo Ad Extensions
With Logo Ad Extensions, you can promote your brand and stand out from the competition by displaying eye-catching logos in your ads. Logo extensions help you build brand recognition to drive more clicks and conversions on your website.
You can associate your logo extensions at the account, campaign, or ad group levels, but only one extension is allowed per level. Please note we'll prioritize logo extensions during ad delivery over any automated business logo extensions you have set up.
Conversational Bing layout
Bing search engine results page layout
Price Extensions
With Price Extensions, prices for your products or services are shown to potential customers. Price Extensions only show on ads listed at the top of the results page, helping to increase your clicks. Keep in mind that though Price Extensions are free to add to your ad, they may not always show for every query.
Promotion Extensions
Promotion Extensions highlight special sales and offers in your text ads. By making offers stand out, potential customers are more likely to click on your ad, helping to generate more sales for you.
Note
Promotion Extensions are available for customers in AU, CA, DE, FR, US and UK.
Review Extensions
Potential customers like to know about other customers' experiences when searching for products or services. Share positive reviews from a reputable third-party source about your business, products, or services in your ads with a Review Extension. An ad will only include one review per impression.
Sitelink Extensions
Sitelink Extensions are additional links in your ads that take customers to specific pages on your website. This allows you to promote certain products, services, or sections of your website and take potential customers to exactly the information they were searching for. This can increase both click-through-rate and conversions.
You may associate site links ad extensions with your campaigns or ad groups, and your ads will include up to 10 links to relevant web pages within your website. When displaying an ad, Microsoft Advertising determines which links are most relevant to the ad being displayed and includes those with your ad. You can influence which links are included. Links that you specify at the beginning of your list receive higher priority than those toward then end of your list.
Structured Snippet Extensions
Structured Snippet Extensions give potential customers more context on a specific aspect of your products and services. A Structured snippet is made up of a header and a list of 3-10 values which correspond to the header. For example, you might use the header "Brands:" and the values "Windows, Xbox, Skype" to let customers know about what brands are available at your store.
This extension is not clickable and, similar to other extensions, will appear beneath your ad's description. Structured Snippets have no impact on the other extensions you're already using. Structured Snippets should not duplicate what is already stated in the ad. Our full list of Structured Snippet policies can be found here.
An ad will only include one structured snippet (one headline with 3 - 10 values) per impression. Keep in mind that your ads won't always show Structured Snippets and if they do show Structured Snippets, the format they appear may vary. Structured Snippets are free to add to your ad, available in all Microsoft Advertising markets (excluding Hong Kong SAR and Taiwan), and serve on desktop and tablet devices.
Managing Ad Extensions with the Bulk Service
You can use the Bulk Service i.e., Bulk Download and Upload to create, get, update, and delete both ad extensions and ad extension associations.
The following Bulk records are available for managing ad extensions and ad extension associations.
Action Extensions
- Action Ad Extension
- Account Action Ad Extension
- Campaign Action Ad Extension
- Ad Group Action Ad Extension
App Extensions
Call Ad Extensions
Callout Ad Extensions
- Callout Ad Extension
- Account Callout Ad Extension
- Campaign Callout Ad Extension
- Ad Group Callout Ad Extension
Filter Link Ad Extensions
- Filter Link Ad Extension
- Account Filter Link Ad Extension
- Campaign Filter Link Ad Extension
- Ad Group Filter Link Ad Extension
Flyer Ad Extensions
- Flyer Ad Extension
- Account Flyer Ad Extension
- Campaign Flyer Ad Extension
- Ad Group Flyer Ad Extension
Image Ad Extensions
- Image Ad Extension
- Account Image Ad Extension
- Campaign Image Ad Extension
- Ad Group Image Ad Extension
Location Ad Extensions
Logo Ad Extensions
Price Ad Extensions
- Price Ad Extension
- Account Price Ad Extension
- Campaign Price Ad Extension
- Ad Group Price Ad Extension
Promotion Ad Extensions
- Promotion Ad Extension
- Account Promotion Ad Extension
- Campaign Promotion Ad Extension
- Ad Group Promotion Ad Extension
Review Ad Extensions
- Review Ad Extension
- Account Review Ad Extension
- Campaign Review Ad Extension
- Ad Group Review Ad Extension
Sitelink Ad Extensions
- Sitelink Ad Extension
- Account Sitelink Ad Extension
- Campaign Sitelink Ad Extension
- Ad Group Sitelink Ad Extension
Structured Snippet Ad Extensions
- Structured Snippet Ad Extension
- Account Structured Snippet Ad Extension
- Campaign Structured Snippet Ad Extension
- Ad Group Structured Snippet Ad Extension
Managing Ad Extensions with the Campaign Management Service
You can use the Campaign Management Service to create, get, update, and delete both ad extensions and ad extension associations.
For code examples that show how to set up ad extensions using the Campaign Management service, see Ad Extensions Code Example.
Entities
These are the ad extension entities that can be accessed using the Campaign Management Service. You can create, read, update, and delete these entities.
- ActionAdExtension
- AppAdExtension
- CallAdExtension
- CalloutAdExtension
- FilterLinkAdExtension
- FlyerAdExtension
- ImageAdExtension
- LocationAdExtension
- PriceAdExtension
- PromotionAdExtension
- ReviewAdExtension
- SitelinkAdExtension
- StructuredSnippetAdExtension
Note
The AdExtension object is the base class from which all ad extensions are derived.
Service Operations
These are the Campaign Management Service service operations that can be used to add, get, update, and delete ad extensions.
- AddAdExtensions
- SetAdExtensionsAssociations
- GetAdExtensionsByIds
- GetAdExtensionIdsByAccountId
- GetAdExtensionsAssociations
- UpdateAdExtensions
- DeleteAdExtensions
- DeleteAdExtensionsAssociations
Note
Partial update is not supported for ad extensions. Any optional elements which are not sent with the UpdateAdExtensions request will in effect be deleted from the extension.
Partial success is not supported when adding, updating, and deleting ad extensions. For example if you submit 10 ad extensions and 2 fail, the entire batch will fail.
Partial success is supported for GetAdExtensionsAssociations and SetAdExtensionsAssociations. For example if you submit 10 ad extension associations and 2 fail, the remaining 8 will succeed. For more information, see Partial Success using the Campaign Management Service.
Editorial Review
When you associate an ad extension with a campaign or ad group, the extension goes through an initial editorial review. For more information, see Ad Extension Editorial Review.
Reporting
You can use the following reports to get statistics about the effectiveness of the ad extensions that you've included in your ads.
AdExtensionByAdReportRequest - Aggregates performance data by ad for a specified time period. By including performance details, such as clicks, conversion, and spend, you can identify ad extensions that are performing well, and those that may need to be adjusted to optimize the monthly budget.
AdExtensionByKeywordReportRequest - Aggregates performance data by keyword for a specified time period. By including performance details, such as clicks, conversion, and spend, you can identify ad extensions that are performing well, and those that may need to be adjusted to optimize the monthly budget.
AdExtensionDetailReportRequest - Lists all versions of an ad extension by account. You can use this information along with the performance data from the other two reports to determine which version performed better.
For more information about reporting, see Reporting API Guides and Request and Download a Report.