The
FieldName value will vary based on the recommendation type. The
FieldName values for each recommendation type are summarized below:
For
eTRS listing recommendations, the
FieldName value will indicate the specific Trading API field that the seller needs to update to bring the listing up to top-rated listing standards. For example, if the
Recommendation.Type value is 'eTRS' and the
Recommendation.Group value is 'SHIPPING', the
FieldName value may be 'DispatchTimeMax'. If the seller is returned a listing recommendation like this, it would most likely indicate that the seller must reduce the handling time (
DispatchTimeMax value) in the listing to '0' (same-day shipping) or '1' (one-day handling time) in order for the listing to qualify as a top-rated listing and receive a Top Rated Plus seal in View Item and Search Results pages.
For an
ItemSpecifics listing recommendation, the
FieldName value will be the name of the recommended Item Specific. If the seller gets a
ItemSpecifics listing recommendation, the seller will perform a
ReviseItem/
ReviseFixedPriceItem call, passing in the recommended Item Specific (with one or more values) through the
ItemSpecifics.NameValueList container. If available, eBay will also return recommended Item Specific value(s) through the
Recommendation.Value field.
For a
Picture listing recommendation, the
FieldName value will be the URL of the image that needs to be brought up to picture quality standards. If the seller gets a
Picture listing recommendation for this image in the listing, the seller will need to make the required picture quality update, and then perform a
ReviseItem/
ReviseFixedPriceItem call, passing in the URL of the image through the
PictureURL field in the
PictureDetails container.
If the seller gets a
Picture listing recommendation for this image in the listing, the seller will need to make the required picture quality update, and then perform a
ReviseItem/
ReviseFixedPriceItem call, passing in the URL of the image through the
PictureURL field in the
PictureDetails container.
For a
Price listing recommendation, the
FieldName value will be one of the following:
- BuyItNowPrice: the recommended price for an item in a fixed-price listing or for the "Buy It Now" price in an auction listing; this value will be shown in the Recommendation.Value field. Upon getting a BuyItNowPrice recommendation, the seller may consider revising their listing with a price matching or closer to the recommended price.
- ListingType: this value is returned if a different listing type (auction vs. fixed-price) is being suggested for the item. Upon getting a ListingType recommendation, the seller may consider the recommended listing type the next time they list a similar item.
- StartPrice: the recommended starting bid price for an item in an auction listing; this value will be shown in the Recommendation.Value field. Upon getting a StartPrice recommendation, the seller may consider the recommended starting bid price the next time they list a similar item.
Two other pricing recommendations,
BuyItNowPriceRange and
StartPriceRange, are supported in the Listing Recommendation API, but are not yet supported by the Trading API.
For a
Title listing recommendation, the
FieldName value will be 'Title' for any of the three use cases - missing keywords, missing Item Specifics, or inaccurate keywords. Upon getting a
Title recommendation, the seller may consider the
Title recommendation (adding keywords, adding Item Specifics, removing inaccurate keywords) the next time they list a similar item.
For an
FnF listing recommendation, either one or two
recommendation containers will be returned, based on whether a listing needs fast handling (same-day handling or handling time of 1 day), at least one free shipping service, or both. These two
fieldName values are described below:
- shipsWithinDays: this fieldName value is returned if the seller needs to implement fast handling (same-day handling or a handling time of 1 day). To implement fast handling, the seller will perform a ReviseItem/ReviseFixedPriceItem call, passing a value of '0' or '1' into the DispatchTimeMax field.
- shippingServiceCost: this fieldName value is returned if the seller needs to offer a free shipping service option in the listing. To add a free shipping service option, the seller will perform a ReviseItem/ReviseFixedPriceItem call, passing in one or more ShippingDetails.ShippingServiceOptions containers where the shipping service is free (ShippingServiceOptions.FreeShipping boolean value set to 'true').
This
FieldName field is always returned with each
Recommendation container.