Set up regional member pricing (in beta)

If the member price you offer changes based on the shopper's regions, you can showcase regional pricing on your Google listings by providing member price overrides in the regional inventory feed. This article shows you how to set up regional member pricing for your products. The implementation includes onboarding to a loyalty program, setting up regions, correctly structuring your regional inventory feed attributes, and updating your landing pages.

Note: Regional member pricing is eligible to show in Shopping ads and free listings format for countries where both regional availability and pricing (RAAP) and the loyalty program are supported. This feature is currently in beta so consumer visibility can be limited.

On this page


How to set up regional member pricing

Step 1 of 4: Onboard to a loyalty program

First, activate the loyalty add-on, then add your loyalty program information in Merchant Center. Learn more about setting up loyalty program in your account.

After you set up and get approval for your loyalty program, you can use the data provided in the loyalty program to add the relevant attributes to your regional inventory feed.

Step 2 of 4: Set up regions

If you’ve already set up regions in Merchant Center, carefully review them to make sure that the member pricing follows the same region setup. Learn more about setting up regions.

Step 3 of 4: Add loyalty program [loyalty_program] attributes to your regional inventory feed

The regional inventory feed provides region-specific information for your products. Follow the steps to set up your regional inventory to add in required attributes.

To implement regional member pricing, you need to include loyalty program [loyalty_program] group attributes in your regional inventory feed. Supported sub-attributes include:

  • Program label [program_label] : This is the loyalty program label set in your loyalty program settings in Merchant Center. This sub-attribute allows Google to map your loyalty program to eligible offers.
  • Tier label [tier_label]: This sub-attribute differentiates offer level benefits between each tier. This value is also set in your program settings in the Merchant Center.
  • Price [price]: This sub-attribute allows you to add member-specific pricing to your feed. This will display alongside the non-member price to give shoppers an idea of the benefits of joining your program.
  • Member price effective date [member_price_effective_date] (optional): This sub-attribute allows you to specify when their member pricing benefit begins and ends. Find details about formatting the member price effective date [member_price_effective_date] sub-attribute.

Format the attribute header by always including the sub-attributes you’re submitting. Include loyalty program [loyalty_program], and then, in parentheses, add the names of the sub-attributes that you want to submit separated by a colon ( : ).

Single-tier loyalty program

If your loyalty program only has one tier, you can choose to provide only the price-related attributes. There's no need to include your program label [program_label] and tier label [tier_label] in the feed.
Example: Member price is evergreen
id region_id Price Availability loyalty_program(price)
1234567 san_jose 100.00 USD In stock 80.00 USD

Example: Member price is only for a specific period of time

id region_id Price Availability loyalty_program(price:member_price_effective_date
1234567 san_jose 100.00 USD In stock 80.00 USD:2025-05-11T00\:01\:59-0800/2025-06-21T22\:13\:59-0800

If you also include the program label [program_label] and tier label [tier_label] in the header, this is also supported.

Example:

id region_id Price Availability loyalty_program(program_label:tier_label:price:member_price_effective_date)
1234567 san_jose 100.00 USD In stock my_loyalty_program:silver:80.00 USD:2025-05-11T00\:01\:59-0800/2025-06-21T22\:13\:59-0800

Multi-tier loyalty program

If your loyalty program contains multiple tiers, specify the program label [program_label] and tier label [tier_label] in the feed to identify member pricing for each tier. The labels provided in your feed must match what’s provided in your loyalty program setting in Merchant Center.
Note: CSV is not a supported format. TSV file is supported.
Example: Member price is evergreen
id region_id Price Availability loyalty_program(program_label:tier_label:price)
1234567 san_jose 100.00 USD In stock my_loyalty_program:silver:80.00 USD,my_loyalty_program:gold:75.00 USD

Example: Member price is only for a specific period of time

id region_id Price Availability loyalty_program(program_label:tier_label:price:member_price_effective_date)
1234567 san_jose 100.00 USD In stock my_loyalty_program:silver:80.00 USD:2025-05-11T00\:01\:59-0800/2025-06-21T22\:13\:59-0800,my_loyalty_program:gold:75.00 USD:2025-05-11T00\:01\:59-0800/2025-06-21T22\:13\:59-0800

Example: Member price is only for a specific period of time for one tier and evergreen for another tier

id region_id Price Availability loyalty_program(program_label:tier_label:price:member_price_effective_date)
1234567 san_jose 100.00 USD In stock my_loyalty_program:silver:80.00 USD:2025-05-11T00\:01\:59-0800/2025-06-21T22\:13\:59-0800,my_loyalty_program:gold:75.00 USD:
Note: Ensure that the program label [program_label] and tier label [tier_label] sub-attributes of the loyalty program [loyalty_program] attribute match one of the program labels and tier labels configured under your Merchant Center account.

Step 4 of 4: Update your landing pages

The member price on your landing page must match the regional member price in 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. Adjust your landing pages so that Google can accept this parameter and render a product landing page that shows the corresponding price and availability. Learn more about setting up landing page.


Minimum requirements

Regional member pricing follows the same requirements for national member pricing. Learn more about the minimum requirements of the loyalty program [loyalty_program] attribute.


Best practices

These best practices can help you go beyond the basic requirements to optimize your regional member pricing (in beta) for performance.

  • In a single-tier loyalty program, you can choose to only provide the price [price] and member price effective date [member_price_effective_date] (if applicable) sub-attributes within loyalty program [loyalty_program]. This will make the implementation easier and more straightforward.
  • In a multi-tier loyalty program, the program label [program_label] and tier label [tier_label] sub-attributes are required to indicate the benefits associated with each tier.
  • Submit exact values for member pricing. For example, submit “1.01 USD” instead of “1.0012 USD”, otherwise we’ll round the submitted value.

Related links

Was this helpful?

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