Unbxd FAQ
Who’s using Unbxd?
If you have ever shopped on Express, Ashley, or WorldofBooks, you might have already used us. Anytime you reach out to eCommerce stores to buy your favorite dress or electronics, you go through an intricate search process running behind. The search process is designed well to let you hover the products in milliseconds. Unbxd is that backbone that runs behind the site to ensure relevant and quick display of products.
We have integrated our search functionalities for small-scale companies as well as the large ones.
Check out our customer stories to know more about us.
What can I do with Unbxd?You can integrate Unbxd Search with onto your eCommerce site for displaying better product results dynamically to your shoppers.
Does Unbxd comply with California Consumer Privacy Act (CCPA) guidelines?The CCPA guidelines applied to businesses that collect a consumer’s personal data. The CCPA policy doesn’t apply to our products as our products do not collect personal data (email ID, username, phone number etc.) of the consumers.
The CCPA will not apply if the all the following conditions are true:
– User credentials for your website are not available to Unbxd products
– Unbxd products have no way of obtaining any personal information (e.g. username, email, etc.) while the user is searching/browsing the customer websites
– Unbxd doesn’t have a way of correlating the cookie id or IP address with user personal information (e.g. username, email, etc.)
Does all the information transmitted between Unbxd and the user’s web browser use TLS Protocol?It uses 256-bit keys and the certificate supports TLS 1.3 which should be enforced by the customers.
Can we ingest price/availability based on zip codes?Unbxd products support omni-channel use cases where the price and availability of the product varies depending upon the location.
There are two approaches to handle price/availability information depending upon region :
- Option 1 : Suitable when the number of regions are less than 50 (cases where the price/availability varies by states or country)
- The price/availability information for each region can be passed as separate fields in the catalog
- At the time of query time, use the location of the user to filter the price/availability
- Option 2 : Suitable when the number of regions are more than 50 (cases where price varies with zip-codes)
- The recommended approach in these cases is to use Unbxd APIs to get the list of product IDs, then request price/availability of the products using another function while rendering the UI
Catalog
What are the file formats you can upload your catalog in?Unbxd supports catalog in CSV, JSON and XML formats.
The schema should be uploaded separately in JSON format prior to uploading the catalog in CSV or XML format. The uploads in CSV and XML via SFTP are converted to JSON format by Unbxd and then uploaded via the feed API.
A sample catalog in CSV/JSON/XML format is available here.
What is the maximum feed size supported by Unbxd?Unbxd systems are designed to handle extremely large catalog sizes. However, large catalogs require certain custom optimizations to offer the best results.
Unbxd feed system has supported feed files meeting following specifications in the past:
- File size : 50GB+
- Product SKUs : 150Mn+
- Fields per product : 25000+
- Variants per product : 5000+
What happens when a new schema file is sent with some new fields?Schema file uploads are handled on Unbxd end in the following manner :
- If the new schema file has fields that already existed in the schema but values corresponding to them are modified, then the schema is updated with the modified values of the field
- If the new schema file has new fields, then the new fields are added to the previously existing schema
Can we delete a deprecated field from the Schema file?No, currently there is no mechanism to delete a field from the schema. However, presence of deprecated fields in the schema doesn’t affect the search results anyway.
Deletion of a field from the schema can lead to corruption of the search & category index resulting in downtimes. Unbxd team can delete the deprecated fields from the schema from the backend if it’s extremely necessary. However, these requests can take some time.
What are the type of uploads?Unbxd supports three types of uploads:
- Full Feed Upload: When you upload your entire catalog
- Delta Upload: When you upload only a few modified fields of your catalog
- Single Feed Upload: When you upload only a single field of your catalog
Can we display products with different SKUs in different pages?This is a case of enforcing diversity in the result set based on product attributes which we don’t have as of now. But this can always be worked upon.
We accept JSON, XML, and CSV but is JSON the only format that can be uploaded by the customer through feed API?Yes. We only support JSON via feed API. Also, XML and CSV via SFTP won’t be self serve. Unbxd will anyway need to transform these files to JSON, and then call our feed API internally. Eventually, everything needs to pass via the feed API.
How do we do variants indexing?Our Browse API returns parent products with variants, and never just the variants. We also have a predefined attribute (relevantDoc) in our API response that informs the customer if the parent product should be displayed or variant – given we send both back in the response.
How to create a facet ‘Multi-valued’ facet i.e. a facet where shoppers can select more than one values? In order to support selection of more than one values in facets the following changes should be made :
- Filter parameter changes : The filter parameter in the search API supports more than one value separated by an OR operator. If the shopper selects more than one value in a facet then the payload for the filter parameter should be specified in the following manner : filter=:”” OR :”:”.
- Add Facet.multiselect parameter : Set facet.multiselect=true in the search request to ensure that the remaining values in the facet are retained along with the product count associated with them. By default, facet.multiselect is false, which leads to removal of remaining values from the facet once one value is selected.
The option to select multiple values in a facet is available only for ‘Range’ and ‘Text’ facets. Multi-level facets do not support selection of more than one value.
What should be the value of page_type?It depends on the categoryPage integration.
If the page is directly based on categoryPath or CategoryId, then the page_type should be CATEGORY_PATH; e.g.: “page”:”cat2430045″, “page_type”:”CATEGORY_PATH”. In this case – page_type is CATEGORY_PATH because the page is getting constructed using Category page API.
If the page is based on conditional filters, then the page_type should be “BOOLEAN”; e.g.: “page”:”categoryPathId:\”EC>EC0027>EC0031\””,”page_type”:”BOOLEAN”. In this case – page_type is BOOLEAN because the page is getting constructed using attribute pages API.
Do we support the creation of popular pages? How is it different than a landing page?Yes, we do. Popular searches page is a separate web page, where these terms will be added. Users are not searching when they are landing on a popular searches page, that’s why it is out of scope of our ajax implementation.
When someone clicks on a popular search term from the popular searches page, then it’s a plain search call only. It is just an UI intervention.
Do you show ‘Did You Mean’ even if the API response has >0 products?‘Did you mean’ gets fired when ‘Spellcheck’ is triggered.
For e.g. if the search query is ‘ret dress’ with this API call: http://search.unbxd.io/8c1bc6cc0fa47076d417690a1e5e1120/test-childrensplace-com702771523873394/search?q=ret%20dress
then the result set has 456 products. There is a ‘didyoumean’ suggestion ‘set dress’, as there was a spell-check triggered for token ‘ret’ based on the nearest match found from the catalog.
Process is to first check for exact match results (with all tokens, i.e. mm=100). In case no results are found, then spellcheck is triggered and ‘did you mean’ suggestion is given (if found, also note that ‘didyoumean’ suggestion is not automatically fired). Product results are for alternate.mm=0, in this case for dress. This happens mostly in case of multi token queries where one or more words may have been incorrectly spelt.
Do we support ‘Slots’ on global rules?No, we don’t support slotting on site rules. You have to specify slots for every query rule/page rule.
Can we do boosting on variants field?Yes, we can.
First is if a customer wants to boost products using the variant fields: As in, boost the products but the logic will be coming from a variant field. For e.g., if the price is a variant field, and the customer wants all products with price>$50 to be boosted. Then all products (which have any variant with price>$50) will be boosted.
Second is if a customer wants to boost variants within a product, and the image of the variant becomes the face of the product: In this case, for e.g., if a customer applies a boost on color field = red then, all products in the result set which have a red color variant – that image will become the face for them.
Can we use a relative path to define the redirect URL or should we always use an absolute path?The redirect feature in Unbxd search API supports both the relative and absolute paths. However, if a relative URL is specified in a redirect rule then the customers must take care of adding the prefix for the URL before requesting the page pointed by the URL.
Customers can also create some redirect rules with relative URLs and some redirect rules with absolute path, as long as they have logic in place to handle the response of both types.
If it’s Ajax implementation by Unbxd, then we handle the redirects in our JS code after verifying the logic with the customer.
- Did this answer your question?
Who’s using Unbxd?If you have ever shopped on Express, Ashley, or WorldofBooks, you might have already used us. Anytime you reach out to eCommerce stores to buy your favorite dress or electronics, you go through an intricate search process running behind. The search process is designed well to let you hover the products in milliseconds. Unbxd is that backbone that runs behind the site to ensure relevant and quick display of products.
We have integrated our search functionalities for small-scale companies as well as the large ones.
Check out our customer stories to know more about us.
What can I do with Unbxd?You can integrate Unbxd Search with onto your eCommerce site for displaying better product results dynamically to your shoppers.
Does Unbxd comply with California Consumer Privacy Act (CCPA) guidelines?The CCPA guidelines applied to businesses that collect a consumer’s personal data. The CCPA policy doesn’t apply to our products as our products do not collect personal data (email ID, username, phone number etc.) of the consumers.
The CCPA will not apply if the all the following conditions are true:
– User credentials for your website are not available to Unbxd products
– Unbxd products have no way of obtaining any personal information (e.g. username, email, etc.) while the user is searching/browsing the customer websites
– Unbxd doesn’t have a way of correlating the cookie id or IP address with user personal information (e.g. username, email, etc.)
Does all the information transmitted between Unbxd and the user’s web browser use TLS Protocol?It uses 256-bit keys and the certificate supports TLS 1.3 which should be enforced by the customers.
Can we ingest price/availability based on zip codes?Unbxd products support omni-channel use cases where the price and availability of the product varies depending upon the location.
There are two approaches to handle price/availability information depending upon region :
- Option 1 : Suitable when the number of regions are less than 50 (cases where the price/availability varies by states or country)
- The price/availability information for each region can be passed as separate fields in the catalog
- At the time of query time, use the location of the user to filter the price/availability
- Option 2 : Suitable when the number of regions are more than 50 (cases where price varies with zip-codes)
- The recommended approach in these cases is to use Unbxd APIs to get the list of product IDs, then request price/availability of the products using another function while rendering the UI
Who’s using Unbxd?If you have ever shopped on Express, Ashley, or WorldofBooks, you might have already used us. Anytime you reach out to eCommerce stores to buy your favorite dress or electronics, you go through an intricate search process running behind. The search process is designed well to let you hover the products in milliseconds. Unbxd is that backbone that runs behind the site to ensure relevant and quick display of products.
We have integrated our search functionalities for small-scale companies as well as the large ones.
Check out our customer stories to know more about us.
What can I do with Unbxd?You can integrate Unbxd Search with onto your eCommerce site for displaying better product results dynamically to your shoppers.
Does Unbxd comply with California Consumer Privacy Act (CCPA) guidelines?The CCPA guidelines applied to businesses that collect a consumer’s personal data. The CCPA policy doesn’t apply to our products as our products do not collect personal data (email ID, username, phone number etc.) of the consumers.
The CCPA will not apply if the all the following conditions are true:
– User credentials for your website are not available to Unbxd products
– Unbxd products have no way of obtaining any personal information (e.g. username, email, etc.) while the user is searching/browsing the customer websites
– Unbxd doesn’t have a way of correlating the cookie id or IP address with user personal information (e.g. username, email, etc.)
Does all the information transmitted between Unbxd and the user’s web browser use TLS Protocol?It uses 256-bit keys and the certificate supports TLS 1.3 which should be enforced by the customers.
Can we ingest price/availability based on zip codes?Unbxd products support omni-channel use cases where the price and availability of the product varies depending upon the location.
There are two approaches to handle price/availability information depending upon region :
- Option 1 : Suitable when the number of regions are less than 50 (cases where the price/availability varies by states or country)
- The price/availability information for each region can be passed as separate fields in the catalog
- At the time of query time, use the location of the user to filter the price/availability
- Option 2 : Suitable when the number of regions are more than 50 (cases where price varies with zip-codes)
- The recommended approach in these cases is to use Unbxd APIs to get the list of product IDs, then request price/availability of the products using another function while rendering the UI
Who’s using Unbxd?If you have ever shopped on Express, Ashley, or WorldofBooks, you might have already used us. Anytime you reach out to eCommerce stores to buy your favorite dress or electronics, you go through an intricate search process running behind. The search process is designed well to let you hover the products in milliseconds. Unbxd is that backbone that runs behind the site to ensure relevant and quick display of products.
We have integrated our search functionalities for small-scale companies as well as the large ones.
Check out our customer stories to know more about us.
What can I do with Unbxd?You can integrate Unbxd Search with onto your eCommerce site for displaying better product results dynamically to your shoppers.
Does Unbxd comply with California Consumer Privacy Act (CCPA) guidelines?The CCPA guidelines applied to businesses that collect a consumer’s personal data. The CCPA policy doesn’t apply to our products as our products do not collect personal data (email ID, username, phone number etc.) of the consumers.
The CCPA will not apply if the all the following conditions are true:
– User credentials for your website are not available to Unbxd products
– Unbxd products have no way of obtaining any personal information (e.g. username, email, etc.) while the user is searching/browsing the customer websites
– Unbxd doesn’t have a way of correlating the cookie id or IP address with user personal information (e.g. username, email, etc.)
Does all the information transmitted between Unbxd and the user’s web browser use TLS Protocol?It uses 256-bit keys and the certificate supports TLS 1.3 which should be enforced by the customers.
Can we ingest price/availability based on zip codes?Unbxd products support omni-channel use cases where the price and availability of the product varies depending upon the location.
There are two approaches to handle price/availability information depending upon region :
- Option 1 : Suitable when the number of regions are less than 50 (cases where the price/availability varies by states or country)
- The price/availability information for each region can be passed as separate fields in the catalog
- At the time of query time, use the location of the user to filter the price/availability
- Option 2 : Suitable when the number of regions are more than 50 (cases where price varies with zip-codes)
- The recommended approach in these cases is to use Unbxd APIs to get the list of product IDs, then request price/availability of the products using another function while rendering the UI