Version 1 catalogs (deprecated)

Details recommendation models and requirements for version 1 catalogs.

AI models types

The training data requirements listed for each of the AI models is a guideline for the typical data needed before training can begin. These data requirements may very depending on the training objectives and quality of the data available.

Others You May Like (OYML)

The "Others you may like" recommendation predicts the next product that a user is most likely to engage or convert with. The prediction is based on the viewing history of the user and the candidate product's relevance to a current specified product.

Supported pages

Training data requirements

  • At least 10,000 Product Page View events in the last 90 days

  • AND one of the following:

    • At least 7 days of Product Page View events in the last 90 days AND at least 10 occurrences per catalog item on average (on 90 day window) of Product Page View events.

    • OR at least 60 days of Product Page View events in the last 90 days.

Frequently Bought Together (FBT)

The "Frequently bought together" recommendation predicts items frequently bought together for a specific product within the same shopping session. If a list of products is being viewed, then it predicts items frequently bought with that product list.

This recommendation is useful when the user has indicated an intent to purchase a particular product (or list of products) already, and you are looking to recommend complements (as opposed to substitutes). This recommendation is commonly displayed on the "add to cart" page, or on the "shopping cart" or "registry" pages (for shopping cart expansion).

Supported pages

Training data requirements

  • At least 1,000 Purchase events in the last 365 days.

  • AND one of the following:

    • At least 10 occurrences per catalog item on average (on 90 day window) of Purchase events.

    • OR at least 90 days of Purchase events in the last 365 days.

Recommended For You (RFY)

The "Recommended for you" recommendation predicts the next product that a user is most likely to engage with or purchase, based on the shopping or viewing history of that user. This recommendation is typically used on the home page.

Supported pages

Training data requirements

  • At least 10,000 Product Page View events in the last 90 days.

  • AND at least 10,000 Home Page View events in the last 90 days.

  • AND one of the following:

    • At least 7 days of Product Page View events in the last 90 days AND at least 10 occurrences per catalog item on average (on 90 day window) of Product Page View events.

    • OR at least 60 days of Product Page View events in last 90 days.

Recently Viewed (RV)

Returns up to 20 items recently viewed by the user, with most recently viewed items listed first.

The "Recently viewed" recommendation is not actually a recommendation. It provides a list of products the user has recently interacted with, with the most recent items first.

Supported pages

Training data requirements

  • At least one Product page view event must have been captured for the user.

AI model events

All AI models require specific user event details to provide context for queries to the prediction models. This section documents the different events supported by Fanplayr.

Home Page View

This event occurs when the user views the homepage.

Requirements

Product Page View

User views a product detail page.

Requirements

Category Page View

User views a page which contains multiple product listings such as a product category list or collection.

Requirements

Shopping Cart Page View

This event occurs when the user views the shopping cart.

Requirements

Search Page View

This event occurs when the user views a product search results page.

Requirements

  • At least one of the following must be met:

    • The page includes search query text via the searchQuery property.

Generic Page View

This event occurs when a user views a page not included in the other page view events.

Requirements

Add To Cart

This event occurs when Fanplayr can detect a new product being added to the cart or an increase in product quantity.

Requirements

  • User must have added a new product to their shopping cart or increased the quantity of a product.

Purchase Complete

This event occurs when the user completes the checkout process. This typically occurs on a store's order confirmation page.

Requirements

  • An order must be tracked via Fanplayr's order tracking snippet.

  • The tracked order details must include an order identifier, revenue details and at least one product.

  • The "Track page view after order" campaign option must be enabled to allow segmentation and widgets to re-evaluate after an order is placed.

Ranking models

The following models return a list of top ranked products by a particular metric based on up to the past 30 days of events.

There are four product ranking models to choose from:

Ranked by Views (RBV)

Returns the top ranked products by number of times viewed.

Ranked by Carts (RBC)

Returns the top ranked products by number of times added to cart.

Ranked by Purchases (RBP)

Returns the top ranked products by number of times purchased.

Ranked by Revenue (RBR)

Returns the top ranked products by total revenue.

Ranking model filters

The following optional filters can be applied to limit the products queried:

  • Number of days The number of days of history to use when querying for the top ranked products, starting from today. Valid values are between 1 and 30, where "1" will query up to the past 24 hours of data and "2" will query up to the past 48 hours of data etc.

  • Start price Limits the results to only products whose price is greater than or equal to the start price.

  • End price Limits the results to only products whose price is less than or equal to the end price.

  • Category Limits the results to only products of the specified category name. This can also be configured to use the current page category.

PreviousVersion 2 catalogs (latest)NextProduct Catalog

Last updated