Use the featured product [featured_product]
attribute to link the products from your product feeds to the collection in which you'd like to feature them.
When to use
The featured product [featured_product]
attribute consists of two parts, the ID and the image coordinates, and a total of three sub-attributes:
- ID
[id]
: Required. - X
[x]
: float [0–1] ( Required for or used in Performance Max for shop goals).
X-coordinate of the product callout in consumer experiences - Y
[y]
: float [0–1] ( Required for or used in Performance Max for shop goals).
Y-coordinate of the product callout in consumer experiences
Note: For 'promoting local products within Performance Max for shop goals' format, you can provide random coordinates but the coordinate must be different for each featured product. For example, you can increment the coordinates by one for each featured product as shown below:
Featured product 1:0.01:0.01
Featured product 2:0.02:0.02
Featured product 3:0.03:0.03
Format
Follow these formatting guidelines to make sure that Google understands the data that you're submitting.
Type | id : Text (Unicode characters. Recommended: ASCII only) |
Limits | id : 1–50 characters |
Repeated field | Yes, up to 100 |
Guidelines
Follow these guidelines to make sure that you submit high-quality data for your collections.
File format | Example value |
Text (TSV) | winterhikingboot:0.54:0.9 |
XML (Feeds) | <g:featured_product> |
Minimum requirements
These are the requirements that you'll need to meet to show your collection. If you don't follow these requirements, we'll disapprove your collection and let you know in the Diagnostics page of your Merchant Center account.
- Use this attribute to list the featured products for this collection
- Make sure that the ID that you enter corresponds exactly to the ID of your product in your Merchant Center product data feed.
- If you add this attribute, the language attribute is also required.
- Optionally specify feed labels for collections that have featured products. This will help us to determine the specific products associated with each collection.
- Provide a maximum of 100 featured product
[featured_product]
attributes (for collections)
Best practices
These best practices can help you go beyond the basic requirements to optimise your collection data for performance.
Examples
Collection with multiple featured products
Product data for a winter shoe collection | |
Attribute | Value |
Collection [collection] |
Winter shoes |
Image link [image_link] |
https://www.example.com/image1.jpg |
Headline [headline] |
Winter footwear range 2019/20. |
ID [id] |
WinterShoes2019 |
Featured product [featured_product] |
SnowShoeBaseModel2019:0.54:0.9, WinterHikingBoots2019:0.67:0.44, Skiboots2019:0.28:0.76, WarmSlippers2019:0.38:0.25 |
Note: The ID in the above example is the collection ID, but not the product ID.