Invalid rating

  • An invalid rating occurs when a review's minimum and maximum rating ranges are equal or when the review rating falls outside the specified minimum and maximum values.

  • To resolve an invalid rating, ensure the minimum and maximum rating ranges are not equal and that the review rating is within the specified range, inclusive of the minimum and maximum.

  • When submitting a corrected review, you must include an updated last_update_timestamp to reflect the change.

  • The example shows a situation where a review had an invalid rating of 0 when the min and max range was between 1 and 10, and how it can be corrected by changing the rating to 8 and updating the last_update_timestamp to the correct day.

Description

An invalid rating occurs when a review has the following conditions:

  • Equal min rating range and max rating range.
  • The review rating does not fall between min and max values (inclusive of the rating range).

How to fix

Deliver the review with an updated last_update_timestamp and ensure the following:

  1. Min rating range and max rating range aren't equal.
  2. The review rating is within min and max values (inclusive) of the rating range.

Example

On March 1st, you upload the feed file "2017_03_01.xml" to your endpoint. The file contains the following contents:

<review id="156368" mid="2739">
  <reviewer_name>Ada</reviewer_name>
  <create_timestamp>2017-02-27T07:55:06Z</create_timestamp>
  <last_update_timestamp>2017-02-27T07:55:06Z</last_update_timestamp>
  <country_code>US</country_code>
  <title >Great prices </title>
  <content>My order arrived on time and I got a great price.</content>
  <ratings>
  <overall min="1" max="10">0</overall>
  <customer_service min="1" max="10">10</customer_service>
  </ratings>
  <collection_method>after_fulfillment</collection_method>
</review>

The above file contains a review with a rating outside the rating range specified. After processing your feed, the support team notifies you that a data issue, invalid rating, has occurred.

A few days later, after reviewing the documentation, you upload the file "2017_03_04-fix.xml" to your endpoint to resolve the invalid rating issue. The contents of "2017_03_04-fix.xml" is below:

<review id="156368" mid="2739">
  <reviewer_name>Ada</reviewer_name>
  <create_timestamp>2017-02-27T07:55:06Z</create_timestamp>
  <last_update_timestamp>2017-03-03T08:01:20Z</last_update_timestamp>
  <country_code>US</country_code>
  <title>Great prices</title>
  <content>My order arrived on time and I got a great price.</content>
  <ratings>
    <overall min="1" max="10">8</overall>
    <customer_service min="1" max="10">10</customer_service>
  </ratings>
  <collection_method>after_fulfillment</collection_method<
</review>