Third-Party Search Tools

Splainer

Splainer is an open-source, third-party tool from OpenSource Connections. It has been integrated with the Kibo Composable Commerce Platform in order to provide insight into search relevancy and results.

  1. To access, click the Splainer.io button. A unique URL is generated with parameters from the search configuration.
    Search settings page with an arrow pointing to the Splainer.io button
  2. Clicking the button will open Splainer with those parameters in a new browser tab. Since this is generated from a configuration, no search term is populated. To enter and see the results of a specific term, click Tweak in the top right of the screen.
    Splainer initial results page with an arrow pointing to the Tweak button
  3. Enter the desired search term after query= and then click Rerun Query.
    Splainer screenshot with a box showing where to enter the search term and an arrow pointing to the Rerun Query button
  4. The results on the left will refresh based on the search term. Click Details to see an explanation of what makes the relevancy score.
    Splainer results with an arrow pointing to the Detailed link
  5. Within the Detailed modal, click Full Explain to see what exactly causes an item to have a particular relevancy score.
    Splainer detailed modal with an arrow pointing to the Full Explain link
  6. This list can be expanded to see as many or as few details as needed.
    Splainer Full Explain results with arrows pointing to the expand buttons

More information about using Splainer can be found by clicking Take a Tour at the top of the Splainer UI.

Quepid

Quepid is an open-source, third-party application from OpenSource Connections. It has been integrated with KCCP in order to help merchandisers and search relevancy engineers view search results without changing settings and checking results on a live retail site. Quepid provides visibility into how changes affect the site globally, while Splainer provides deeper details about individual relevancy scores.

You must create a free account with Quepid in order to use it.

  1. Visit the Quepid application.
  2. Copy the URL generated when clicking the Splainer.io button.
    Splainer screen with the generated URL higlighted
  3. On the initial screen, choose SOLR, insert the copied URL, and click Continue.
    Quepid introductory screen with arrows pointing to the search type toggle, the URL entry, and the Continue button
  4. Enter the fields to display. The list of available options for each field is generated by your uploaded catalog schema.
    Quepid results display options
  5. Add one or more search terms, then click Continue.
    Quepid search queries
  6. Click Finish to close the modal and view the results.
    Quepid final setup screen
  7. By default, the results will contain all products instead of those specific to your search terms. To adjust the accuracy of the results by restricting them to your search terms, click Tune Relevance and then change q=#$query## to query=#$query##Callout for the Tune Relevance link in the page headerThe Query Sandbox options with a callout for the query
  8. Then, you can further expand a query by clicking the down arrow on the results page.
    Quepid results screen with an arrow pointing to an expand drop-down arrow
  9. For each result, click the drop-down option to the left and select a relevance score. In this example for the search term pants, the deck bag has been scored as Irrelevant, while the cargo crop pants have been scored as Relevant.
    Quepid results screen with an arrow pointing to the relevance score of the last item
  10. As each item is scored, the overall score for the query is automatically adjusted. This provides the ability to see if various search configuration changes improve search results or not.

More information about using Quepid may be found on the Quepid Knowledge Base.