included_destination [included_destination]: Definition

Use the included_destination [included_destination] attribute (in addition to the excluded_destination [excluded_destination] attribute) to control where your products will appear.

When to use

Optional for each product

If you want to allow your product to appear in certain locations, use the included_destination [included_destination] attribute.

Supported values:

• Shopping ads.Allow your products to show in Shopping ads. Learn about Shopping ads
• Buy on Google listings. Allow your products to appear in Buy on Google listings. Learn more about Buy on Google
• Display ads. Allow your products to show in dynamic remarketing ads. Learn about dynamic remarketing for retail
• Local inventory ads. Allow your products to show in ads to shoppers near your shop. Learn more about local inventory ads
• Free listings. Allow your products to appear in free listings on Google. Learn more about listing your products for free on Google
• Free local listings. Allow your local products to appear in free local product listings on Google. Learn more about listing your local products for free on Google

Note: Some of the names for product destinations have been updated. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. These values will still be accepted, but we recommend that you update your products to include the new values for these destinations: Buy on Google listings, Free listings, Free local listings.

Format

Follow these formatting guidelines to make sure that we understand the data that you're submitting. 

Supported values	Shopping ads, Buy on Google listings, Display ads, Local inventory ads, Free listings, Free local listings
Repeated field	Yes

File format	Example value
Text feeds	Display ads
XML feeds	<g:included_destination>Display ads</g:included_destination>

Repeated fields

Text

To submit multiple destination that you would like to include, submit the attribute multiple times, once for each destination (recommended). For example:

Product	Orthopaedic dog bed
title [title]	XXL Orthopaedic Dog Bed
included_destination [included_destination]	Display ads
included_destination [included_destination]	Shopping ads
included_destination [included_destination]	Buy on Google listings

You can also separate each destination with a comma (,):

Display ads, Shopping ads ,Buy on Google listings

XML

To submit multiple destinations to include for an XML feed, include a separate attribute for each included destination:

<g:included_destination>Display ads</g:included_destination>
<g:included_destination>Shopping ads</g:included_destination>
<g:included_destination>Buy on Google listings</g:included_destination>

To format your data for Content API, have a look at the Content API for Shopping.

• Learn more about the format requirements for repeated and/or group attributes in text feeds
• Learn more about the format requirements for repeated and/or group attributes in Google sheets

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products.

• If you submit conflicting information for the excluded_destination [excluded_destination] and included_destination [included_destination] attributes, the excluded_destination [excluded_destination] value will always take precedence over the included_destination [included_destination] value.