Personalized Category Page Queries
A Personalized Category Page request to the Pesonalized Search API can occur after a customer arrives on a product category page. This request is similar to a Personalized Site Search request, but instead of searching for products based on a search term, a Personalized Category Page request searches for products based on products' category path(s).
Refer to Returning Content Page Records in Personalized Site Search Queries for information about including category page records in response to a customer's site search query.
To send this type of request, change the value of the typeOfRequest key to "CATNAV", and then add the categoryPath key to the query object. The value of categoryPath is the search criterion the returned products must meet.
The response is also similar to a Personalized Site Search response, but it also includes the monetate_category key that indicates each record's product category.
All functions available in Personalized Site Search queries—such as pagination and facets —are available to use in Personalized Category Page queries.
Refer to Omnichannel Personalized Search Action Request for the information you must provide in an Engine API request for a Personalized Category Pages experience configured with an Omnichannel Personalized Search action.
{
"searchToken": "Monetate-67899982122813608004"
"recordQueries": [
{
"id": "categoryProducts",
"typeOfRequest": "CATNAV",
"settings": {
"query": {
"categoryPath": "Sporting Goods;Outdoor Recreation;Camping & Hiking"
},
"searchPrefs": [
"enableScores"
],
"limit": 5
"typeOfRecords": [
"MONETATE_PRODUCT"
]
}
}
]
}Using the fields Array
By default, records returned in the response include values for all attributes in the mapped product catalog, including custom attributes. Use the fields array to limit the response to the specific attribute values you want returned. Doing so improves response time and decreases response size. As such, you should limit returned attribute values to only those you intend to render.
Before you can include one or more custom attributes in the fields array of a request, you must first contact your dedicated CSM so that Monetate can enable this option.