> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Machine Learning Models and Training

Each combination of recommendation model type and objective has unique user event and data requirements.
The table below shows which recommendation model types and objectives we support based on the user events that are currently a part of the BigCommerce integration.

In the future, we'll be enhancing this integration to include full support for all user events, which in turn unlocks all of the different model types and objectives.

✔ indicates that a feature is supported with the current integration.\

`*`  indicates that a feature is not yet supported, but will be in the future.

| Recommendation model type                                            | Objectives                                                       | User Events                                                                                                                                                                                           |
| :------------------------------------------------------------------- | :--------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Others You May Like ✔                                                | click-through-rate ✔  conversion-rate\*  revenue-per-session\*   | detail-page-view ✔  add-to-cart\*                                                                                                                                                                     |
| Frequently Bought Together ✔                                         | any ✔                                                            | detail-page-view ✔  purchase-complete ✔                                                                                                                                                               |
| Recommended for You ✔                                                | click-through-rate ✔  conversion-rate\*  revenue-per-session\*   | detail-page-view ✔  purchase-complete ✔  home-page-view\*                                                                                                                                             |
| Recently Viewed ✔                                                    | N / A                                                            | detail-page-view ✔                                                                                                                                                                                    |
| Similar Items ✔                                                      | click-through-rate ✔                                             | N / A                                                                                                                                                                                                 |
| Buy it Again ✔                                                       | N / A                                                            | purchase-complete ✔                                                                                                                                                                                   |
| On-sale\*  Also requires priceInfo.price ✔ priceInfo.originalPrice\* | click-through-rate ✔  conversion-rate                            | detail-page-view ✔  add-to-cart\*  purchase-complete ✔  home-page-view\*  shopping-cart-page-view\*  category-page-view\*                                                                             |
| Page-Level Optimization                                              | detail-page-view  add-to-cart  purchase-complete  home-page-view | Page-Level Optimization optimizes recommendation panels by choosing between several possible models. Refer to the data requirements for the models you select as options for Page-Level Optimization. |

DISCLAIMER: Model types and placements (the page where you place the recommendation) have not all been tested. We recommend testing them before you deploy them on your live website.

Learn more about the [data requirements for various models and objectives](https://cloud.google.com/retail/docs/create-models#new-model) in Google's documentation.

## Model training

The following sections describe how BigCommerce loads data to your GCP account and the data used to train models for prediction requests.

### Initial data load

BigCommerce sends [catalog](/developer/docs/beta/product-recommendations/catalog-data#catalog) and [shopper event data](/developer/docs/beta/product-recommendations/shopper-events#shopper-event-schema) to your GCP account so that you can create machine learning models and serving configurations in your GCP project.\
An initial load occurs once, which includes the most up-to-date catalog data, Product Detail Page View events from the past 90 days, and Purchase Complete events from the past 180 days.

After BigCommerce sends the data, you can [configure the machine learning model](https://cloud.google.com/retail/docs/create-models) you want to use in the Google Cloud console.
You can manage models, including their serving configurations and model placements in your GCP account.

### Continuous data updates

The following pages describe how BigCommerce keeps the models up to date:

* [Catalog data](/developer/docs/beta/product-recommendations/catalog-data)
* [Shopper events](/developer/docs/beta/product-recommendations/shopper-events)

## Creating a ML model

To create your first ML model in GCP, navigate to the **Models** section and click **Create model**. You can name your model and select the model type and objective. The UI will show if you have sufficient data for various model types and objectives.

### Tuning preference frequency

We recommend using the default setting of “every three months”. This will ensure the efficacy of the model stays high, which means you don’t have to remember to manually retune the model in the future.

### Filtering by attribute values

We recommend using the default value of “Auto generate tags”. This is useful for two scenarios:

* When products in your BigCommerce catalog are marked as “not visible” for the storefront, they do not appear in recommendation requests.
* When applying a filter when making product recommendation requests. For more on this topic, see the section on [filtering](/developer/docs/beta/product-recommendations/request-recommendations#filtering-products).

You can set this to "Do not generate tags" if you don't need either of these capabilities. You can change this later by editing your model and changing the "Filter settings" option.