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.
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 approximately500points 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 daygoing 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.
| 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 |
| 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 |
| 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 |
| 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: