Personalized Product RankingsWIP

Introduction

Within an eCommerce site or marketplace, there are many areas that can benefit from ranking based on which products are most likely to appeal to the user. For example, you may have a ribbon showing promoted products ("Top Deals") and another ribbon showing products within a merchandised category ("Spring Picks"). By personalizing both of these UX elements, you can increase engagement. It's much more likely that the user will click on the top deals for their interests or the spring selections that go along with other items they've been browsing.

Any product ribbon can be personalized using Miso's User to Products API, which fetches the products that are most likely to engage the user. Calling this API with the fq parameter lets you set any type of filter for the specific types of products that you would like to rerank using personalization. Learn more about filtering in our deep dive.

Before You Start

API Call / JSON Response

To fetch Personalized Product Rankings, POST to the User to Products API with the following minimum parameters:

• user_id or anonymous_id: The user or anonymous visitor to personalize the recommendations for
• fq: The query (in Solr syntax) specifying how to filter to the product recommendation results. For example, you can filter to a specific brand, collection, or criteria (like a promotion).

The API will return a list of products that are ordered by how likely they are to convert for the user (indicated by the personalization_score).

Example API Call

POST /v1/recommendation/user_to_products?api_key=<API_KEY> HTTP/1.1
{
    "user_id": "user-123",
    "fl": ["title"],
    "fq": "tags:\"ON SALE\""
    "rows": 5
}

Example JSON Response

{
    "message": "success",
    "data": {
        "took": 23,
        "miso_id": "517452b0-0ccf-11eb-948d-66352qf28022",
        "products": [
            {
                "product_id": "belkin-wireless-charger",
                "title": "Belkin Wireless Charger",
                "_personalization_score": 0.88
            },
            {
                "product_id": "jenga-hasbro",
                "title": "Hasbro - Jenga Game",
                "_personalization_score": 0.85
            },
            ...
        ]
    }
}

Before You Launch