Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Method description

Returns the top product attributes for a specific query. The product attribute weights are calculated based on user clicks, add-to-carts and purchases and the values are normalized using a linear function.

With segmentation can sent a user attributes list ("key":"value", ...) and number of tries in the request and the API try to return a segment data using this user attributes. If not have results for this user attributes in this number of tries it return the basic query context.

"topAttributes" objects don't have a fixed order and it may change in between requests. Although, values for each attribute are sorted by "weight" in descending order.

Remember that your EB Contextualize configuration could use different fields for the preference calculations, so the ones showing below ("brand" and "gender") are just examples.

HTTP method

GET

URL schema

No Format
/v2/querycontext/attributes/{client_id}?query={query}&lang={lang}&rows={rows}&userAttributes={userAttributes}&maxTries={maxTries}&events.min={eventsMin}

URL example

No Format
/v2/querycontext/attributes/ebdemo?query=dress&lang=en&rows=2&userAttributes=gender:male,size:M&maxTries=3&events.min=25

Path Parameters

Parameter nameRequiredDescription
client_id(tick)Client identifier on the system

...

Parameter nameRequiredDescriptionDefault
query(tick)Search term that user did
lang(tick)Language of the query
rows(error) Number of values of each field1
events.min(error) 

Minimum number of events required to return a field or product.

client configuration / 25
userAttributes    (error)User attributes to get segmentation data-
maxTries(error)Max tries to do segmentation intents3

...