lease, read this presentation first if you need a general view on categories in KelkooGroup.
With over one hundred million offers globally to choose from, it can be difficult to know what to promote. That's why we're introducing Top Offers.
What are Top Offers?
Top Offers is our way of determining which offers are most likely to convert. Using machine learning and click and sales data from across our entire network, we have tiered the offers we serve. The tier of offers that consistently outperform the others are called Top Offers.
As a reminder, an offer is a product from a specific merchant at a particular price (more info can be found in our Glossary).
How do I get Top Offers?
Top Offers can be retrieved using the Kelkoo Shopping API on both /search/offers and /feeds/offers endpoints.
/search/offers
Use the parameter topOffers in your API query to return Top Offers.
Shopping API Search Query
https://api.kelkoogroup.net/publisher/shopping/v2/search/offers?country=uk&fieldsAlias=minimal&topOffers=10
This query will return the top 10 offers in the UK. The topOffer parameter accepts values from 1 to 500.
Note that the topOffer parameter should not be used in conjunction with sorting or pagination. Use of a keyword query may yield unrelated results.
/feeds/offers
Use the parameter topOffers in your API query to return Top Offers.
Shopping API Feeds Query
https://api.kelkoogroup.net/publisher/shopping/v2/feeds/offers?country=uk&format=json&fieldsAlias=minimal&topOffers=10
This query will return the top 10 offers in the UK. Unlike the /search/offers endpoint, the /feeds/offers endpoint does not force an upper limit on the topOffer parameter and will accept values of 1 or higher.
Getting more granular
The above examples will provide you with the top 10 Top Offers in the UK - but that's pretty generic. It's also possible to use the topOffers parameter in conjunction with other parameters to get more granular results. For example, adding merchantId and/or categoryId to your query can help you drill down on performant offers in areas that you're looking to promote.
Shopping API Search Query
https://api.kelkoogroup.net/publisher/shopping/v2/search/offers?country=uk&categoryId=[categoryId]merchantId=[merchantId]&fieldsAlias=minimal&topOffers=10
What is Performance Score?
You may notice that when you use the topOffers parameter in your queries, the performanceScore value will be returned against the offer.
Performance Score is a numerical value allows you to see the ranking of the Top Offers. A higher Performance Score means an offer performs better than an offer with a lower Performance Score. The default output from our endpoints is always sorted from highest Performance Score to lowest Performance Score. This value may be useful to you if you are trying to decide which Top Offer to promote.
You can find more information on the offer model in our technical documentation.
Why should I care about Top Offers?
Many of Kelkoo's merchants will pay out based on performance of the traffic they receive. The better your performance, the more you are likely to earn. Top Offers gives you a critical insight what's performing well across the entire Kelkoo Group network - and that's key to improving your yield.