Extension Setting Types

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.

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.

Call extensions

Call extensions let you add phone numbers to your ads. Users can tap on the phone number to call your business directly.

Callout extensions

Callout extensions let you include additional text, such as "Free shipping" or "Open 24/7", with your ad.

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.

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.

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.

Java

.NET

PHP

Python

Ruby

Perl

You can use GoogleAdsService.SearchStream (preferred) or GoogleAdsService.Search to export lead form submission data.

Here are some sample queries. You can choose other fields in the SELECT clause to filter in the WHERE clause.

SELECT
  customer.id
  lead_form_submission_data.resource_name,
  lead_form_submission_data.asset,
  lead_form_submission_data.campaign,
  lead_form_submission_data.ad_group,
  lead_form_submission_data.ad_group_ad,
  lead_form_submission_data.gclid,
  lead_form_submission_data.lead_form_submission_fields,
  lead_form_submission_data.submission_date_time
FROM lead_form_submission_data
WHERE
  lead_form_submission_data.resource_name = 'INSERT_RESOURCE_NAME'

In this case, the lead form submission data resource name is of the format customers/{customer_id}/leadFormSubmissionData/{lead_form_user_submission_id}.

SELECT
  customer.id,
  asset.id,
  asset.name,
  ad_group.id,
  ad_group.name,
  ad_group_ad.ad.id,
  ad_group_ad.ad.name,
  campaign.id,
  campaign.name,
  lead_form_submission_data.gclid
FROM lead_form_submission_data
WHERE
  lead_form_submission_data.resource_name = 'INSERT_RESOURCE_NAME'

Check out lead_form_submission_data for more fields to query.

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.

This is one of the few extensions which hasn't yet been announced as migrating to Assets yet.

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.

Promotion extensions

Promotion extensions highlight special sales and offers with your ads.

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).

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).