Categories You May Like

Suggesting categories that the user might be interested in is a highly effective engagement strategy to help your site visitors find exactly what they're looking for. Even better if you can highlight personally relevant products within each category that you recommend. Fortunately, with this recipe you can do both.

Example for Categories You May Like

Introduction

Most online marketplaces have different categories of products that they want to promote to help people find what they're looking for right away. Category recommendations usually appear in a ribbon on the homepage, often with a call to action like "Shop Collections." You can use Miso to dynamically generate the list of categories that is most likely to interest the individual user, and in the order that they are likely to click.


With Miso, you can generate Categories You May Like recommendations using the User to Categories API. You'll get back a list of the recommended categories for any given user, as well as the top-recommended items within each group for that user. Additional input parameters can be used to tune these recommendations, for example to increase the diversity or boost certain results to the top.

If you'd also like to generate a personalized page that the user will be taken to when they click on a recommended category, check out the Category Pages recipe . It's a great complement to Categories You May Like.

Before You Start

API Call / JSON Response

To fetch your Categories You May Like recommendations, POST to the User to Categories API with the following minimum parameters:

  • user_id or anonymous_id: The user or anonymous visitor to personalize the recommendations for

The API will return the top categories for the user, along with the top products for their interests within each suggested category.

Don't forget: there are many parameters you can use to optimize and filter the results that Miso returns, such as fq , boost_fq , and diversification .
Read more in the deep dive

Example API Call

POST /v1/recommendation/user_to_categories?api_key=<API_KEY> HTTP/1.1
{
    "user_id": "user-123",
    "rows": 2,
    "products_per_category": 3,
    "fl": ["title"]
}

Example JSON Response

{
    "message": "success",
    "data": {
        "took": 85,
        "miso_id": "7cd6059c-dd54-11eb-8050-a62d401473b5",
        "categories": [
            {
                "category": [
                    "Air Jordan 1"
                ],
                "total": 351,
                "recommended_products": [
                    {
                        "product_id": "air-jordan-1-low-og",
                        "title": "Air Jordan 1 Low OG \\\"Chinese New Year\\\""
                    },
                    {
                        "product_id": "air-jordan-paris-saint",
                        "title": "Paris Saint Germain x Air Jordan 1"
                    },
                    ...
                ]
            },
            {
                "category": [
                    "Cozy Essential"
                ],
                "total": 221,
                "recommended_products": [
                    {
                        "product_id": "brain-dead-sweatshirt",
                        "title": "Brain Dead Logo Head Hooded Sweatshirt"
                    },
                    {
                        "product_id": "rick-owens-pants",
                        "title": "Rick Owens Wool Track Pants"
                    },
                    ...
                ]
            }
        ]
    }
}

Before You Launch

Using this API recipe as a starting point, test API calls to your engine in development
If you haven't already, build pipelines to stream your real-time data updates to Miso via API. Your Miso solutions engineer is here to help with the integration.
Start using this API recipe to power the UX on your site in staging. If you need UX recommendations, ask your Miso solutions engineer about Bento .
Run an A/B test with Miso on simulated website traffic. If desired, your Miso solutions engineer can perform this test and provide a report.
If this is your first time launching with Miso, ask your Miso solutions engineer to unlock your production environment.
Replicate your Data and Engine API calls on production and set up the same engine in your production environment in Dojo.
Review your data and engine performance in Dojo.
Turn on this recipe for a percentage of your users and scale up to a full rollout. Notify your Miso solutions engineer who will monitor the launch metrics.

API Reference

💻

Need more info on the API? Check out our dedicated API page with all the info you could ever want.

Read API Reference
Icon/Activity Icon/Add Icon/API Icon/Arrow/Down Icon/Arrow/Left Icon/Arrow/Right Icon/Arrow/TopRight Icon/Arrow/Up Icon/Bento Icon/Billing Icon/Bin Icon/Book Icon/Bookmark/Default Icon/Bookmark/Filled Icon/Calendar Icon/Caret/Down Icon/Caret/Up Icon/Chavron/DownIcon/Chavron/LeftIcon/Chavron/RightIcon/Chavron/UpIcon/Checknox/CheckedIcon/Checknox/Unchecked Icon/Checklist Icon/Chip Icon/Clipboard / Copied Icon/Clipboard/Default Icon/Clock/Stopwatch Icon/CMD Icon/Data/Catalog Icon/Data/Engine Icon/Data/Group Icon/Data/Interact Icon/Data/Users Icon/Dive Icon/Docs/Key Icon/Dojo Icon/Email Icon/Env/Development Icon/Env/Playground Icon/Env/Prod Icon/Folder Icon/Fullscreen/Collapse Icon/Fullscreen/Expand Icon/Guides/Multiple Icon/Guides/Single Icon/Hashtag Icon/Heart/Outline Icon/Heart/Solid Icon / Cart z Icon / Click Icon / Clock Icon / Data Icon / Doc Icon / EmptyCart z Icon/Social/Facebook Icon / Genome Incognito Icon / Money Icon/Social/ProductHunt Icon / Search Icon/Social/Twitter Icon / User Icon/Info/Error Icon/Info/Info Icon/Info/Question Icon/Info/Warning Icon/Interact/Download Icon/Interact/Edit Icon/Interact/External v2 Icon/Interact/External Icon/Interact/Filter Icon/Interact/Logout Icon/Interact/Options Icon/Interact/Re-order Icon/Interact/Reload Icon/Interact/Remove Icon/Interact/Replace Icon/Interact/Search Icon/Interact/Shuffle Icon/Interact/Undo Icon/Interact/Upload Icon/Interact/Video Icon/Invoice Icon/Loading Icon/Loading Icon/Lock/Locked Icon/Lock/Unlocked Icon/Lock Icon/Mapping Menu Icon/Notification Icon/Overview Icon/Person/Team Icon/Person/User Icon/Plan/Enterprise Icon/Plan/Growth Icon/Plan/Startup Icon/Plan/Trial Icon/Recipe Icon/Rocket Icon/Settings/App Icon/Settings/User Icon/Settings Icon/Shrine Icon/Sidebar/Close Icon/Sidebar/Open Icon/Slideout Icon/Sort/Ascending Icon/Sort/Default Icon/Sort/Descending Icon/Star/Filled Icon/Star/Outlined Stopwatch Icon/Support Icon/Tag Icon/Interact/Thumb/Dislike Icon/Interact/Thumb/Like Icon/Tick Icon/Trend/New Icon/Trend/Trending Icon/Tutorial Icon/Lock/Unlocked Icon/View/Grid Icon/View/List Icon/Watchlist/Add