Integrating a product listing page
Use the Sitecore Discover Search and Recommendation API to integrate a product listing page with your website.
Before you call the Search and Recommendation API to request product listing page (PLP) data, identify the page on your website where you want the PLP to appear. You can integrate a PLP with an existing page on your website or create a new page for the PLP. On the page, create UI components to hold PLP data.
Next, create a PLP on the Customer Engagement Console (CEC). While you can choose the widgets you want on the PLP, you must select at least one PLP widget. Other common widgets you can include are SEO widgets. Make sure that you publish all widgets before integrating.
You must set up the PLP correctly in the CEC and use the correct URI when you create a request. You get an error if Discover cannot understand the URI.
Now, you are ready to call the Discover Search and Recommendation API to request PLP data and then identify the response parts that you want to feed into your website's UI components.
The process of integrating a product listing page (PLP) is similar to integrating a search page widget. The main difference is that page URI drives the former request while the user's keyphrase drives the latter request.
Best practices
The following are best practices for creating requests to integrate a PLP:
-
Do not choose which facets you want to display when you create an API request. Use all facets that appear in the response. If you want only certain facets to appear, edit facets in the CEC before you integrate.
-
When you create a request to call the second (or later) page make sure that everything except the page number is identical to the first page's request. This ensures that the PLP looks consistent.
-
For the best latency performance, do not exceed an
n_itemof 24. Any value higher than 24 slows down the API response time.