Overview
Fetch production recommendations for a single customer (personal), based on a group of products (contextual), or overall best sellers.
- For product recommendations based on a customer, the customer can be identified using one of
vuid
,email
,zaius_alias_*
, orcustomer_id
. - For recommendations based on a group of products, the products can be identified by their respective product ids. Including a customer identifier on this type of request will exclude products purchased in the last 180 days from being returned.
If no customer identifier or product ids are provided (or if no associated recommendations are available), then 7-day best-sellers are returned as fallbacks.
Product records that are returned will include all the base Optimizely Data Platform (ODP) product fields in addition to any custom fields defined in your product schema.
There will be an extra field, recommendation_type, in the returned results. This field shows which types of recommendations are being returned (personal
, contextual
or best_sellers
).
personal
recommendations refer to products recommended to the specific customercontextual
recommendations refer to recommended products related to input productsbest_sellers
are calculated based on the past seven days of orders (by units)
Note
Product recommendation results will automatically be filtered using the Content Shield Filter set up for the account. Query-specific filters (criteria) can be added per the query parameters below.