link [link]: Definition

When users click your ad, they're sent to a landing page on your website for the advertised product. Set the URL for this landing page with the link [link] attribute.

An illustration showing how an ad click leads to the product

When to use

Required for each product

Required for Shopping ads. Optional for Shopping Actions.

If you only submit the link [link] attribute, all desktop and mobile device users are directed to the landing page specified here. Learn about how link [link], mobile_link[mobile_link] and ads_redirect [ads_redirect] work together.

Format

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

Type URL (including http or https), ASCII characters only, and RFC 3986 compliant
Limits 1-2000 characters
Repeated field No
Schema.org property
(What is this?)
Offer.url, Type: URL
 
File format Example entry
Text feeds http://www.example.com/writing/google-pens
XML feeds <link>http://www.example.com/writing/google-pens</link>


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

Guidelines

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

Minimum requirements

These are the requirements that 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 on the Diagnostics page of your Merchant Center account. 

  • Link to a landing page that meets the requirements. Learn more about requirements for Google Shopping landing pages.
  • Ensure that your landing page is mobile friendly. Make sure that the landing page that you have submitted works on desktop and mobile devices. Your landing page must meet this requirement even if you also use the mobile_link [mobile_link] attribute.
  • Start with http or https and comply with RFC 3986. For example: http://www.example.com/writing/fiji-pens
  • Use your verified domain name. Make sure that you use the domain name that you verified (during account setup or through the Website Verification tab). Learn more about how to verify and claim your domain name.
  • Make sure that your URL can be crawled by Google. For example, ensure that your robots.txt file is configured correctly. Learn more about robots.txt files.
  • Replace any symbols or spaces with URL-encoded entities. For example, if your URL contains an &, then replace it with %26.
  • Don't require users to register, sign in or take any other actions to view information about your product. Make sure that users see your final landing page immediately after clicking your ad. 
  • Submit only one attribute per item. If you provide multiple link attributes for the same item, only one of them will be applied.
  • Use legally required redirects. For certain products, local laws may require that your users land on a separate page before your landing page. For example, you may need to verify age before users can access your site. After users get past this page, make sure that your landing page meets all the same guidelines described earlier. Learn more about requirements for Google Shopping landing pages.

Best practices

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

  • Use a stable URL. The URL that you include shouldn't change unless your landing page moves. For example, don't use URLs with timestamps or parts that could change every time you submit your product data. Whenever you change your URL, your landing page will need to be evaluated and crawled. This process could cause unnecessary load on your servers.
  • Pre-select the correct variant. Link to your landing page with the correct variant selected. Users who see the product that they clicked on are more likely to purchase it. Still, remember to submit your variant details through the appropriate attributes such as color [colour], size [size] and age_group [age_group].
  • Use the mobile_link [mobile_link] attribute along with the link [link] attribute if you have a separate landing page designed for mobile devices. Learn more about mobile link.
  • Use the ads_redirect [ads_redirect] attribute or the Google Ads tracking template for tracking purposes. Learn more about ads redirect or the Google Ads tracking template.
  • Use as few redirects as possible. Redirects increase the time between a user clicking your ad and loading your landing page. Lengthy loading times cause your users to have a negative experience.
  • Make sure that all redirects are to the same verified domain to prevent errors.
  • Use Schema.org microdata. Use microdata to indicate how elements on your landing page correspond with your product data. Specifically, make sure that your microdata matches the variant displayed on your landing page. Learn more about microdata

Examples

Submit the link [link] attribute without mobile_link [mobile_link] and ads_redirect [ads_redirect]
Product Google pens
link [link] www.test.com/123
ads_redirect [ads_redirect] None
mobile_link [mobile_link] None

Users on desktop and mobile who click your ad will be taken to: www.test.com/123.

Product without variants
Product Google pens
link [link] http://www.example.com/writing/google-pens
Product with variants

When including a URL for a product with variants, make sure that the variant is automatically selected based on the URL.

Product Google pens, black ink
link [link] http://www.example.com/writing/google-pens?colour=black
   
Product Google pens, red ink
link [link] http://www.example.com/writing/googlei-pens?colour=red
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue