Regional availability and pricing

Regional availability and pricing is an add-on feature available in Merchant Center Next. This article explains the benefits of using Regional availability and how it works. It lets you show product availability and variable pricing based on your business presence and the location of your customer base by providing regional overrides for the national availability and/or pricing.

Regional availability and pricing; an example of how it works

Example

Your business might only have a presence in certain parts of the country or particular cities within a state, or you might sell food products that vary in price depending on the region they are purchased in. This feature allows you to specify the regions where your products are available and control pricing regionally.

Regional availability and pricing is available for offers with target countries:

  • Australia, Brazil, France, Russia, United States

Regional availability and pricing is in beta for these countries:

  • Argentina, Austria, Canada, Chile, Columbia, Czech Republic, Denmark, Germany, Great Britain, Hungary, India, Indonesia, Italy, Japan, Malaysia, Mexico, the Netherlands, New Zealand, Norway, Pakistan, Peru, Philippines, Romania, South Africa, South Korea, Spain, Sweden, Thailand, and Vietnam

In this article


Benefits

Regional availability and pricing helps you:

  • Promote inventory that's regionally priced, in stock, and available to ship.
  • Ensure that your online products are shown to the correct audience and you only pay for clicks where your products are available, as your products will only be shown to users in the custom regions you define.
  • Expand your reach to delivery areas outside the radius of your stores, if you use local inventory ads.
Note: If a local inventory ads (LIA) radius and regional availability and pricing (RAAP) of a region overlap, LIA will typically take precedence over RAAP for ads.

Requirements to participate in regional availability and pricing

To participate in regional availability and pricing, you'll need to complete the following onboarding steps:

Note: For privacy reasons, you may not use the region ID to re-identify any user. You're also responsible for complying with all applicable local laws and regulations related to regional pricing.

Compatibilities

Regional availability & pricing works with all feed-powered campaigns (Performance Max campaigns, Shopping campaigns, Video Action campaigns [allowlist, US only]) and feed-powered ads formats (Shopping ads, Free Product listings, Display ads, YouTube affiliate Shopping), as well as merchant center add-ons and attributes such as promotions and sale_price.

Note: Display Ads are supported at the regional level in the US, and national level in the rest of the world

Regional availability and pricing only supports the values in_stock and out_of_stock for the availability [availability] attribute (the values preorder and backorder aren't supported).

In addition, automatic item updates can be turned on for national availability only.


Set up regions

What are Regions?

If the country you sell your products in is eligible for regional availability and pricing, you’ll be able to activate the new “Regions” add-on on the Add-on page, allowing you to specify regions for both regional inventory and/or shipping delivery zones.

A region is used to define an area in which products share the same online availability, price, or both. Depending on your business model, you may only need one set of regions for both shipping, and regional availability and pricing, or you can create multiple sets of regions and use them for either service.

Note: Regional availability and pricing isn’t the same as regional shipping and may not be available in the same set of countries. Learn more about shipping settings.

A region is defined by:

  • A geographic area defined by a set of postal codes or states/provinces.
  • A region ID uniquely identifying each region. It’s used to indicate the region in the regional inventory feed.

Regions are configured at the individual account level, which can be done either through the “Regions” page in Merchant Center or through Content API.The MCA level is not yet supported.

Set up regions by defining either postal code or state/province-based areas on the "Regions" tab in the “Business info” page of your Merchant Center account.

Region granularity support: All RAAP-eligible countries support state/province-based regions, and some countries also support more granular postal code-based regions as well.

Postal Code

AU, BR, CA, DE, FR, GB*, HU, IN, JP, NL, NZ, US

State/Province

AR, AT, CL, CO, CZ, DK, ES, HU, ID, IT, MX, MY, NO, PE, PH, PK, RO, RU, SE, TH, VN, ZA

Note: In Great Britain, only the "outward code" of postal codes are supported. Prefixing and wildcards are also not yet supported.

Example: For the postal code "SW1A 1AA", "SW1A" is the supported portion.

Region requirements

  • The currency used for a region must be the same as the currency used for the initial product offer.
  • Regions need to meet minimum geographic size and population requirements. They must cover an area of 3 sq km, and be expanded until the area represents the locations of at least 1,000 people.
Note: Your region eligibility may change over time as it's subject to population changes. You can monitor your eligibility in the "Regions" menu.
  • Regions should ideally be geographically contiguous. Each contiguous area within a region is individually subject to the size and population limits mentioned in the bullet point above. Avoid adding unattached small areas to a region. A small area can be extended by clustering it with surrounding postal codes to make it larger. If the region doesn’t meet these size requirements, an error message will be shown in the “Issue” column on the "Regions" page.
  • Region ID requirements:
    • Can be postal code
    • Can be alphanumeric
    • Can’t have symbols other than "_"
    • Length limit: between 1 and 100 characters
    • Lower case only

Best practices

  • Avoid including an area (such as a postal code, state, or oblast) in more than one region. If 2 regions overlap, and they have conflicting regional price/availability, one region and its corresponding price/availability will be selected at serving time.
  • You don’t need to set up regions for the entire country; you only need to cover the areas which require a regional override for an offer.
  • If you have a physical warehouse or hub of delivery, we recommend basing your regions around these locations.
  • If you set your region ID to be a postal code that exists within the region, or to a store ID already used internally by your site, it may make the landing page integration easier.

Example Configurations

For offers that do not have regional overrides, continue to manage national price and availability (in_stock or out_of_stock) in the primary feed as you normally would.


Instructions to set up regions


Instructions to set up regional inventory


Set up landing page

The price and availability on your landing page must match the regional price/availability shown on Google surfaces from your regional feed. To ensure an accurate landing page experience, Google appends the region ID corresponding to the location of the shopper as a parameter to the clickthrough URL. You must adjust your landing pages so that they can accept this parameter and render a product landing page that shows the corresponding price and availability.

Note that the URL should be updated in the primary data source. If it's added to the regional feed, it could result in products not showing up.

Example

Value provided in the link attribute: https://mystorewebsite.com/p/myproductlandingpage

Final URL: https://mystorewebsite.com/p/myproductlandingpage?region_id=123456

Value provided in the link attribute: https://mystorewebsite.com/p?offer=myproduct

Final URL: https://mystorewebsite.com/p?offer=myproduct&region_id=123456

Note: Offers’ national price and availability will still be crawled and verified using the product page URL without a region ID. The values shown on your landing page for those national URLs must match the national price and availability of the offer. If your prices are purely regional, please set a realistic national offer price which reflects what your landing page shows when using the national URL.

Best practices

If your region IDs are postal codes or existing internal store IDs and your landing page already has a location/store picker, you may be able to simplify your landing page integration by passing the region ID directly into the existing picker logic to update the price and availability.

  1. Recommend that you follow the best practices for landing pages.
  2. To prevent crawling issues, check schema.org markup.
  3. You can use the Rich Results Tool to test your landing pages.

Troubleshooting

Review regions and fix issues

In order to use the regions feature, each of your regions must meet the minimum requirements. If you don’t meet these requirements, you’ll notice an error message, with details in the “Issue” column on the “Regions” page. You can filter your regions by issue, or manually address them one by one. When you satisfy the necessary requirements, the error messages will disappear.

Price and availability mismatch

A common cause for incorrect price or availability is the time difference between updates on your website and updates of your product data in Merchant Center. We recommend that you schedule feed uploads or updates via the Content API immediately after the products have been updated on your website. If the price or availability status of your products changes very frequently, we recommend that you upload the feed more often or consider using the Content API which allows you to update individual products.

In order to stay compliant, we recommend following these help center articles:

To access the list of current issues:

  1. In your Merchant Center account, Select Products from the left navigation panel.
  2. Navigate to the need attention tab, where you can view the list of current issues.

Try our guided feed setup troubleshooter for help fixing issues with creating, formatting or uploading your feed (for text, tab-delimited or XML file feeds only).

Try our guided price issues troubleshooter for help fixing warnings or disapprovals related to price.

Unsupported destination based on regional settings

This is an item-level warning that indicates you are targeting some serving destinations that aren’t supported for regional offers. Your offers will still continue to serve everywhere regional offers are supported.

Frequently asked questions

Was this helpful?

How can we improve it?
5728173273396036517
true
Search Help Center
true
true
true
true
true
71525
Search
Clear search
Close search
Main menu
false
false
false
false