This guide provides an overview of the various types of extensions, which are all available both in extension setting services and feed services.
The "extension setting" indicates which extension setting class to use when
using extension setting services. The "placeholder type" indicates which
PlaceholderType
enum
value to specify when using feed services. The "placeholder field" indicates
which enumeration to use to specify fields when doing the mapping.
App extensions
App extensions allow you to link directly to your mobile app from your ads. Users can click on the ad headline to be taken to your site, or on the extension to be prompted to install the app directly.
- Extension setting:
AppFeedItem
- Placeholder type:
APP
- Placeholder field:
AppPlaceholderField
Call extensions
Call extensions let you add phone numbers to your ads. Users can tap on the phone number to call your business directly.
- Extension setting:
CallFeedItem
- Placeholder type:
CALL
- Placeholder field:
CallPlaceholderField
Callout extensions
Callout extensions let you include additional text, such as "Free shipping" or "Open 24/7", with your ad.
- Extension setting:
CalloutFeedItem
- Placeholder type:
CALLOUT
- Placeholder field:
CalloutPlaceholderField
Location extensions
Location extensions can help users find your locations by showing an address, map, or distance with your ad. Users can tap the extension to get further details on your location.
- Extension setting:
LocationFeedItem
- Placeholder type:
LOCATION
- Placeholder field:
LocationPlaceholderField
Affiliate location extensions
Affiliate location extensions allow you to show the retail chains that carry your products, and help users find those stores.
- Extension setting:
AffiliateLocationFeedItem
- Placeholder type:
AFFILIATE_LOCATION
- Placeholder field:
AffiliateLocationPlaceholderField
Price extensions
Price extensions appear below your text ad and can show a set of up to 8 cards that users can view to differentiate options and prices. Users can go directly to the item that interest them on your site.
- Extension setting:
PriceFeedItem
- Placeholder type:
PRICE
- Placeholder field:
PricePlaceholderField
Promotion extensions
Promotion extensions highlight special sales and offers with your ads.
- Extension setting:
PromotionFeedItem
- Placeholder type:
PROMOTION
- Placeholder field:
PromotionPlaceholderField
Structured snippet extensions
Structured snippet extensions are shown beneath your text ad in the form of a header (for example, "Destinations") and a list of values (for example, "Hawaii, Costa Rica, South Africa"). Only a predefined selection of headers is available (described in detail in the linked article).
- Extension setting:
StructuredSnippetFeedItem
- Placeholder type:
STRUCTURED_SNIPPET
- Placeholder field:
StructuredSnippetPlaceholderField
Lead form extensions
Lead form extensions (beta) help you generate leads by letting users submit a form directly in your ad. This is an asset-backed extension.
Image extensions
Image extensions (beta) allow advertisers to upload visuals to complement their existing text ads. These images appear on the Google search results page, along with the ad headlines and descriptions.
- Extension setting:
ImageFeedItem
- Placeholder type:
IMAGE