Skip to main content

This topic describes how to understand the information returned from a call to getCustomerServiceMetric.

Getting customer service metric ratings

You can configure getCustomerServiceMetric to return one of four different customer service metric ratings.

A request can return either the CURRENT or PROJECTED seller rating for either the Item Not As Described or Item Not Received customer service metric.

Configure a combination of these two sets of query parameters in your call's request to get the benchmark data and metric rating of your choosing.

Important! Sellers are eligible to be rated only if they have sold an item in the last 12 months. In addition, they can receive a CURRENT rating only if they sold an item during the last lookback period.

Calculating customer service metric ratings

Customer service metric ratings are based on how a seller performs over a set period of time compared to the benchmark that is set over that same period of time.

Note: The benchmark data, seller data, and seller ratings returned by getCustomerServiceMetric are all based on the parameters established in the returned evaluationCycle container and the metric data is confined by the values returned in the dimensionMetrics.dimension container.

To simplify descriptions, these constraints are assumed and are omitted in the following discussions.

Benchmark data and seller ratings

Each customer service metric rating is based on how the seller compares to the benchmark data collected for that same metric over the same period of time.

Sellers are rated on a scale and benchmark.rating returns a value from LOW to VERY_HIGH, depending on the deviance of the seller's customer service metric value to the benchmark average. Here, a LOW deviance is best and a VERY_HIGH rating reflects poorly on the seller.

Currently, only the PEER_BENCHMARK is considered, where the seller is evaluated against benchmark data collected on their peer sellers. Peer sellers is the group of sellers that offers similar products under similar selling circumstances (including selling prices, and terms of sale and shipping destination).

The benchmark average rating is set to the average value of the collected benchmark data for the metric. The seller's rating is determined by comparing the seller's performance value to the average value of the collected benchmark data.

The following example displays the response data for a LOW customer service metric rating:

  {
    "metricKey": "RATE",
    "value": "0.47",
    "benchmark": {
      "basis": "PEER_BENCHMARK",
      "rating": "LOW",
      "metadata": {
        "average": "0.48"
      }
    }
  },

Note that if the value of the metrics.value field falls below a certain threshold, the benchmark.rating field returns NOT_APPLICABLE, meaning the seller did not have enough transactions for eBay to calculate a customer service metric rating.

Lookback periods

The period over which a seller (and the associated benchmark data) is evaluated is known as the "lookback period."

A lookback period can either be 3 months or 12 months, depending on transaction volume of the seller.

Lookback periods always start on the first day of a month (specifically at midnight, Mountain Standard Time) and they always end on the last day of a month at (11:59.59 PM, also MST).

Seller data for the lookback period is evaluated on the 20th of the month following the conclusion of the lookback period, at midnight, Mountain Standard Time. Note that the CURRENT seller rating is not updated until the evaluation occurs for the lookback period.

For example, suppose a seller has enough volume to be rated on a three-month lookback period, and they review their CURRENT customer service metric rating on October 21st:

  1. The evaluation would have occurred the previous day (October 20th)
  2. Their three-month lookback period would have started on July 1st (at midnight, MST) and would have ended on September 31st (a 11:59.59 PM, MST).

The response, time stamps returned in the evaluationCycle container are formatted as ISO 8601 strings based on the 24-hour Coordinated Universal Time (UTC) clock. Coordinated Universal Time (UTC) is 7 hours ahead of Mountain Standard Time (MST), which is reflected in the timestamps returned.

For example:

  "evaluationCycle": {
    "evaluationType": "CURRENT",
	"evaluationDate": "2019-10-21T19:13:00.000Z",
	"startDate": "2019-07-01T07:00:00.000Z",
	"endDate": "2019-10-01T06:59:59.000Z"
  },

Current versus projected ratings

Sellers can request either a CURRENT or PROJECTED customer service metric rating.

The current seller rating is the rating that was established for the last lookback period evaluated. With normal seller activity, a new CURRENT customer service metric rating is established each month on the 20th.

The projected seller rating is a daily evaluation that provides a running projection of how the seller is performing within the lookback period currently being evaluated. In other words, this is a non-certified metric rating for how the seller is doing since their last evaluation.

Metric keys

In the response, each set of customer service metrics is divided into three metric keys:

  • RATE – When metricKey is set to RATE, the fields in the associated container return the seller's calculated value for the associated customer service metric along with the benchmark data against which the seller is evaluated. The benchmark.rating value is the seller's rating for the metric in the associated dimension and evaluationCycle.
  • COUNT – When metricKey is set to COUNT, the associated value field returns the number of transactions completed by the seller for the metric being evaluated in the associated dimension and evaluationCycle.
  • TRANSACTION_COUNT – When metricKey is set to TRANSACTION_COUNT, the associated value field returns the number of transactions completed in the peer group for the metric being evaluated in the associated dimension and evaluationCycle.

Customer service metric types

Sellers can retrieve their customer service metric rating for two different metrics. The metrics are defined by the following transaction types:

  • ITEM_NOT_AS_DESCRIBED (abbreviated as INAD)
  • ITEM_NOT_RECEIVED (abbreviated as INR)

Set the metric rating you want returned using a query parameter in your call to getCustomerServiceMetric.

Item Not Received metric ratings

The following response shows the seller's customer service metric rating from an INR query.

When evaluating INR customer service metrics, the demsionKey is always set to SHIPPING_REGION. This means the seller metrics are evaluated on the shipping regions into which they ship.

The service identifies three shipping regions (Domestic, International: Emerging region, and International: Mature region) and the response indicates the number of INR transactions logged for each. For details on the categorization of shipping regions, see the FAQ section on the following page: Monitor your service metrics.

{
    "evaluationCycle": {
        "evaluationType": "CURRENT",
        "evaluationDate": "2019-10-21T19:13:00.000Z",
        "startDate": "2019-07-01T07:00:00.000Z",
        "endDate": "2019-10-01T06:59:59.000Z"
    },
    "marketplaceId": "EBAY_GB",
    "dimensionMetrics": [
        {
            "dimension": {
                "dimensionKey": "SHIPPING_REGION",
                "value": "DOMESTIC",
                "name": "Domestic"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "0.78",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "AVERAGE",
                        "metadata": {
                            "average": "0.44"
                        }
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "8857"
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "1134149"
                }
            ]
        },
        {
            "dimension": {
                "dimensionKey": "SHIPPING_REGION",
                "value": "INTERNATIONAL_EMERGING_REGION",
                "name": "International: Emerging region"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "1.02",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "AVERAGE",
                        "metadata": {
                            "average": "1.64"
                        }
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "122"
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "11954"
                }
            ]
        },
        {
            "dimension": {
                "dimensionKey": "SHIPPING_REGION",
                "value": "INTERNATIONAL_MATURED_REGION",
                "name": "International: Matured region"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "0.17",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "AVERAGE",
                        "metadata": {
                            "average": "0.59"
                        }
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "116"
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "69534"
                }
            ]
        }
    ]
}
Item Not As Described metric ratings

The following response shows the seller's customer service metric rating from an INAD query.

When evaluating INAD customer service metrics, the demsionKey is always set to LISTING_CATEGORY. This means the seller is evaluated on the categories into which they sell.

As described above, each metrics element is divided into three sub-containers, where each identified by a separate metricKey value (RATE, COUNT, and TRANSACTION_COUNT).

When metricKey equals COUNT in an INAD response, the metrics container includes a distributions container that lists the different reasons buyers indicated their received items were "not as described," and the associated value field contains the sum of seller transactions for each listed reason.

{    "evaluationCycle": {
        "evaluationType": "PROJECTED",
        "evaluationDate": "2019-10-30T03:22:13.000Z",
        "startDate": "2019-08-01T07:00:00.000Z",
        "endDate": "2019-11-01T06:59:59.000Z"
    },
    "marketplaceId": "EBAY_GB",
    "dimensionMetrics": [
        {
            "dimension": {
                "dimensionKey": "LISTING_CATEGORY",
                "value": "267",
                "name": "Books, Comics & Magazines"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "0.53",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "LOW",
                        "metadata": {
                            "average": "0.53"
                        }
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "4612",
                    "distributions": [
                        {
                            "basis": "ITEM_NOT_AS_DESCRIBED_REASON",
                            "data": [
                                {
                                    "name": "MISSING_PARTS",
                                    "value": "353"
                                },
                                {
                                    "name": "ORDERED_DIFFERENT_ITEM",
                                    "value": "265"
                                },
                                {
                                    "name": "ARRIVED_DAMAGED",
                                    "value": "824"
                                },
                                {
                                    "name": "NOT_AS_DESCRIBED",
                                    "value": "2463"
                                },
                                {
                                    "name": "DEFECTIVE_ITEM",
                                    "value": "687"
                                },
                                {
                                    "name": "FAKE_OR_COUNTERFEIT",
                                    "value": "20"
                                }
                            ]
                        }
                    ]
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "870197"
                }
            ]
        },
        {
            "dimension": {
                "dimensionKey": "LISTING_CATEGORY",
                "value": "11232",
                "name": "DVDs, Films & TV"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "0.47",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "LOW",
                        "metadata": {
                            "average": "0.48"
                        }
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "821",
                    "distributions": [
                        {
                            "basis": "ITEM_NOT_AS_DESCRIBED_REASON",
                            "data": [
                                {
                                    "name": "MISSING_PARTS",
                                    "value": "117"
                                },
                                {
                                    "name": "ORDERED_DIFFERENT_ITEM",
                                    "value": "94"
                                },
                                {
                                    "name": "ARRIVED_DAMAGED",
                                    "value": "120"
                                },
                                {
                                    "name": "NOT_AS_DESCRIBED",
                                    "value": "195"
                                },
                                {
                                    "name": "DEFECTIVE_ITEM",
                                    "value": "286"
                                },
                                {
                                    "name": "FAKE_OR_COUNTERFEIT",
                                    "value": "9"
                                }
                            ]
                        }
                    ]
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "175911"
                }
            ]
        },
        {
            "dimension": {
                "dimensionKey": "LISTING_CATEGORY",
                "value": "11233",
                "name": "Music"
            },
            "metrics": [
                {
                    "metricKey": "RATE",
                    "value": "0.6",
                    "benchmark": {
                        "basis": "PEER_BENCHMARK",
                        "rating": "NOT_APPLICABLE"
                    }
                },
                {
                    "metricKey": "COUNT",
                    "value": "906",
                    "distributions": [
                        {
                            "basis": "ITEM_NOT_AS_DESCRIBED_REASON",
                            "data": [
                                {
                                    "name": "MISSING_PARTS",
                                    "value": "102"
                                },
                                {
                                    "name": "ORDERED_DIFFERENT_ITEM",
                                    "value": "147"
                                },
                                {
                                    "name": "ARRIVED_DAMAGED",
                                    "value": "135"
                                },
                                {
                                    "name": "NOT_AS_DESCRIBED",
                                    "value": "237"
                                },
                                {
                                    "name": "DEFECTIVE_ITEM",
                                    "value": "273"
                                },
                                {
                                    "name": "FAKE_OR_COUNTERFEIT",
                                    "value": "12"
                                }
                            ]
                        }
                    ]
                },
                {
                    "metricKey": "TRANSACTION_COUNT",
                    "value": "151797"
                }
            ]
        }
    ]
}