Product Catalogue Rank

Introduction

Product Catalogue Rank is a tool that helps you decide which products should appear first on your website’s category pages. It looks at how popular each product is, based on events from the users. For example, how often the users interact with the products: clicks, views, buy or whether it’s trending. These events are then combined into a score in the rank that tells you which products are most likely to catch attention or drive sales. 

You can adjust how much each event matters. For example, if you want to focus on products that sell well over time, you can give more weight to buy-data. If you want to highlight products that people are exploring or discovering, you can focus more on item-click data. You can also choose whether the tool should look at recent activity (like the past week) or longer-term patterns. 

The rest of this document explains how to set up and use the Product Catalogue Rank in more detail through the modules that use this algorithm. 

Modulename: GetProductCatalogueRank 

Purpose:  This module is designed to help you sort and optimize category pages on your website. The Product Catalogue Rank represents a combined popularity score, calculated from visits, sales, and trend signals. It is not a single metric such as “bestsellers” or “most viewed”, but a blended score based on configurable weighting. These ranking signals can be weighted and adjusted dynamically to reflect your current business goals. 

This module provides a sorted list of all products in your inventory. The rank is based on the weight trends, sales and click popularity, which are configurable and can be adjusted dynamically. 

How It Works 

The module calculates a score for each product in your catalogue, allowing you to display products in the order most likely to drive engagement and sales. You can also boost specific product types—such as new arrivals—if this information is available in your product catalog ( e.g. through tags). 

Scoring is based on recent performance, using data from the past 7, 30, or 360 days.  
You can fine-tune how much weight to assign to different types of engagement. Short time periods (such as 7 days) make the ranking more dynamic and trend-driven, while longer periods (such as 360 days) create a more stable and evergreen ranking. The chosen time span affects how quickly the ranking reacts to changes in user behavior.

Setup Guide

1. Prepare your SFTP server: Before activating the module, make sure you have an SFTP server available to receive the ranked product list.
2. Activate the module: In the Control Panel, activate the GetProductCatalogueRank module. 
3. Configure connection details 
4. sftpUrl: Enter the server IP or domain (e.g. 123.123.123.123 or sftp.raptorsmartadvisor.com) – no prefix required. 
5. Username and Password: Enter your SFTP login credentials. 
6. Folder name: Specify the folder where the file should be placed  
7. (Optional) Select sister accounts if the ranking should apply across multiple accounts. 
8. Test the output: Go to the module and click “Test” to generate a file with scores for all products. This file will be sent to the SFTP server from where you ingest the file into your CSM system. Review the output to ensure the ranking aligns with your expectations. If you want to make any changes, go to the module again and adjust the weights until you are satisfied.