Input Parameters Glossary

Created by Lara Menéndez · last update June 13, 2019

Main Parameters

PARAMETER DESCRIPTION TYPE REQUIRED TAGGING
q/terms Search term of the query (i.e jeans, red lipstick, wood table …) String YES Search
totalHits/results Number of the results for the search term or the number of products in a category Integer YES Search and Browse
page Number of the page visualised by the user Integer YES Search
categoryId Category ID to track (i.e JQW_458h, cat_name, catName1 …) String NO Browse
productId Id of the product of the interaction (i.e PR_1111, 014-025-2 …) String NO Search and Browse
position Position of the product selected Integer NO Search and Browse

Filters

PARAMETER DESCRIPTION TYPE REQUIRED TAGGING
scope Scope of the query (i.e device type) String NO Search and Browse
lang Language of the query (i.e es,it,fr…) String YES Search and Browse
store Store id assigned to the query performed String NO Search and Browse
catalog Catalog value assigned to the query performed String NO Search and Browse
section Section value assigned to the query performed String NO Search and Browse

User Parameters

PARAMETER DESCRIPTION TYPE REQUIRED TAGGING
session Session id who launched the search. Short term id. Recommended expiration about 30’ UUID Required for analytics and next queries service Search and Browse
user User id who launched the search UUID Required for analytics and next queries service Search and Browse
user_type Collects if user is new, recurrent or ignored String No Search and Browse

IMPORTANT: Both ids must be added for next queries to work. If one of them is not available, session and user parameters could be the same UUID.

Additional Query Parameters

PARAMETER DESCRIPTION TYPE REQUIRED TAGGING
origin Type of the query performed by the user (default, empathize, linked, next query …) String NO Search
referrer Referral url String No Search
boosted Boost descriptor (use “default” for manual boosts).If boosted value is “default” a boostId is required String NO Search
boostedId Manual boost Id, required for default boosts. String NO Search
jsonCallback Name of the callback that will be executed after the request. Short NO Search
front Front end identifier String NO Search and Browse

Additional Interactions Parameters

PARAMETER DESCRIPTION TYPE REQUIRED TAGGING
origin Type of the query performed by the user (default, empathize, linked, next query …) String NO Search
boosted Boost descriptor (use “default” for manual boosts).If boosted value is “default” a boostId is required String NO Search
boostedId Manual boost Id, required for default boosts. String NO Search
jsonCallback Name of the callback that will be executed after the request. Short NO Search
type Clicked result’s type String NO Search
spellcheck Checks whether the query has come via spellcheck or not String NO Search
filtered Checks whether the query/view has been filtered or not String NO Search
front Front end identifier String NO Search and Browse