Location extensions

Location extensions allow you to show a business address, phone number, or map marker along with your ad text. Location extensions come in two flavors:

  • Google Ads location extensions help users find your locations by showing your ads with your address, a map to your location, or the distance to your business. This extension type is useful to draw customers to your brick-and-mortar location.

  • Affiliate location extensions help users find nearby stores of a retail chain that sell your products. This extension type is useful if you sell your products through retail chains, and want to reach consumers when they are deciding what and where to buy.

Affiliate location extensions differ from Google Ads location extensions in the following aspects:

Google Ads location extension Affiliate location extension
Advertiser should link to a Google My Business (GMB) account first. No linking to Google My Business accounts.
Feed locations are created from locations in the GMB account. Feed locations are populated based on a chain ID.
Only one feed is allowed per account. Multiple feeds allowed per account.

Create location extensions

The Google Ads API uses Feeds to manage affiliate location extensions. If you aren't familiar with the concept of feeds in Google Ads, read the feeds guide.

The process for creating both Google Ads location extensions and affiliate location extensions are similar.

  1. Create a new Feed and set its origin field to GOOGLE. Set the system_feed_generation_data field to provide additional details on how to populate the field. Perform a FeedService.MutateFeeds create operation to create the feed.

  2. Google Ads servers will then use the information provided within the system_feed_generation_data field to create and the feed and populate it. The following steps are performed.

    • Automatically create feed attributes for your feed.
    • Automatically create a FeedMapping for your feed.
    • Populate the feed with a list of FeedItems that corresponds to the relevant locations. The locations are populated either from the GMB account, or from the list of locations that corresponds to the retail chains that you specified when creating the feed.
  3. Wait for Google Ads API to set up your feed. This can be done by attempting to fetch the FeedMapping associated with the feed, and performing retries with an exponential backoff algorithm.

  4. Once the feed is ready, associate the feed with the customer by creating a CustomerFeed.

  5. Optionally, associate the feed to a customer, campaign, or ad group.