id: Definition

When to use

Required for Shopping ads. Optional for Shopping Actions.

Format

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

Type Unicode characters (Recommended: ASCII only): alphanumeric, underscores, and dashes 
Limits 1–50 characters
Repeated field No
Schema.org property
(What's this?)
Product.sku, Type: Text
 
File format Example value
Text feeds tddy123uk
XML feeds <g:id>tddy123uk</g:id>


For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • Use a unique ID for each different product. The ID allows you and Google to distinguish each product.
  • Use a stable ID for each product. Once you've assigned an ID to a product, don't change it. The ID you choose, in combination with country of sale and language, identifies the product, helps us to retrieve any product-specific information, and is used to track the product's advertising history in Merchant Center and Google Ads. If you change the ID, you'll overwrite your product and its history.
  • Use the same ID for the same product targeting different countries or different languages within the same country. Learn more about language requirements.
    • If you target a multilingual country, like Switzerland, use the same ID for a product shared in each supported language such as German, French, and Italian. 
    • If you target multiple countries, like the United States and Canada, use the same ID for a product shared between countries.
  • Don’t rely on casing to make IDs unique. For example, if you submit ID abc123 for one product and ID ABC123 for another, they may be interpreted as the same product in some places. Instead, use unique combinations of letters and numbers to differentiate products.
  • Don’t reuse or recycle the same ID for different products. For example:
    • Don’t reuse an ID for different products in the same country of sale or language. 
    • Don’t reuse an ID for products with variants. Each variant is a unique product and needs its unique ID.
    • Don’t reuse an ID if you sell a “promotion of the day.” IDs are linked to a product, not a promotion.
    • Don’t recycle an ID for new products. Even if you’re not selling a product anymore or the product is out of stock, don't use that product's ID for any other product.
  • Avoid white space. Consecutive white spaces and white spaces before and after the ID will be automatically removed. 
  • Don't submit invalid unicode characters. These characters are generally added during your file's encoding process. To avoid them, use UTF-8 encoding. To help prevent encoding issues, submit files in a compressed format. Examples of invalid unicode characters include:
    • Control characters (e.g., U+200D)
    • Function characters
    • Private area characters
    • Surrogate pairs
    • Unassigned code points 

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Use SKUs as IDs where possible. SKUs help us to understand the structure of your landing page. Since SKUs are unique, they can also help prevent you from accidentally reusing IDs.

Examples

Product without variants
Product Android Squishable
id 01ABC
Product with variants

Include a unique ID for each variant of the product. For example, if you have a parent SKU for a set of 4 variants of the same product, submit the parent SKU in the item_group_id attribute and a unique ID based on the parent SKU for the id attribute.

Product Google Malibu sunglasses
color Red
item_group_id 12345
id 12345-R
   
Product Google Malibu sunglasses
color Green
item_group_id 12345
id 12345-G
   
Product Google Malibu sunglasses
color Yellow
item_group_id 12345
id 12345-Y
   
Product Google Malibu sunglasses
color Blue
item_group_id 12345
id 12345-B
Same product submitted to multiple countries
Product Android Squishable
Country of sale United States
id 01ABC
   
Product Android Squishable
Country of sale Canada
id 01ABC
Was this helpful?
How can we improve it?