Browse

Log a browse event

To capture the diversity of use cases our customer base, we allow several different types of browse events to be communicated.

Event	Meaning
browse_result_load	browse result page was loaded
browse_result_click	user clicked a product on browse results page

To log an event make a POST request to:

POST https://ac.cnstrc.com/v2/behavioral_action/<event_type>

where event_type is one of browse_result_load, browse_result_click. Requests have to also include query string parameters and body of the request has to have JSON object with the necessary fields, depending on event type (documented below).

Example

Shell

Log an event

curl -X POST -H 'Content-Type: application/json' \
  -u '[your token]:' \
  "https://ac.cnstrc.com/v2/behavioral_action/browse_result_load? \
    section=<section used> \
    &key=<your API key> \
    &c=<client id> \
    &i=<user id> \
    &s=<session number>" \
  -d '{
      "url": "https://example.com/browse",
      "filter_name": "brand",
      "filter_value": "the-brand"
  }'

JavaScript

// This method is not currently supported.

Python

# This method is not currently supported.

Java

// This method is not currently supported.

iOS

// This method is not currently supported.

Android

// This method is not currently supported.

C#

// This method is not currently supported.

info

The above command returns a 204 Success response on success.

Query String Parameters

Parameter	Type	Required?	Description
key	string	Yes	The key of the index you'd like to log events for.
c	string	Yes	Client id. The library responsible for making the request
i	string	Yes	User's device id. An anonymized user identification hash.
s	integer	Yes	Session number. The counter for the session in which the behavior event occurred. We recommend to increment the session number every 30 minutes
ui	string	No	Your internal ID for a user (if available)
_dt	integer	No	Unix timestamp in seconds of when the event happened
us	array of strings	No	User segment
section	string	No	Your autosuggest and search results can have multiple sections like "Products" and "Search Suggestions". This indicates which section was searched. See your dashboard for the section names to use.
origin_referrer	string	No	The url where the event originated.

JSON Parameters

Browse result load

Parameter	Type	Required?	Description
url	string	Yes	URL of the browse results page
result_count	integer	No	Total number of results
result_page	integer	No	Current page of results
result_id	string	No	result_id returned by Krestor browse response
items	array of objects	No	Items that were loaded. Up to 100 items, each object has to include either item_id or item_name keys, and optionally can include variation_id. All values are strings.
selected_filters	object	No	Filters that the user had selected on the browse results page. Object with string keys and values
sort_by	string	No	The field that the user had sorted by
sort_order	string	No	The order of sorting. One of descending or ascending
filter_name	string	Yes	The name of the browse filter
filter_value	string	Yes	The value of the browse filter

Browse result click

Parameter	Type	Required?	Description
item_id	string	No	ID of the item that was clicked (either it or item_name is required)
item_name	string	No	Name of the item that was clicked (either it or item_id is required)
variation_id	string	No	ID of the variation that was shown to the user when the result was clicked
result_count	integer	No	Total number of results
result_page	integer	No	Current page of results
result_id	string	No	result_id returned by Krestor browse response
items	array of objects	No	Items that were loaded. Up to 100 items, each object has to include either item_id or item_name keys, and optionally can include variation_id. All values are strings.
selected_filters	object	No	Filters that the user had selected on the results page. Object with string keys and values
sort_by	string	No	The field that the user had sorted by
sort_order	string	No	The order of sorting. One of descending or ascending
filter_name	string	Yes	The name of the browse filter
filter_value	string	Yes	The value of the browse filter
result_id	string	No	result_id returned by Krestor browse response
result_position_on_page	integer	No	Position of the result that was clicked relative to the current page
num_results_per_page	integer	No	Number of results on the current page
selected_filters	object	No	Filters that the user had selected on the browse results page. Object with string keys and values