This guide provides an overview of the various types of extensions, which are all available in extension setting services, feed services, and asset services.
The "asset" indicates the class to use when managing extensions using asset
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.
Affiliate location extensions
Affiliate location extensions let 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
App extensions
App extensions let 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.
- Asset:
CalloutAsset - Extension setting:
CalloutFeedItem - Placeholder type:
CALLOUT - Placeholder field:
CalloutPlaceholderField
Hotel callout extensions
Hotel callout extensions let you include additional information (up to 2 lines of customizable text) in your ad inside the hotel booking module.
- Extension setting:
HotelCalloutFeedItem - Placeholder type:
CALLOUT - Placeholder field:
HotelPlaceholderField
Image extensions
Image extensions (beta) let you upload visuals to complement your 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 - Placeholder field:
ImagePlaceholderField
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-based extension.
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
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.
- Asset:
PromotionAsset - Extension setting:
PromotionFeedItem - Placeholder type:
PROMOTION - Placeholder field:
PromotionPlaceholderField
Sitelink extensions
Sitelink extensions let you add more links to your ads. They can take users to specific pages on your site (for example, a specific product or store hours).
- Asset:
Sitelink - Extension setting:
SitelinkFeedItem - Placeholder type:
SITELINK - Placeholder field:
SitelinkPlaceholderField
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).
- Asset:
StructuredSnippetAsset - Extension setting:
StructuredSnippetFeedItem - Placeholder type:
STRUCTURED_SNIPPET - Placeholder field:
StructuredSnippetPlaceholderField