GVR Eligibility

This support article is under construction 👷

Please pardon the incompleteness while we work on this. We have made the article visible in the meantime because the content may be useful.

This is a work in progress, the list below is from the BETA GitHub. Let's all add to it and edit as we push the limits of the public GVR eligibility.

Checking for Eligibility (updated from GH wiki 06/01/24 ACH)

GitHub Wiki

Translating OwnerRez settings {surcharges, discounts, rates, inventory, availability, taxes} to the appropriate Google ARI XML messages needs to be accurate for Google to reconstruct a feed price during an available open time from the constituent XML messages to combine the rates, discounts, taxes, etc. to create Feed price {secret protected by Google and not available to us to check}) within +/- 2%. If the price that the XML messages combine under the rules Google uses does not match (determined by a human price checker), then a price accuracy miss occurs. Price accuracy hits are bad and if enough accumulate (enough being dependent on the previous rating, but could be between 3 - 10 misses) the entire integration offered by OwnerRez will be delisted thereby kicking everyone off of the Google Vacation Rentals platform.

Major points to consider here

  • This is different than other integrations in that the failure of listing clients is a collective penalty and is placed under the responsibility of OwnerRez to maintain at all times
  • There is no room or margin for error. A single mistake applied across 10 properties could possibly cause OwnerRez to get delisted. Penalties accumulate and remain for 90 days and successful price matches are weighted at a smaller value than a penalty. Observations is that a penalty is at least 1 order of magnitude higher in points than a success.

Example the base amount of points for successful price match is 5 points, then a price miss is equal to 50 points.

  • Suppose a price check of 5 properties is done with 2 matches and 3 misses that is a cumulative penalty to your rating of (5 * 2) - (50 * 3) = -140 points, and with a max points available of approximately 500 points you realize quickly that 2 - 3 days of this occurring means delisting of all properties.
  • This also means that fixing an issue means future price checks say they do 5 per day going forward it means you will need 6 days of successful checks to make up for that 1 day of 3 price misses. Google does not perform a consistent amount of price checks per day or perform them everyday (weekends are absent most times, and other days during the week are skipped as well from time to time), that means it will most likely take 2 weeks to recover from 1 infraction day.

This means that when a client and their properties are added we should know that the ARI XML messages we send to Google will match to the direct channel rate on their own website/widget. Prior to a channel being created the Direct Rate Tester of their My Website is a valid approximation to enforce strictness of calculation of a possible stay on dates.

A note on the Google system is that we have to precalculate taxes on fees as Google does not support this and it is where the majority of issues come into effect currently because we do not have insight into how they apply these set amounts and they do not have any guarantees on order or awareness of how things work as well when questioned other than to repeat the documentation back to us.

Will be removed soon

Status Type Severity Reason
Per Night & Increment or Per Increment Tax NO Need to support basis+person, changes coming
No Credit Card payment method configured for this property NO Safest option for showing immediate price accuracy, changes coming

Change from warning to information?

Status Type Severity Reason
No hosted site OK Warning that you are automatically using Global Landing Page
Multiple hosted sites OK A property could be listed on all the hosted sites, which is allowed if confusing

Current Client Configuration Options that should disqualify from eligibility

Status Type Severity Reason
Missing Lat/Lng NO Required to list
Fee that is based on guest count that is a flat amount NO Google Taxes and Fees are not expressive enough to translate to a threshold flat fee that starts at a guest count i.e. 6 or more guests means add $100 fee
Position on Discount or Fee NO Discounts and fees can not have a position defined
Day of Month for Surcharge/Discount NO Not supported by current code
Place this below tax line items NO This type of ordering is not supported by Google
Percentage fees that are non taxable and larger than 5% NO Causes price shifting out of acceptable price check range
Not a Google eligible fee NO Valid are per night or per stay or Increment is guest, adult, or child and is set to per night and per increment
Non taxable administrative percent fees WARNING In this case if it combines with other percent fees it could cause a shift in the amount
Missing Address WARNING Will be required according to Google soon

Are not part of Listing Quality Analyzer, but have caused price accuracy issues before

Status Type Severity Reason
Blocked out time that is greater than 30 days WARNING Should be ok, but is not normal Google operation
Overlapping Seasons WARNING Seasons are often combined with discounts and an unintentional double discount will cause a price miss
Extra per guest fee OK Works, but Google only does 2 person prices currently, have to check this fee appears in Extra Guest XML file

 

Related tickets:

236976 multi-property listing loosely based on a hotel model- how do we locate and remove these if they would cause a price miss?

 

Forum question: